Text
Gemini 4 Argon
Solicitudes nativas de Gemini, entradas multimodales, razonamiento, herramientas, streaming y continuación. Incluye los límites actuales de la verificación.
Usa gemini-4-argon con el formato nativo de Gemini. La página del modelo incluye el Playground y los precios actuales; la guía de lanzamiento explica la disponibilidad.
ID de modelo
| ID de modelo | Ventana de contexto | Nivel de esfuerzo predeterminado |
|---|---|---|
gemini-4-argon | 1.048.576 tokens | medium |
Ejemplo rápido
curl https://api.seedrouter.ai/v1beta/models/gemini-4-argon: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":256}}'El modelo se indica en la URL. contents es obligatorio. Una respuesta incluye los campos nativos candidates, finishReason y usageMetadata; conserva las partes de contenido completas, incluido thoughtSignature, para el historial de la conversación.
Endpoints
| Operación | Endpoint |
|---|---|
| Respuesta JSON | POST /v1beta/models/gemini-4-argon:generateContent |
| Eventos enviados por el servidor | POST /v1beta/models/gemini-4-argon:streamGenerateContent?alt=sse |
La especificación OpenAPI incluye todos los esquemas anidados de solicitud y respuesta. Los campos opcionales omitidos usan los valores predeterminados de la API. Los campos desconocidos y los que oficialmente no se admiten se descartan; los valores no válidos de campos admitidos siguen siendo errores.
Parámetros
| Nombre | Tipo | Obligatorio | Predeterminado | Notas |
|---|---|---|---|---|
contents | object[] | Sí | — | Array de conversación obligatorio; parts contiene texto, medios y resultados de herramientas |
systemInstruction | object | No | — | Instrucción del sistema solo de texto |
generationConfig | object | No | — | Presupuesto de salida, razonamiento, salida estructurada, ajustes de parada y medios |
tools | object[] | No | — | Definiciones de funciones y herramientas integradas |
toolConfig | object | No | — | Selección de funciones, ajustes de recuperación y partes de herramientas del servidor |
safetySettings | object[] | No | — | Pares únicos de categoría y umbral |
continuationToken | string | No | — | Token de continuación opaco del candidato más reciente |
serviceTier | enum | No | standard | unspecified, standard, flex, priority; standard por defecto |
labels | object | No | — | Claves y valores de etiquetas en minúsculas, de hasta 63 caracteres Unicode cada uno |
store | boolean | No | — | Preferencia de registro de solicitudes; no permite recuperar conversaciones guardadas |
model | string | No | — | Nombre de recurso opcional en el cuerpo; la URL fija el modelo |
generationConfig incluye maxOutputTokens, thinkingConfig, stopSequences, responseFormat, los campos anteriores responseMimeType/responseSchema/responseJsonSchema, responseModalities, mediaResolution, seed, presencePenalty, frequencyPenalty, responseLogprobs, logprobs, enableEnhancedCivicAnswers, enableAffectiveDialog, translationConfig y audioTranscriptionConfig. Los campos genéricos cuyo comportamiento específico en este modelo no está confirmado siguen sujetos a la verificación de capacidades.
- Niveles de razonamiento:
low,medium,high;mediumpor defecto. El razonamiento no se puede desactivar.includeThoughtssolicita resúmenes. El campo obsoletothinkingBudgetse acepta por sí solo, pero no puede combinarse conthinkingLevel. - La entrada, el razonamiento y la salida comparten 1.048.576 tokens.
maxOutputTokensincluye el razonamiento; el contexto restante puede reducir el presupuesto efectivo. - REST nativo utiliza un límite y un valor predeterminado de salida de 32.768 tokens por solicitud, o de 65.536 en streaming. Las salidas más largas usan continuación. La documentación oficial es contradictoria sobre las primeras solicitudes sin streaming que superan los 32.768 tokens; esta integración no impone ese valor como límite de la generación total.
- Como máximo cinco
stopSequences.logprobsva de 0 a 20 y requiereresponseLogprobs: true. responseSchemayresponseJsonSchemason mutuamente excluyentes y requierenresponseMimeType: "application/json". Las nuevas solicitudes pueden usarresponseFormat.text, como se muestra a continuación.responseModalitiessolo puede contenerTEXT. La temperatura, top-p, top-k y el número de candidatos no son controles activos de Argon. No se admitencachedContentexplícito, la generación de imágenes ni la generación de voz.
Salida estructurada y herramientas
{
"contents": [{"parts": [{"text": "Return a JSON object with ok set to true."}]}],
"generationConfig": {
"thinkingConfig": {"thinkingLevel": "low"},
"maxOutputTokens": 256,
"responseFormat": {
"text": {
"mimeType": "APPLICATION_JSON",
"schema": {"type": "object", "properties": {"ok": {"type": "boolean"}}, "required": ["ok"]}
}
}
}
}Las funciones usan tools[].functionDeclarations. allowedFunctionNames requiere el modo ANY o VALIDATED y nombres declarados. Conserva las llamadas a funciones, las respuestas y las firmas en su orden original. Google Search, Maps, la ejecución de código, el contexto de URL, File Search y Computer Use son capacidades oficiales; el acceso a recursos, los cargos y el comportamiento deben verificarse para la operación prevista. El Playground no ejecuta herramientas localmente.
Medios y seguridad
El campo nativo parts acepta entradas de texto, imagen, audio, vídeo y PDF mediante inlineData o fileData. Cada parte contiene una variante de contenido, opcionalmente acompañada de firmas de razonamiento y metadatos de medios. El mediaResolution global y la resolución por parte son distintos. El vídeo admite procesamiento STATIC y AGENTIC; videoMetadata.fps debe ser mayor que cero y como máximo 24.
El Playground acepta solicitudes JSON de hasta 12 MiB. Este es un límite de transporte de la aplicación, no el límite de medios del modelo. Para medios de gran tamaño, usa referencias de archivos admitidas por tu cuenta. Los recursos de archivos y los medios obtenidos externamente tienen límites oficiales distintos; su disponibilidad aquí aún no se ha verificado.
Los ajustes de seguridad de la API pública siguen la especificación nativa. El Playground exige bloqueo desde el nivel medio para las cuatro categorías de seguridad principales; los umbrales más bajos solo están disponibles en la API, con una excepción para administradores.
Streaming y continuación
Lee los eventos JSON nativos del flujo SSE. Conserva todas las partes, incluidos los metadatos de herramientas y razonamiento. Los contadores de uso de un mismo flujo son acumulativos: usa el último objeto de uso en lugar de sumar todos los eventos.
Cuando un candidato devuelva continuationToken, consérvalo exactamente. Para CONTINUATION, vuelve a enviar los contenidos, la instrucción del sistema, las herramientas y los ajustes de generación originales con el último token en el nivel superior. No añadas la salida parcial a contents. Para MAX_TOKENS, aumenta el presupuesto de salida antes de reanudar. El Playground prepara una solicitud de continuación para revisarla y solo la envía cuando vuelves a pulsar Enviar.
Cada continuación es una solicitud independiente con su propio consumo y coste. Conserva puntos de recuperación si implementas reconexiones; nunca des por hecho que un flujo desconectado se completó. La respuesta nativa se conserva en el Playground para inspeccionar todos los campos.
Uso y estado actual de la verificación
El uso de entrada incluye la entrada en caché; la salida facturable incluye los tokens de candidatos y razonamiento. Consulta las tarifas actuales en la página del modelo y los registros de uso de tu cuenta. Las solicitudes fallidas no se cobran.
Las pruebas locales del 14 de octubre de 2026 verificaron el streaming de texto, el JSON estructurado, las llamadas a funciones firmadas con devolución de resultados, la ejecución de código, Google Search y URL context, la comprensión de imágenes, vídeos y PDF, la salida de razonamiento y las secuencias de parada. El audio fue aceptado, pero parte de la muestra se transcribió incorrectamente.
logprobs fue rechazado explícitamente. Las solicitudes con maxOutputTokens: 32769 fallaron tanto en las pruebas JSON como en las SSE. Un continuationToken válido y otro inválido devolvieron respuestas, por lo que la continuación correcta no está verificada. Las opciones de nivel de servicio y seed fueron aceptadas sin pruebas de su efecto. Maps, File Search, Computer Use, agentic video y las referencias a archivos externos siguen sin probarse.
Estas pruebas limitadas no validan todas las combinaciones de parámetros ni la disponibilidad en producción. Usa el formato nativo para la especificación completa; la compatibilidad con OpenAI es un subconjunto separado y no ofrece long decode.
Referencias
- Especificación oficial del modelo
- Guía de migración de GenerateContent
- Decodificación larga y continuación
- Salidas estructuradas
Grupo LLM opcional
Inicia sesión en el Playground de este modelo para consultar los grupos disponibles. Las opciones dependen de los permisos de tu cuenta y del modelo seleccionado. Playground utiliza tu sesión de inicio de sesión; no necesitas proporcionar una clave API.
Las llamadas a la API mantienen tu clave API y el ID del modelo. Para seleccionar un grupo, envía su nombre exacto en la cabecera opcional X-SeedRouter-Group. Sustituye GROUP_NAME a continuación por uno de los nombres que aparecen en Playground. Omite la cabecera o usa auto para conservar el comportamiento predeterminado de la clave.
X-SeedRouter-Group: GROUP_NAMEUna clave API con restricciones puede tener menos grupos disponibles que Playground. Las solicitudes se facturan según los precios del grupo seleccionado y no cambian a otro grupo si este no está disponible. Esta opción admite llamadas LLM por HTTP, incluido SSE; no se aplica a llamadas WebSocket, de imágenes ni de vídeo.
Para consultar los grupos disponibles para una clave API concreta sin generar una respuesta del modelo, utiliza este endpoint de solo lectura. data[].id es el valor de la cabecera; ratio es el multiplicador de precio de la cuenta para ese grupo. La entrada auto refleja la estimación actual de la selección predeterminada; su multiplicador es null cuando no hay ningún grupo predeterminado disponible. La disponibilidad del grupo se comprueba de nuevo al llamar al modelo.
curl "https://api.seedrouter.ai/api/seedrouter/llm/groups?model=gemini-4-argon" \
-H "Authorization: Bearer YOUR_SEEDROUTER_KEY"