Google: Gemini 3.8 Flash (batch)
Gemini 3.8 Flash es el modelo multimodal de uso intensivo de Google para ingeniería de software sostenida, agentes y tareas complejas de conocimiento. Acepta texto, imágenes, audio, video y PDF, devuelve texto y ofrece razonamiento bajo, medio o alto con herramientas y salida estructurada. Sus límites documentados de entrada/salida son 1,048,576/65,536 tokens.
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.8 Flash es el modelo de Google con salida de texto para ingeniería de software sostenida, agentes de varios pasos y flujos complejos de conocimiento. Se basa en Gemini 3.7 Flash, con mejoras en ingeniería de software y trabajo de conocimiento con agentes. Acepta texto, imágenes, audio, video y PDF, por lo que una tarea puede combinar un objetivo escrito con el material real necesario para resolverlo. El resultado útil es un cambio de código, un análisis explicado, una respuesta escrita o un registro estructurado.
Para una tarea de programación, proporciona el requisito, los archivos pertinentes, el comportamiento observado y las restricciones que deben conservarse. Una captura de pantalla puede establecer la interfaz prevista, mientras que los registros o un ejemplo reproducible muestran la falla. Para depuración, pide al modelo que rastree una discrepancia entre el estado visible de un formulario y su valor almacenado, identifique la ruta de código responsable y proponga una corrección enfocada. Mantén claro el entregable final previsto para que una secuencia más larga de investigación y uso de herramientas siga teniendo una condición específica de finalización.
Para trabajos prolongados, utiliza pasos de razonamiento más pequeños, llamadas iterativas a herramientas y comprobaciones de resultados intermedios. Los niveles de pensamiento bajo, medio y alto controlan la cantidad de razonamiento; medio es el valor predeterminado documentado. Bajo sirve para un borrador rápido o un análisis acotado, mientras que alto está destinado a matemáticas difíciles, programación o tareas de varios pasos. Gemini 3.8 Flash no admite el nivel de pensamiento mínimo. Por eso, una tarea de depuración sostenida y una extracción sencilla de campos necesitan elecciones distintas de razonamiento, en lugar del mismo ajuste para cada solicitud.
Las herramientas documentadas incluyen llamadas a funciones, ejecución de código, búsqueda de archivos, fundamentación mediante búsquedas, fundamentación con Google Maps y contexto de URL; Computer Use figura como capacidad preliminar. Las salidas estructuradas definen un resultado legible por máquina. Las funciones deben tener un propósito claro y una definición de parámetros: el modelo puede solicitar una función, mientras que la aplicación conectada realiza la operación y devuelve su resultado. Conserva entre turnos las identidades de las funciones y el material realmente devuelto. Una respuesta final útil explica qué evidencia respalda la corrección propuesta o el valor extraído.
La guía de migración de 3.8 utiliza controles de nivel de pensamiento en lugar de la configuración anterior de presupuesto de razonamiento y aconseja eliminar los parámetros de muestreo obsoletos y los turnos de modelo prellenados. También exige conservar las firmas de pensamiento en el flujo sin estado correspondiente y vincular las respuestas de funciones con sus llamadas por identidad y nombre. Estos detalles importan al continuar una tarea de varios pasos: el siguiente turno necesita el contexto anterior real, en lugar de una versión reescrita que pierda el resultado de la herramienta o la firma. Mantén explícitos la pregunta y el resultado solicitado en el nuevo turno del usuario.
Para trabajo de conocimiento multimodal, identifica las páginas documentales, la gráfica, el intervalo de audio o el evento de video pertinentes e indica cómo deben contribuir a la respuesta. Una comparación de documentos puede solicitar una tabla de diferencias con pasajes de las fuentes; una pregunta sobre una gráfica puede pedir los valores visibles y la conclusión que respaldan. Un análisis de video puede solicitar una descripción de los eventos que justifican un hallazgo. El modelo devuelve texto a partir de estas entradas. Las imágenes generadas, la voz y la interacción de audio Live pertenecen a perfiles de modelo distintos.
Sus límites de Gemini API son 1,048,576 tokens de entrada y 65,536 de salida, correspondientes al contexto nativo de hasta 1M y la salida de texto de 64K. Las instrucciones, el historial de conversación y los medios proporcionados consumen contexto de entrada, y el razonamiento o un entregable final largo deben caber en la capacidad documentada de salida. Google también enumera caché, procesamiento por lotes y procesamiento Flex y Priority para este perfil del productor. Para elementos independientes, conserva un identificador estable del elemento y un formato explícito de salida para que cada resultado permanezca vinculado a su fuente.
Las posibles limitaciones incluyen alucinaciones, lentitud ocasional o tiempos de espera agotados y mayor consumo de tokens con esfuerzos más altos. Su fecha de corte de conocimiento es marzo de 2026, con algunos dominios todavía limitados a enero de 2025. Proporciona evidencia actual o usa las herramientas de fundamentación documentadas cuando la tarea dependa de información posterior. Revisa las citas de fuentes, los cálculos y el código propuesto frente a las entradas reales y los resultados de ejecución. El entregable final útil debe distinguir un hallazgo respaldado de una pregunta sin resolver, sin suponer que una respuesta fluida establece el resultado solicitado.
Ailoot Ultra · Batch POST /v1/batches google/gemini-3.8-flash:batch
google/gemini-3.8-flash:batchInicio
Gemini 3.8 Flash es el modelo multimodal de uso intensivo de Google para ingeniería de software sostenida, agentes y tareas complejas de conocimiento. Acepta texto, imágenes, audio, video y PDF, devuelve texto y ofrece razonamiento bajo, medio o alto con herramientas y salida estructurada. Sus límites documentados de entrada/salida son 1,048,576/65,536 tokens.
- 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 |
|---|---|---|---|---|
Campoendpoint | Tipostring | RequisitoObligatorio | Valores y límites /v1/chat/completions | Predeterminado— |
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites google/gemini-3.8-flash:batch | Predeterminado— |
Camporequests | Tipobatch_item[] | RequisitoObligatorio | Valores y límites Número mínimo de elementos: 1 | Predeterminado— |
Camporequests[].custom_id | Tipostring | RequisitoObligatorio | Valores y límites | Predeterminado— |
Camporequests[].body.messages | Tipomessage[] | RequisitoObligatorio | Valores y límites | Predeterminado— |
Campocompletion_window | Tipostring | RequisitoOpcional | Valores y límites 24h | Predeterminado— |
Campoprovider | Tipoobject|null | RequisitoOpcional | Valores y límites | Predeterminado— |
Camporequests[].body.model | Tipostring | RequisitoOpcional | Valores y límites google/gemini-3.8-flash:batch, google/gemini-3.8-flash | Predeterminado— |
Campoprovider.only | Tipostring[] | RequisitoOpcional | Valores y límites google-vertex/global | Predeterminado— |
Campoprovider.allow_fallbacks | Tipoboolean|null | RequisitoOpcional | Valores y límites false, null | Predeterminado— |
Parámetros del método y ciclo de vida
| Parámetro | Contrato |
|---|---|
Parámetrocontent_type | Contratoapplication/json |
Parámetrorequired | Contratoendpoint, model, requests |
Parámetromaterial_types | Contratotext |
Parámetrorepresentation | Contratorequests[] en línea; cada elemento tiene custom_id y body |
Parámetrorequest_endpoint_profile | Contrato/v1/chat/completions |
Parámetrofile_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ámetroserialization_order | Contratoendpoint, model, provider (si se proporciona), completion_window (si se proporciona), requests al final |
Parámetrooptional_controls | Contratoprovider.only, provider.allow_fallbacks, completion_window |
Parámetroschema_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.00075 / 1K tokens Salida · Tokens de salida $0.00375 / 1K tokens Entrada · Lectura de caché $0.000075 / 1K tokens Entrada · Escritura en caché $0.0000833333333333334 / 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 inclusiveSin límite superior | Cargo Entrada · Tokens de entrada $0.00075 / 1K tokens Salida · Tokens de salida $0.00375 / 1K tokens Entrada · Lectura de caché $0.000075 / 1K tokens Entrada · Escritura en caché $0.0000833333333333334 / 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 →
Solicitudes de ejemplo
Ailoot Ultra · Batch
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.8-flash: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.8-flash:batch', 'google/gemini-3.8-flash']: raise ValueError("body.model must be an exact documented caller or wire ID")
return {"endpoint":"/v1/chat/completions", "model":"google/gemini-3.8-flash: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 · Batch
JSON de results[].response.body en línea
GET /v1/batches/{operation_id}
Consultar el estado de la tarea
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 |
|---|---|
Camporesults[].custom_id | Tipostring |
Camporesults[].response.body.choices[].message.content | Tipostring|null |
Camporesults[].error | Tipoobject|null |
Campousage | Tipoobject|null |
Campoid | Tipostring |
Campomodel | Tipostring |
Campoendpoint | Tipostring |
Campostatus | Tipostring |
Camporequest_counts | Tipoobject |
Camporesults[].id | Tipostring |
Camporesults[].response.status_code | Tipointeger |
Camporesults[].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.8-flash:batch
Alias de rutas de métodos
Usa las rutas de método indicadas arriba.
ID de modelo relacionados
FAQ · Google: Gemini 3.8 Flash (batch)
- ¿Qué entradas y resultados están disponibles?
POST /v1/batches·google/gemini-3.8-flash:batch:text→text- ¿Qué campos utiliza la solicitud?
POST /v1/batches·google/gemini-3.8-flash:batch:endpoint,model,requests,completion_window,provider- ¿Qué límites se aplican?
POST /v1/batches·google/gemini-3.8-flash:batch:requests.min_items:1