Google: Gemini 3.1 Pro Preview (batch)

Gemini 3.1 Pro Preview es el modelo de razonamiento multimodal de Google para tareas complejas de software, algoritmos y conocimiento. Acepta texto, imágenes, audio, vídeo y PDF y devuelve texto o código, con herramientas y salida estructurada. Los niveles de razonamiento low, medium y high orientan el esfuerzo; high es el valor predeterminado documentado.

Ailoot Ultra · Procesamiento por lotes POST /v1/batches google/gemini-3.1-pro-preview:batch

Sobre el modelo

Esta descripción cubre las capacidades del modelo. Las entradas, salidas y opciones disponibles en Ailoot se indican a continuación para el método seleccionado.

Gemini 3.1 Pro Preview es el modelo de texto de Google orientado al razonamiento para tareas complejas que requieren ingeniería de software, desarrollo de algoritmos o síntesis de pruebas multimodales. Se basa en Gemini 3 Pro y hace hincapié en el uso preciso de herramientas, un razonamiento más eficiente y una ejecución fiable de varios pasos. El texto, las imágenes, el audio, el vídeo y los PDF pueden contribuir a una respuesta escrita, un artefacto de código o un resultado estructurado.

Para un encargo de programación exigente, proporcione el objetivo, el material pertinente del repositorio, el comportamiento observado y las restricciones que deben mantenerse. Los repositorios completos de código pueden aportar contexto para el encargo. Para revisar un contrato de código, pida al modelo que compare cómo gestionan dos módulos un contrato de datos compartido, identifique la discrepancia y proponga una corrección concreta con referencias al código que la respalden. La salida útil distingue el análisis, la revisión propuesta y las pruebas de cualquier validación realizada por la aplicación conectada.

El material de lanzamiento muestra explicaciones visuales basadas en código y proyectos interactivos, incluida la generación de SVG animados a partir de un encargo textual. Se trata de artefactos de código, no de generación de imágenes ráster. Un encargo claro puede definir qué debe explicarse, cómo debe comportarse la representación visual y qué datos debe representar. Revise el código resultante y su representación visual con respecto a esos requisitos. Para una tarea de síntesis de datos, proporcione las fuentes reales y solicite una única vista que conserve las relaciones y los matices presentes en ellas.

Los niveles de razonamiento documentados son bajo, medio y alto, con el alto como predeterminado para 3.1 Pro Preview. El razonamiento no puede desactivarse por completo en este perfil Pro. Elija un esfuerzo menor para una respuesta de alcance acotado y más razonamiento para trabajos difíciles de varios pasos, dejando al mismo tiempo un margen de salida suficiente para el artefacto final. Un límite de salida reducido puede interrumpir el razonamiento antes de que aparezca una respuesta final utilizable. La guía de razonamiento distingue un resumen del razonamiento del proceso interno completo y explica por qué es importante el contexto de las firmas de pensamiento de la conversación.

La tabla exacta de Preview enumera llamadas a funciones, ejecución de código, fundamentación con búsquedas, fundamentación con Maps, contexto de URL y salidas estructuradas. Limita File Search a AI Studio. Proporcione los propósitos de las funciones y las definiciones de sus parámetros, y continúe a partir del resultado real devuelto. El perfil independiente Custom Tools Preview está optimizado para dar prioridad a las herramientas personalizadas y a bash; es un endpoint del fabricante con un nombre propio, por lo que esa especialización no debe atribuirse, sin indicarlo, a todas las solicitudes a 3.1 Pro. Seleccione un esquema de resultados estructurados cuando una tarea necesite registros definidos en lugar de texto libre.

Para el análisis multimodal, identifique la página, el elemento visual, el intervalo de grabación o el evento de vídeo pertinente. Para el análisis de documentos, compare un diagrama con su especificación escrita y devuelva cada discrepancia con el pasaje que la respalda. Una fuente oral puede aportar una transcripción o una interpretación en texto. Conserve las referencias a las fuentes para las conclusiones que deban comprobarse y distinga lo que es visible o se afirma de lo que se infiere. La salida de este perfil sigue siendo texto, incluido código; la generación nativa de imágenes o voz no forma parte de su tabla exacta de capacidades.

La ficha nativa de 3.1 Pro especifica hasta 1M de contexto y 64K de salida de texto, y la tabla exacta de la API de Preview establece 1 048 576 tokens de entrada y 65 536 tokens de salida. Incluya las instrucciones, el historial de conversación y el contenido multimedia en el presupuesto de entrada. El almacenamiento en caché y el procesamiento por lotes están documentados, y también se enumeran las opciones Flex y Priority para el perfil del fabricante. Para varios elementos independientes, defina la salida requerida y conserve el identificador de cada fuente en lugar de combinar pruebas sin relación entre sí en una única respuesta sin trazabilidad.

La edición denominada Preview sigue siendo distinta del perfil Custom Tools de Pro y de las versiones posteriores de Flash o Pro. Sus puntos fuertes se centran en el razonamiento complejo, la programación y la síntesis de pruebas; el artefacto final sigue necesitando una comprobación frente a la fuente y los resultados reales de las herramientas. Conserve las ambigüedades sin resolver cuando la información proporcionada no permita llegar a una conclusión definitiva. Una entrega útil es la respuesta, el código o el registro respaldado por pruebas que solicitó la tarea, con pruebas suficientes para evaluar sus límites prácticos.

Ailoot Ultra · Procesamiento por lotes POST /v1/batches google/gemini-3.1-pro-preview:batch

google/gemini-3.1-pro-preview:batch

Google /google/gemini-3.1-pro-preview:batch

Primeros pasos

Entradas aceptadas: Texto
Resultados: Texto

Disponible en Ailoot · entradas y métodos

Ailoot Ultra · Procesamiento por lotes POST /v1/batches

Tipos de entrada: text
Tipos de salida: text
Formato de salida: JSON de results[].response.body incluido directamente

Campo	Tipo	Requisito	Valores y límites	Predeterminado
Campo`endpoint`	Tipo`string`	RequisitoObligatorio	Valores y límites /v1/chat/completions	Predeterminado—
Campo`model`	Tipo`string`	RequisitoObligatorio	Valores y límites google/gemini-3.1-pro-preview:batch	Predeterminado—
Campo`requests`	Tipo`batch_item[]`	RequisitoObligatorio	Valores y límites Número mínimo de elementos: 1	Predeterminado—
Campo`requests[].custom_id`	Tipo`string`	RequisitoObligatorio	Valores y límites	Predeterminado—
Campo`requests[].body.messages`	Tipo`message[]`	RequisitoObligatorio	Valores y límites	Predeterminado—
Campo`completion_window`	Tipo`string`	RequisitoOpcional	Valores y límites 24h	Predeterminado—
Campo`provider`	Tipo`object\|null`	RequisitoOpcional	Valores y límites	Predeterminado—
Campo`requests[].body.model`	Tipo`string`	RequisitoOpcional	Valores y límites google/gemini-3.1-pro-preview:batch, google/gemini-3.1-pro-preview	Predeterminado—
Campo`provider.only`	Tipo`string[]`	RequisitoOpcional	Valores y límites google-vertex/global	Predeterminado—
Campo`provider.allow_fallbacks`	Tipo`boolean\|null`	RequisitoOpcional	Valores y límites false, null	Predeterminado—

Parámetros del método y ciclo de vida

Parámetro	Contrato
Parámetro`content_type`	Contratoapplication/json
Parámetro`required`	Contratoendpoint, model, requests
Parámetro`material_types`	Contratotext
Parámetro`representation`	Contratorequests[] en la propia solicitud; cada elemento tiene custom_id y body
Parámetro`request_endpoint_profile`	Contrato/v1/chat/completions
Parámetro`file_material`	ContratoEl cliente puede leer localmente el JSONL real en UTF-8 e incorporarlo a requests[]. No se utiliza purpose de carga, input_file_id ni ninguna referencia a archivos. Si falta el material del cliente o está vacío, la preparación se detiene antes del POST.
Parámetro`serialization_order`	Contratoendpoint, model, provider (si se proporciona), completion_window (si se proporciona), requests al final
Parámetro`optional_controls`	Contratoprovider.only, provider.allow_fallbacks, completion_window
Parámetro`schema_scope`	ContratoCuerpos de Chat Completions de texto incluidos directamente en el contenedor Batch documentado.

Ciclo de vida: asynchronous

GET /v1/batches/{operation_id} · response.id real de la respuesta de creación original; mismo usuario, clave y grupo

Planes

Las referencias tarifarias no añaden opciones a la solicitud. Los parámetros admitidos se indican en el método seleccionado.

Modo rápido: Sin especificar Cuando se selecciona el modo rápido
Modo flex: Sin especificar Cuando se selecciona el modo flex
Esfuerzo máximo de razonamiento: Sin especificar Cuando el esfuerzo máximo de razonamiento utiliza el ajuste predeterminado (default)
Precios de caché explícita: No habilitado Cuando se solicita caché explícita

Tarifas de Ailoot

Precios por configuración

Relaciona cada cargo con las condiciones mostradas. Usa una tarifa para cada conjunto de configuraciones alternativas.

Configuración	Tabla de tarifas	Tokens de contexto, más de	Tokens de contexto, hasta inclusive	Cargo
ConfiguraciónTarifas base por token	Tabla de tarifasTarifa base	Tokens de contexto, más de—	Tokens de contexto, hasta inclusiveSin límite superior	Cargo Entrada · Tokens de entrada $0.002 / 1K tokens Salida · Tokens de salida $0.012 / 1K tokens Entrada · Lectura de caché — / 1K tokens Entrada · Escritura en caché — / 1K tokens Entrada · Escritura en caché, 1 hora — / 1K tokens
ConfiguraciónTramo 1 por longitud de la solicitud	Tabla de tarifas—	Tokens de contexto, más de0	Tokens de contexto, hasta inclusive200.000	Cargo Entrada · Tokens de entrada $0.002 / 1K tokens Salida · Tokens de salida $0.012 / 1K tokens Entrada · Lectura de caché — / 1K tokens Entrada · Escritura en caché — / 1K tokens Entrada · Escritura en caché, 1 hora — / 1K tokens
ConfiguraciónTramo 2 por longitud de la solicitud	Tabla de tarifas—	Tokens de contexto, más de200.000	Tokens de contexto, hasta inclusiveSin límite superior	Cargo Entrada · Tokens de entrada $0.004 / 1K tokens Salida · Tokens de salida $0.018 / 1K tokens Entrada · Lectura de caché — / 1K tokens Entrada · Escritura en caché — / 1K tokens Entrada · Escritura en caché, 1 hora — / 1K tokens

Ailoot reserva un importe estimado antes de la solicitud. Tras obtener el resultado, liquida el cargo definitivo según el uso medido. En las respuestas en flujo, la liquidación usa el registro de uso final. Cómo funcionan la reserva y la liquidación →

Solicitudes de ejemplo

Ailoot Ultra · Procesamiento por lotes

curl · ejemplo de prueba conservadoPython HTTP · JSONL real del clientePython · guarda cada resultado completado

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json
from pathlib import Path
body=json.loads('{"endpoint":"/v1/chat/completions","model":"google/gemini-3.1-pro-preview:batch","requests":[{"custom_id":"req-0001","body":{"messages":[{"role":"user","content":"Hello!"}],"max_tokens":16}}]}')
Path("batch-request.json").write_text(json.dumps(body,ensure_ascii=False),encoding="utf-8")
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/batches \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @batch-request.json -D batch-response-headers.txt -o batch-create-response.json

import json, os
from pathlib import Path
from urllib.request import Request, urlopen

def prepare_requests(customer_path):
    path = Path(customer_path)
    if not path.is_file(): raise ValueError("Customer JSONL file is missing")
    items = [json.loads(line) for line in path.read_text(encoding="utf-8").splitlines() if line.strip()]
    if not items: raise ValueError("Customer JSONL contains no requests")
    ids = set()
    for item in items:
        if set(item) != {"custom_id", "body"}: raise ValueError("Each item needs custom_id and body")
        cid = item["custom_id"]
        if not isinstance(cid, str) or not cid.strip() or cid in ids: raise ValueError("custom_id must be nonempty and unique")
        ids.add(cid)
        if not isinstance(item["body"], dict) or not item["body"].get("messages"): raise ValueError("Supply actual text messages")
        supplied_model = item["body"].get("model")
        if supplied_model is not None and supplied_model not in ['google/gemini-3.1-pro-preview:batch', 'google/gemini-3.1-pro-preview']: raise ValueError("body.model must be an exact documented caller or wire ID")
    return {"endpoint":"/v1/chat/completions", "model":"google/gemini-3.1-pro-preview:batch", "requests":items}

if __name__ == "__main__":
    material = os.environ.get("AILOOT_BATCH_REQUESTS_JSONL", "")
    if not material: raise SystemExit("Set AILOOT_BATCH_REQUESTS_JSONL to your actual customer file")
    body = prepare_requests(material)
    key = os.environ.get("AILOOT_API_KEY", "")
    if not key: raise SystemExit("Set AILOOT_API_KEY")
    request = Request("https://api.ailoot.ai/v1/batches", data=json.dumps(body, ensure_ascii=False).encode("utf-8"), headers={"Authorization":"Bearer " + key, "Content-Type":"application/json"}, method="POST")
    with urlopen(request) as response:
        raw = response.read()
        Path("batch-create-response.json").write_bytes(raw)
        print(raw.decode("utf-8"))

import json
from pathlib import Path
raw = Path("batch-status-response.json").read_bytes()
response = json.loads(raw)
if response.get("status") != "completed":
    raise SystemExit("Keep the original operation; read its status without resubmitting")
results = response.get("results")
if not isinstance(results, list) or not results:
    raise SystemExit("Preserve the original response; completed results are missing")
Path("batch-results.jsonl").write_text("".join(json.dumps(item, ensure_ascii=False) + "\n" for item in results), encoding="utf-8")
# Preserve batch-status-response.json with aggregate usage and every result/error.

Recibir y guardar resultados

Ailoot Ultra · Procesamiento por lotes

JSON de results[].response.body incluido directamente

GET /v1/batches/{operation_id}

Consultar el estado de la tarea

curl · estado de la operación original

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
BATCH_OPERATION_ID="$(python3 - <<'PY_ID'
import json
from pathlib import Path
from urllib.parse import quote
response = json.loads(Path("batch-create-response.json").read_text(encoding="utf-8"))
operation = response.get("id")
if not isinstance(operation, str) or not operation: raise SystemExit("No actual original operation ID; preserve the response and do not resubmit")
print(quote(operation, safe=""))
PY_ID
)"
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/batches/$BATCH_OPERATION_ID" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o batch-status-response.json

Conserva todos los resultados completados

Conserva todas las respuestas, archivos y partes de contenido completos recibidos.

Conserva el JSON completo del estado original, cada resultado y su custom_id, y el cuerpo completo de la respuesta o del error. Guarda los results[] completados como JSONL sin filtrarlos.

Si es necesario revisar la respuesta original

Conserva el ID de la operación original. 503 result_pending_check incluye X-Should-Retry:false; nunca vuelvas a enviar un lote original cuyo resultado se desconoce.

Campos de respuesta

Campo	Tipo
Campo`results[].custom_id`	Tipostring
Campo`results[].response.body.choices[].message.content`	Tipostring\|null
Campo`results[].error`	Tipoobject\|null
Campo`usage`	Tipoobject\|null
Campo`id`	Tipostring
Campo`model`	Tipostring
Campo`endpoint`	Tipostring
Campo`status`	Tipostring
Campo`request_counts`	Tipoobject
Campo`results[].id`	Tipostring
Campo`results[].response.status_code`	Tipointeger
Campo`results[].response.request_id`	Tipostring

Errores y siguientes pasos

Respuesta	Condición	Siguiente paso
Respuesta400 · `invalid_request_error`	CondiciónEl contenedor documentado con contenido incluido directamente no es válido, hay claves duplicadas, la identidad de un elemento no es válida o existe un conflicto con las capacidades configuradas del modelo.	Siguiente pasoCorrige los campos indicados antes de cualquier nuevo envío.
Respuesta401 · `authentication_error`	CondiciónClave API no válida.	Siguiente pasoUsa la clave Ailoot autorizada.
Respuesta403 · `permission_error`	CondiciónGrupo de Batch no disponible.	Siguiente pasoComprueba los permisos de la clave y del grupo.
Respuesta422 · `invalid_request_error`	CondiciónBatch se factura con cargo al saldo; se rechaza su creación con una suscripción.	Siguiente pasoUsa el grupo autorizado que se factura con cargo al saldo.
Respuesta422 · `price_unavailable`	CondiciónNo se puede calcular el presupuesto de la entrada de Batch.	Siguiente pasoConserva la respuesta; usa la entrada documentada para la familia.
Respuesta402 · `billing_error`	CondiciónReserva de Batch no disponible.	Siguiente pasoResuelve la admisión antes de enviar una nueva solicitud.
Respuesta503 · `price_unavailable`	CondiciónPrecio del método Batch o tarifas nativas no disponibles.	Siguiente pasoConserva la respuesta; no sustituyas los precios.
Respuesta503 · `api_error`	CondiciónLa ruta exacta del proveedor no está disponible.	Siguiente pasoConserva la respuesta para reparar la ruta.
Respuesta503 · `result_pending_check`	CondiciónEl resultado original requiere comprobación; X-Should-Retry:false.	Siguiente pasoConserva el operation_id/id original y consulta su estado; nunca repitas el POST original.
Respuesta404 · `not_found`	CondiciónLa operación de consulta de estado de Batch no existe o pertenece a otra identidad.	Siguiente pasoUsa el id original exacto y el mismo usuario, clave y grupo.

Alias

Alias del modelo

Ailoot Ultra google/gemini-3.1-pro-preview:batch

Alias de rutas de métodos

Usa las rutas de método indicadas arriba.

ID de modelo relacionados

google/gemini-3.1-pro-preview:batch

FAQ · Google: Gemini 3.1 Pro Preview (batch)

¿Qué entradas y resultados están disponibles?: POST /v1/batches · google/gemini-3.1-pro-preview:batch: text → text
¿Qué campos utiliza la solicitud?: POST /v1/batches · google/gemini-3.1-pro-preview:batch: endpoint, model, requests, completion_window, provider
¿Qué límites se aplican?: POST /v1/batches · google/gemini-3.1-pro-preview:batch: requests.min_items: 1

Google: Gemini 3.1 Pro Preview (batch)