Source: https://ailoot.ai/models/es-mx/google-gemini-3-1-pro-preview-u003a-batch/ Canonical: https://ailoot.ai/models/es-mx/google-gemini-3-1-pro-preview-u003a-batch/ Language: es-mx # Google: Gemini 3.1 Pro Preview (batch) [Markdown](https://ailoot.ai/models/es-mx/google-gemini-3-1-pro-preview-u003a-batch/index.md) · [JSON](https://ailoot.ai/models/es-mx/google-gemini-3-1-pro-preview-u003a-batch/facts.json) ## [Google: Gemini 3.1 Pro Preview (batch)](https://ailoot.ai/models/es-mx/google-gemini-3-1-pro-preview-u003a-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, video 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 · Batch** `POST /v1/batches` `google/gemini-3.1-pro-preview:batch`](https://ailoot.ai/models/es-mx/google-gemini-3-1-pro-preview-u003a-batch/#method-0) 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 necesitan ingeniería de software, desarrollo algorítmico o síntesis de evidencia multimodal. Se basa en Gemini 3 Pro, con énfasis en uso preciso de herramientas, razonamiento más eficiente y ejecución confiable de varios pasos. Texto, imágenes, audio, video y PDF pueden contribuir a una respuesta escrita, un recurso de código o un resultado estructurado. Para una tarea exigente de programación, proporciona el objetivo, el material pertinente del repositorio, el comportamiento observado y las restricciones que deben conservarse. Los repositorios completos de código pueden aportar contexto para la tarea. Para revisar un contrato de código, pide al modelo que compare cómo dos módulos manejan un contrato compartido de datos, identifique la discrepancia y proponga una corrección enfocada con referencias de código que la respalden. La salida útil distingue el análisis, la revisión propuesta y la evidencia de cualquier validación realizada por la aplicación conectada. El material de lanzamiento demuestra explicaciones visuales basadas en código y proyectos interactivos, incluida salida SVG animada a partir de un encargo textual. Son recursos de código, no generación de imágenes ráster. Un encargo claro puede definir qué debe explicarse, cómo debe comportarse el elemento visual y los datos que debe representar. Revisa el código resultante y su representación frente a esos requisitos. Para síntesis de datos, proporciona las fuentes reales y solicita una vista que conserve las relaciones y salvedades que contienen. Los niveles de pensamiento documentados son bajo, medio y alto, con alto como valor predeterminado de 3.1 Pro Preview. El pensamiento no puede deshabilitarse por completo en este perfil Pro. Elige un esfuerzo menor para una respuesta acotada y más razonamiento para trabajo difícil de varios pasos, dejando suficiente capacidad de salida para el entregable final. Un límite pequeño de salida puede interrumpir el razonamiento antes de que aparezca una respuesta final utilizable. La guía de pensamiento separa un resumen del razonamiento del proceso interno completo y explica por qué importa el contexto de firmas de pensamiento de la conversación. La tabla exacta de Preview enumera llamadas a funciones, ejecución de código, fundamentación mediante búsquedas, fundamentación con Maps, contexto de URL y salidas estructuradas. Limita File Search a AI Studio. Proporciona los propósitos de las funciones y las definiciones de parámetros, y continúa a partir del resultado real devuelto. El perfil separado Custom Tools Preview está optimizado para priorizar herramientas personalizadas y bash; es un endpoint del productor con nombre distinto, por lo que esa especialización no debe tratarse silenciosamente como propiedad de cada solicitud de 3.1 Pro. Selecciona un esquema de resultado estructurado cuando una tarea necesite registros definidos en lugar de prosa sin restricciones. Para análisis multimodal, identifica la página, elemento visual, intervalo de grabación o evento de video pertinente. Para análisis documental, compara un diagrama con su especificación escrita y devuelve cada discrepancia con el pasaje que la respalda. Una fuente hablada puede contribuir con una transcripción o una interpretación textual. Conserva referencias de fuente para las conclusiones que necesitan comprobarse y separa lo visible o declarado de lo inferido. 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 textual, y la tabla exacta de API Preview indica 1,048,576 tokens de entrada y 65,536 de salida. Incluye instrucciones, historial de conversación y medios en el presupuesto de entrada. Se documentan caché y procesamiento por lotes, con opciones Flex y Priority también enumeradas para el perfil del productor. Para varios elementos independientes, define la salida requerida y conserva cada identificador de fuente en lugar de combinar evidencia sin relación en una respuesta imposible de rastrear. La edición Preview identificada sigue siendo distinta del perfil Custom Tools de Pro y de lanzamientos posteriores de Flash o Pro. Sus fortalezas se refieren al razonamiento complejo, la programación y la síntesis de evidencia; el entregable final sigue necesitando comprobarse frente a la fuente y los resultados reales de herramientas. Conserva la ambigüedad sin resolver cuando la información proporcionada no respalde una conclusión definitiva. Un entregable útil es la respuesta, el código o el registro respaldados que solicitó la tarea, con suficiente evidencia para evaluar sus límites prácticos. **Ailoot Ultra · Batch** `POST /v1/batches` `google/gemini-3.1-pro-preview:batch` [`google/gemini-3.1-pro-preview:batch`](https://ailoot.ai/models/es-mx/#m=google%2Fgemini-3.1-pro-preview%3Abatch&route=Ultra&caller=google%2Fgemini-3.1-pro-preview%3Abatch&fmt=batches) Google /`google/gemini-3.1-pro-preview:batch` ### Inicio 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, video 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. Entradas aceptadas Texto Resultados Texto ### Disponible en Ailoot · entradas y métodos **Ailoot Ultra · Batch** `POST /v1/batches` Entrada `text` Salida `text` Formato de salida JSON de results\[\].response.body en línea | 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 línea; cada elemento tiene custom\_id y body | | Parámetro`request_endpoint_profile` | Contrato/v1/chat/completions | | Parámetro`file_material` | ContratoQuien realiza la llamada puede leer localmente el JSONL UTF-8 real e incorporarlo a requests\[\]. No se utiliza el campo purpose para cargas, ni input\_file\_id ni referencias 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 solicitudes de texto de Chat Completions dentro de la estructura Batch en línea documentada. | Ciclo de vida: `asynchronous` `GET /v1/batches/{operation_id}` · El response.id real de la respuesta de creación original; el mismo usuario, clave y grupo ### Tarifas Las referencias tarifarias no añaden opciones a la solicitud. Los parámetros admitidos se indican en el método seleccionado. Modo fast Sin especificar Cuando se selecciona el modo fast Modo flex Sin especificar Cuando se selecciona el modo flex Esfuerzo máximo de razonamiento Sin especificar Cuando el esfuerzo máximo de razonamiento usa el ajuste 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ónNivel 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ónNivel 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 monto 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 →](https://ailoot.ai/docs/es-mx/billing/reserve/) ### Solicitudes de ejemplo #### Ailoot Ultra · Batch curl · ejemplo de prueba conservadoPython HTTP · JSONL real del clientePython · guarda cada resultado completado ```bash 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 ``` ```python 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")) ``` ```python 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 · Batch JSON de results\[\].response.body en línea - `GET /v1/batches/{operation_id}` ##### Consultar el estado de la tarea curl · estado de la operación original ```bash 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 result/custom\_id y el cuerpo completo de la respuesta o del error. Guarda results\[\] completados como JSONL sin filtrar. ##### Si es necesario revisar la respuesta original Conserva el ID de la operación original. La respuesta 503 result\_pending\_check incluye X-Should-Retry:false; nunca vuelvas a enviar un lote original cuyo resultado sea desconocido. 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ónLa estructura en línea documentada no es válida, hay claves duplicadas, existe un problema con la identidad de los elementos o hay un conflicto entre las capacidades configuradas del modelo. | Siguiente pasoCorrige los campos indicados antes de realizar cualquier nuevo envío. | | Respuesta401 · `authentication_error` | CondiciónClave de API no válida. | Siguiente pasoUsa la clave de Ailoot autorizada. | | Respuesta403 · `permission_error` | CondiciónGrupo de Batch no disponible. | Siguiente pasoVerifica los permisos de la clave y el grupo. | | Respuesta422 · `invalid_request_error` | CondiciónBatch usa facturación contra saldo; se rechazan las solicitudes de creación con una suscripción. | Siguiente pasoUsa el grupo autorizado con facturación contra saldo. | | Respuesta422 · `price_unavailable` | CondiciónNo se puede cotizar 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 los requisitos de admisión antes de realizar 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 una revisió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`](https://ailoot.ai/models/es-mx/#m=google%2Fgemini-3.1-pro-preview%3Abatch&route=Ultra&caller=google%2Fgemini-3.1-pro-preview%3Abatch&fmt=batches) #### 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`](https://ailoot.ai/models/es-mx/#m=google%2Fgemini-3.1-pro-preview%3Abatch&route=Ultra&caller=google%2Fgemini-3.1-pro-preview%3Abatch&fmt=batches) 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` Conecta Ailoot a Claude Code, OpenCode, Hermes o tu aplicación. ## La empresa y su cartera de proyectos La empresa y su cartera de proyectos: millones de clientes; ventas por miles de millones al mes. ## Compra tokens con descuento. Ahorro por suscripción para trabajo habitual. Códigos promocionales: hasta el 50% al comprar tokens. Suscripción Elige un plan con descuento para tus peticiones habituales. Código de hasta el 50% Introduce el código al comprar. El precio se recalcula según la promoción vigente. Gasto en el historial Modelo, tokens e importe quedan guardados por cada petición. [Elegir suscripción](https://ailoot.ai/docs/es-mx/billing/subscriptions/) · [Consultar precios de modelos](https://ailoot.ai/models/es-mx/) ## Conecta la API al producto que vendes. SaaS, aplicaciones y bots bajo la oferta y el acuerdo de licencia Ailoot. Solicita una licencia de reventa para redistribuir el acceso. Aplicación comercial Integra generación de texto, imágenes, vídeo y sonido en funciones de pago de tu servicio. Licencia para revendedores Envía descripción del proyecto y esquema de acceso. Solicita condiciones escritas de uso y reventa. Documentos en la web La oferta, el acuerdo de licencia y la política de datos están disponibles antes de conectar. [Solicitar licencia de reventa](mailto:support@ailoot.ai) · [Oferta y acuerdo de licencia](https://ailoot.ai/legal/offer?lang=es-mx) ## Ailoot · La empresa y su cartera de proyectos Ailoot se apoya en la experiencia operativa acumulada, una amplia base de clientes, un servicio estable y el seguimiento continuo de KPI. La empresa y su cartera de proyectos: millones de clientes; ventas por miles de millones al mes. Ailoot aplica esa experiencia operativa al acceso por API a funciones de IA en productos de clientes, agentes, aplicaciones y automatizaciones.