Gemini 3.1 Pro

Usa gemini-3.1-pro-preview con el formato nativo de Gemini. La página del modelo incluye el Playground y los precios actuales; la guía de variantes del modelo explica los dos ID oficiales.

ID del modelo

Ejemplo rápido

curl https://api.seedrouter.ai/v1beta/models/gemini-3.1-pro-preview:generateContent \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"role":"user","parts":[{"text":"Explain a mutex in one sentence."}]}],"generationConfig":{"thinkingConfig":{"thinkingLevel":"low"},"maxOutputTokens":1024}}'

El modelo se indica en la URL. contents es obligatorio. La respuesta incluye los campos nativos candidates, finishReason y usageMetadata; conserva las partes completas del contenido, incluido thoughtSignature, en el historial de conversación.

Endpoints

La especificación OpenAPI incluye todos los esquemas anidados de solicitud y respuesta. Los campos opcionales usan los valores predeterminados de la API cuando se omiten. SeedRouter reenvía el cuerpo enviado sin filtrar campos desconocidos, eliminar campos no compatibles ni validar los valores de los parámetros del modelo. La API de Gemini decide si acepta la solicitud.

Parámetros de solicitud

La URL fija el modelo en gemini-3.1-pro-preview. El contrato de solicitud contiene 12 campos de nivel superior. Los campos son opcionales salvo que se indiquen como obligatorios; omitirlos no equivale a JSON null. Se conserva el JSON arbitrario que admite null cuando lo permite el esquema oficial.

Parámetros de generación

El documento OpenAPI enumera los tipos anidados, las enumeraciones, las propiedades obligatorias y los límites documentados de cada mensaje. Los esquemas describen parámetros oficiales; no son una lista de campos permitidos por SeedRouter. Se conservan los campos y valores aportados por quien llama a la API. Que el esquema acepte un campo no demuestra que sea compatible con todos los modelos o cuentas. Este modelo no admite el razonamiento minimal ni el procesamiento Agentic Video.

Salida estructurada

{
  "contents": [{"parts": [{"text": "Return a JSON object with ok set to true."}]}],
  "generationConfig": {
    "thinkingConfig": {"thinkingLevel": "low"},
    "maxOutputTokens": 1024,
    "responseMimeType": "application/json",
    "responseJsonSchema": {
      "type": "object",
      "properties": {"ok": {"type": "boolean"}},
      "required": ["ok"]
    }
  }
}

Los campos heredados responseSchema y responseJsonSchema no se pueden usar juntos. Ambos requieren responseMimeType: "application/json". El esquema más reciente responseFormat.text también debe especificar JSON. Usa las formas de las enumeraciones REST (APPLICATION_JSON y TEXT_PLAIN) en ese mensaje. Las solicitudes pasan sin cambios; no se reescriben los tipos MIME multimedia ni el JSON arbitrario de funciones.

Funciones y herramientas integradas

Usa tools[].functionDeclarations con un nombre y con parameters o parametersJsonSchema, pero no ambos. Los esquemas de respuesta siguen la misma regla de exclusión mutua. La selección de funciones se configura en toolConfig.functionCallingConfig; allowedFunctionNames requiere ANY o VALIDATED y nombres declarados.

El modelo normal admite llamadas a funciones; no se necesita la variante customtools. Tu aplicación ejecuta las funciones devueltas y proporciona sus resultados en el siguiente turno de la conversación. Conserva cada thoughtSignature original, llamada a función y respuesta de función. No redondees los identificadores numéricos al serializar argumentos opacos de funciones.

Google enumera Search, Maps, ejecución de código y contexto de URL entre las capacidades del modelo. File Search solo figura para AI Studio. Los recursos existentes de caché y búsqueda de archivos requieren acceso con las credenciales que atienden la solicitud. Computer Use y la configuración MCP nativa aparecen en el esquema genérico, pero no se ha confirmado su disponibilidad para este modelo. El Playground no ejecuta tus funciones personalizadas.

Entrada multimodal y seguridad

Un elemento contents[].parts[] contiene exactamente una carga: texto, contenido multimedia en línea, una referencia de archivo, una llamada o respuesta de función, o una parte de ejecución. También puede incluir una firma o metadatos multimedia. La entrada admite texto, imágenes, audio, vídeo y PDF; la salida es solo texto.

Para bytes en línea, usa inlineData.mimeType y data en base64. Para referencias de archivos, usa fileData.mimeType y fileUri. Una URL sintácticamente válida no demuestra que el modelo pueda recuperar su contenido. Los metadatos de vídeo pueden especificar desplazamientos de inicio y fin y un valor positivo de fps no superior a 24. La resolución multimedia global y la de cada parte son ajustes distintos. Agentic Video no es compatible.

Usa JSON nativo para contenido multimedia en línea o una referencia de archivo accesible para contenido más grande. Los límites exactos de formato, duración y contenido multimedia por solicitud siguen sujetos a la documentación multimedia oficial y a la verificación en vivo.

Los ajustes de seguridad usan el formato nativo oficial. Omitirlos mantiene los valores predeterminados de la API de Gemini; los ajustes proporcionados explícitamente pasan sin cambios.

Respuestas JSON y streaming

generateContent devuelve JSON nativo. streamGenerateContent?alt=sse emite JSON nativo en eventos SSE data:. Entre los campos importantes están candidates[].content.parts, finishReason, safetyRatings, groundingMetadata, promptFeedback, modelVersion, responseId y usageMetadata.

Conserva el contenido nativo completo en el historial de conversación. Los resúmenes de razonamiento no son lo mismo que las firmas de razonamiento. Una desconexión no demuestra que la generación haya fallado ni terminado; inspecciona el resultado parcial y el registro de la cuenta antes de enviar otra solicitud. El consumo del flujo es acumulativo, así que usa los últimos contadores en lugar de sumar todos los fragmentos.

A diferencia de Argon, no se ha confirmado la continuación de salidas más largas para 3.1 Pro. No construyas un bucle de continuación solo porque el esquema genérico de respuesta incluya un campo de token.

Consumo y precios

promptTokenCount incluye la entrada en caché. cachedContentTokenCount se cobra a la tarifa de entrada en caché, en lugar de cobrarse otra vez como entrada sin caché. La salida facturable incluye candidatesTokenCount más thoughtsTokenCount. Los tokens de prompt comunicados por el uso de herramientas también contribuyen a la entrada.

El umbral de contexto es de 200.000 tokens de entrada, incluida la entrada en caché; las entradas mayores usan las tarifas de contexto largo. Los grupos de cuenta disponibles usan la misma expresión de precio del modelo y su propio multiplicador actual. Consulta la tabla de precios en vivo.

Flex y Priority son niveles de procesamiento distintos. Flex no reduce a la mitad las tarifas de entrada en caché. Un resultado comunicado como Standard no debe llevar un recargo Priority. Si una respuesta solicitada como Priority no confirma su nivel real, esta integración usa las tarifas por token Standard. Los cargos por herramientas y el almacenamiento explícito de caché son independientes de los precios de tokens de generación; no se promete una cuota gratuita compartida de herramientas. Las solicitudes fallidas no se cobran.

Varios grupos de cuenta

El modelo usa googlellm y googlellm-vertext, y conserva sus permisos de cuenta y precios existentes. La escritura de cada nombre de grupo es exacta. Selecciona un grupo disponible en el Playground o usa la cabecera API opcional:

X-SeedRouter-Group: googlellm

Usa googlellm-vertext para seleccionar el segundo grupo. El grupo elegido determina el precio y la capacidad disponible; una selección explícita no cambia silenciosamente a otro grupo. Omite la cabecera o usa auto para mantener el comportamiento predeterminado de la clave API.

Comprueba los grupos disponibles para tu clave API sin generar una respuesta:

curl "https://api.seedrouter.ai/api/seedrouter/llm/groups?model=gemini-3.1-pro-preview"   -H "Authorization: Bearer YOUR_SEEDROUTER_KEY"

Estado de verificación

Los controles y la documentación siguen el formato nativo oficial. La validación de parámetros corresponde a la API de Gemini. Las comprobaciones sin conexión del transporte y la facturación no demuestran la disponibilidad en producción. La generación en vivo, los dos grupos de cuenta, la comprensión multimedia, los recursos en caché, las herramientas integradas y los niveles de procesamiento aún requieren verificación de extremo a extremo de pago. No se afirma ningún resultado comparativo de calidad de la variante Customtools.

Referencias

• Especificación del modelo de Google
• Guía nativa de Gemini 3
• Referencia REST de GenerateContent
• Salida estructurada
• Razonamiento
• Precios