Source: https://ailoot.ai/models/es-mx/google-gemini-3-1-flash-image-preview/ Canonical: https://ailoot.ai/models/es-mx/google-gemini-3-1-flash-image-preview/ Language: es-mx # Google: Nano Banana 2 (Gemini 3.1 Flash Image Preview) [Markdown](https://ailoot.ai/models/es-mx/google-gemini-3-1-flash-image-preview/index.md) · [JSON](https://ailoot.ai/models/es-mx/google-gemini-3-1-flash-image-preview/facts.json) ## [Google: Nano Banana 2 (Gemini 3.1 Flash Image Preview)](https://ailoot.ai/models/es-mx/google-gemini-3-1-flash-image-preview/) Nano Banana 2 (Gemini 3.1 Flash Image Preview) crea y edita imágenes a partir de texto y referencias visuales. Sus fortalezas documentadas incluyen consistencia del sujeto, texto dentro de la imagen y localización, cambios conversacionales y control creativo de composición, relación de aspecto y resolución. - [**Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` `google/gemini-3.1-flash-image-preview`](https://ailoot.ai/models/es-mx/google-gemini-3-1-flash-image-preview/#method-0) - [**Ailoot Ultra · Imágenes** `POST /v1/images/generations` `google/gemini-3.1-flash-image-preview`](https://ailoot.ai/models/es-mx/google-gemini-3-1-flash-image-preview/#method-1) - [**Ailoot Ultra · Anthropic Messages** `POST /v1/messages` `google/gemini-3.1-flash-image-preview`](https://ailoot.ai/models/es-mx/google-gemini-3-1-flash-image-preview/#method-2) 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. Nano Banana 2 es el modelo Gemini 3.1 Flash Image de Google para generación de imágenes y edición conversacional. Esta entrada conserva la identidad exacta Preview. Una descripción escrita puede definir un nuevo elemento visual, mientras que una imagen de entrada puede establecer el sujeto, la apariencia o la composición que deben modificarse. El resultado puede contener una imagen y texto acompañante. El material de lanzamiento de Google enfatiza el conocimiento del mundo, la representación de texto y la consistencia del sujeto, junto con la capacidad de refinar una escena mediante turnos relacionados. Para creación visual fundamentada, el modelo documentado puede utilizar información de búsquedas web y de imágenes para orientar la generación. Esto respalda tareas como una ilustración inspirada en un lugar o un diagrama basado en información proporcionada. Define los hechos de origen que deben representarse y distingue esos hechos de las decisiones artísticas. La generación apoyada en búsquedas no convierte cada detalle de la imagen final en una afirmación verificada. Si un producto, un monumento o un diagrama debe ser exacto, proporciona una referencia de una fuente autorizada y examina la salida frente a ella. El lanzamiento describe mejoras en representación de texto dentro de imágenes y localización. Para un póster, una infografía o una maqueta de marketing, proporciona la redacción exacta, el idioma y la función de cada elemento textual. Define primero el texto y después solicita el elemento visual que lo contenga, como recomienda la guía de imágenes. Explica el orden de lectura y el énfasis relativo para que no se confundan encabezado, leyenda y etiqueta de diagrama. Revisa ortografía, puntuación y la conexión entre una etiqueta y el elemento ilustrado antes de usar la imagen en una publicación. Los controles creativos incluyen relación de aspecto y resolución. El lanzamiento agrega salida de 512 píxeles junto con opciones de 1K, 2K y 4K, y relaciones de aspecto de 4:1, 1:4, 8:1 y 1:8. La guía para desarrolladores identifica el pensamiento mínimo como predeterminado y el pensamiento alto como opción para composiciones más elaboradas. Elige el uso previsto antes de la composición: una historia vertical, un banner ancho y un diagrama compacto necesitan espacios diferentes para el sujeto y cualquier texto. Estos ajustes describen el flujo de generación del fabricante para esta línea, no un redimensionamiento automático de un recurso existente terminado. Para consistencia del sujeto, etiqueta la función de cada referencia: apariencia del producto, identidad del personaje, fondo o estilo visual. Indica los detalles que deben conservarse y después nombra los elementos que deben cambiar. Una tarea original podría colocar una fotografía de producto proporcionada en una escena nueva conservando su forma, material y marca visible. Para una secuencia ilustrada, conserva las mismas referencias y define qué detalles específicos de escena varían. Más referencias no sustituyen una instrucción clara sobre lo que aporta cada imagen. La edición conversacional es útil para una revisión específica. Pide ajustar un objeto, un fondo o la iluminación conservando la composición aceptada. La guía del fabricante describe el enmascaramiento semántico, donde el área editada se identifica con palabras. Para trabajo de varios turnos, conserva la conversación y los metadatos requeridos de contexto de razonamiento en la interfaz elegida; la guía de Gemini 3 explica que las firmas de pensamiento ayudan a llevar ese contexto. Una descripción de una región sin cambios es una instrucción que debe revisarse frente al original, no una garantía de que cada píxel permanezca idéntico. La tabla para desarrolladores de Gemini 3 nombra explícitamente gemini-3.1-flash-image-preview con una capacidad de entrada de 128K y de salida de 32K. Conserva el nombre exacto Preview del modelo al registrar una generación. Los ajustes disponibles de referencias, salida y resolución deben conservarse con las imágenes de origen y la solicitud para poder reproducir una revisión de forma consistente. Para una revisión, conserva las mismas referencias de origen y especifica el cambio visual exacto, preservando la función aceptada de cada entrada. La guía de imágenes advierte que el número solicitado de imágenes no siempre se respeta e identifica la marca SynthID para imágenes generadas. Revisa todas las imágenes devueltas y cualquier texto acompañante, en lugar de suponer que el resultado es una sola imagen fija. Examina la identidad del sujeto, la cantidad de objetos, el texto dentro de la imagen, la composición y la fidelidad a las referencias al tamaño de visualización previsto. Para una escena compleja, especifica los componentes en un orden lógico y describe positivamente la apariencia deseada. El resultado útil es un recurso visual revisado con sus referencias de origen e identidad exacta de modelo conservadas para la siguiente edición. Tarea práctica ### Tarea práctica Ejemplo técnico en inglés ``` Create a four-stage growing guide Create a friendly flat illustration for a gardening guide showing four tomato-growing stages from left to right: seed in soil, small seedling, leafy plant, mature plant with red tomatoes. Use a warm cream background, consistent pots and simple green shapes. Keep each stage clearly separated. Include no text, numbers, labels or decorative extra plants. ``` #### Resultado esperado ``` An image with four distinct growing stages in the specified order and a consistent illustration style. ``` #### Comprobar el resultado ``` Inspect the actual image for exactly four stages, the left-to-right progression and absence of text or extra plants. ``` **Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` `google/gemini-3.1-flash-image-preview` [`google/gemini-3.1-flash-image-preview`](https://ailoot.ai/models/es-mx/#m=google%2Fgemini-3.1-flash-image-preview&route=Ultra&caller=google%2Fgemini-3.1-flash-image-preview&fmt=chat) Google /`google/gemini-3.1-flash-image-preview` ### Inicio Nano Banana 2 (Gemini 3.1 Flash Image Preview) crea y edita imágenes a partir de texto y referencias visuales. Sus fortalezas documentadas incluyen consistencia del sujeto, texto dentro de la imagen y localización, cambios conversacionales y control creativo de composición, relación de aspecto y resolución. Entradas aceptadas Texto Resultados Texto ### Disponible en Ailoot · entradas y métodos **Ailoot Ultra · OpenAI Chat** `POST /v1/chat/completions` Entrada `text` Salida `text` Formato de salida json o SSE | Campo | Tipo | Requisito | Valores y límites | Predeterminado | | --- | --- | --- | --- | --- | | Campo`model` | Tipo`string` | RequisitoObligatorio | Valores y límites google/gemini-3.1-flash-image-preview | Predeterminado— | | Campo`messages` | Tipo`message[]` | RequisitoObligatorio | Valores y límites Número mínimo de elementos: 1 | Predeterminado— | | Campo`messages[].role` | Tipo`string` | RequisitoObligatorio | Valores y límites Ejemplos: system, user, assistant, tool, function Condiciones: Estos roles están representados explícitamente por los tipos de compatibilidad del código fuente; el conjunto exacto de roles depende del modelo. Depende del modelo | Predeterminado— | | Campo`messages[].content` | Tipo`string\|content_part[]\|null` | RequisitoOpcional | Valores y límites | Predeterminado— | | Campo`messages[].tool_calls` | Tipo`tool_call[]` | RequisitoOpcional | Valores y límites | Predeterminado— | | Campo`messages[].tool_call_id` | Tipo`string` | RequisitoOpcional | Valores y límites Se aplica cuando: role=tool; utiliza el ID real devuelto | Predeterminado— | | Campo`messages[].name` | Tipo`string` | RequisitoOpcional | Valores y límites | Predeterminado— | | Campo`messages[].reasoning_content` | Tipo`string` | RequisitoOpcional | Valores y límites Se aplica cuando: Devuelve en los turnos siguientes el razonamiento realmente recibido cuando este modelo lo utilice | Predeterminado— | | Campo`messages[].reasoning_details` | Tipo`object\|array` | RequisitoOpcional | Valores y límites Depende del modelo | Predeterminado— | | Campo`max_tokens` | Tipo`integer` | RequisitoOpcional | Valores y límites Mínimo: 1 Depende del modelo | Predeterminado— | | Campo`max_completion_tokens` | Tipo`integer` | RequisitoOpcional | Valores y límites Mínimo: 1 Depende del modelo | Predeterminado— | | Campo`stream` | Tipo`boolean` | RequisitoOpcional | Valores y límites | Predeterminadofalse | | Campo`stream_options.include_usage` | Tipo`boolean` | RequisitoOpcional | Valores y límites Depende del modelo | Predeterminado— | | Campo`temperature` | Tipo`number` | RequisitoOpcional | Valores y límites Depende del modelo | Predeterminado— | | Campo`top_p` | Tipo`number` | RequisitoOpcional | Valores y límites Depende del modelo | Predeterminado— | | Campo`stop` | Tipo`string\|string[]` | RequisitoOpcional | Valores y límites Depende del modelo | Predeterminado— | | Campo`tools` | Tipo`function_tool[]` | RequisitoOpcional | Valores y límites Depende del modelo | Predeterminado— | | Campo`tools[].type` | Tipo`string` | RequisitoOpcional | Valores y límites function Depende del modelo | Predeterminado— | | Campo`tools[].function.name` | Tipo`string` | RequisitoObligatorio | Valores y límites Se aplica cuando: herramienta de función proporcionada | Predeterminado— | | Campo`tools[].function.description` | Tipo`string` | RequisitoOpcional | Valores y límites | Predeterminado— | | Campo`tools[].function.parameters` | Tipo`JSON_schema` | RequisitoOpcional | Valores y límites | Predeterminado— | | Campo`tool_choice` | Tipo`string\|object` | RequisitoOpcional | Valores y límites Depende del modelo | Predeterminado— | | Campo`parallel_tool_calls` | Tipo`boolean` | RequisitoOpcional | Valores y límites Depende del modelo | Predeterminado— | | Campo`response_format` | Tipo`object` | RequisitoOpcional | Valores y límites Depende del modelo | Predeterminado— | | Campo`reasoning_effort` | Tipo`string` | RequisitoOpcional | Valores y límites Depende del modelo | Predeterminado— | | Campo`reasoning` | Tipo`object` | RequisitoOpcional | Valores y límites Depende del modelo | Predeterminado— | | Campo`service_tier` | Tipo`string` | RequisitoOpcional | Valores y límites Depende del modelo | Predeterminado— | | Campo`instructions` | Tipo`string` | RequisitoOpcional | Valores y límites Campo de compatibilidad | Predeterminado— | | Campo`functions` | Tipo`function[]` | RequisitoOpcional | Valores y límites Depende del modelo | Predeterminado— | | Campo`function_call` | Tipo`string\|object` | RequisitoOpcional | Valores y límites Depende del modelo | Predeterminado— | | Campo`prompt_cache_options` | Tipo`object` | RequisitoOpcional | Valores y límites Depende del modelo | Predeterminado— | | Campo`modalities` | Tipo`string[]` | RequisitoOpcional | Valores y límites text | Predeterminado— | | Campo`provider` | Tipo`object` | RequisitoOpcional | Valores y límites Condiciones: provider.options se rechaza en esta ruta de texto Ultra | Predeterminado— | | Campo`cache_control.ttl` | Tipo`string` | RequisitoOpcional | Valores y límites Condiciones: 1h se rechaza en los campos reales de caché de instrucciones | Predeterminado— | Combinaciones de materiales de entrada **Texto** · Texto UTF8 `messages[].content` Parámetros del método y ciclo de vida | Parámetro | Contrato | | --- | --- | | Parámetro`content_type` | Contratoapplication/json | | Parámetro`required` | Contratomodel, messages | | Parámetro`material_types` | Contratotext | | Parámetro`messages` | Contratomatriz de mensajes con estructura role/content | | Parámetro`file_material` | Contratodocumento real en UTF-8 insertado como texto literal; no se deduce ningún ID de archivo | | Parámetro`optional_controls` | Contratostream, temperature, top\_p, stop, max\_tokens, max\_completion\_tokens, reasoning, response\_format, tools, tool\_choice | | Parámetro`control_scope` | Contratodepende del modelo; las herramientas de funciones del usuario difieren de las herramientas alojadas | | Parámetro`output_modalities` | Contratotext | | Parámetro`hosted_operations` | Contratofalse | | Parámetro`multimodal_input_binding` | Contratonull | Ciclo de vida: `synchronous_or_streamed` Envía el ID exacto del modelo junto con messages. La longitud del contexto no es un límite máximo de salida. Un archivo de texto puede aportar texto literal; las entradas de imagen, audio u objetos de archivo requieren una vinculación exacta. ### Tarifas Las referencias tarifarias no añaden opciones a la solicitud. Los parámetros admitidos se indican en el método seleccionado. Modo fast Tarifa estándar Cuando se selecciona el modo fast Modo flex Tarifa estándar Cuando se selecciona el modo flex Esfuerzo máximo de razonamiento Tarifa estándar Cuando el esfuerzo máximo de razonamiento usa el ajuste default Esfuerzo de razonamiento · high Tarifa estándar Cuando el esfuerzo de razonamiento está configurado en high Esfuerzo de razonamiento · minimal Tarifa estándar Cuando el esfuerzo de razonamiento está configurado en minimal 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.001** / 1K tokens Salida · Tokens de salida **$0.006** / 1K tokens Entrada · Lectura de caché **—** / 1K tokens Entrada · Escritura en caché **—** / 1K tokens Entrada · Escritura en caché, 1 hora **—** / 1K tokens Salida · Tokens de salida de imagen **$0.12** / 1K tokens de imagen | | 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.001** / 1K tokens Salida · Tokens de salida **$0.006** / 1K tokens Entrada · Lectura de caché **—** / 1K tokens Entrada · Escritura en caché **—** / 1K tokens Entrada · Escritura en caché, 1 hora **—** / 1K tokens | #### Detalles de la tarifa de referencia Las tablas de referencia del modelo no cambian la selección del método, las cotizaciones ni los cargos. Los cargos aplicados usan las tarifas del método Ailoot seleccionado. google/gemini-3.1-flash-image-preview #### Precios por configuración | Configuración | Condiciones de facturación | Cargo | | --- | --- | --- | | Configuracióngoogle/gemini-3.1-flash-image-preview · Configuración predeterminada | Condiciones de facturaciónConfiguración predeterminada | Cargo Entrada · Entrada **USD 0.001** / 1K tokens Salida · Salida **USD 0.12** / 1K tokens | google/gemini-3.1-flash-image-preview #### Precios por configuración | Configuración | Condiciones de facturación | Cargo | | --- | --- | --- | | Configuracióngoogle/gemini-3.1-flash-image-preview · Configuración predeterminada | Condiciones de facturaciónConfiguración predeterminada | Cargo Entrada · Entrada **USD 0.001** / 1K tokens Salida · Salida **USD 0.12** / 1K tokens | google/gemini-3.1-flash-image-preview #### Precios por configuración | Configuración | Condiciones de facturación | Cargo | | --- | --- | --- | | Configuracióngoogle/gemini-3.1-flash-image-preview · Configuración predeterminada | Condiciones de facturaciónConfiguración predeterminada | Cargo Entrada · Entrada **USD 0.00** por llamada Salida · Salida **USD 0.16** por llamada | google/gemini-3.1-flash-image-preview #### Precios por configuración | Configuración | Condiciones de facturación | Cargo | | --- | --- | --- | | Configuracióngoogle/gemini-3.1-flash-image-preview · Configuración predeterminada | Condiciones de facturaciónConfiguración predeterminada | Cargo Entrada · Entrada **USD 0.00** por llamada Salida · Salida **USD 0.32** por llamada | google/gemini-3.1-flash-image-preview #### Precios por configuración | Configuración | Condiciones de facturación | Cargo | | --- | --- | --- | | Configuracióngoogle/gemini-3.1-flash-image-preview · Configuración predeterminada | Condiciones de facturaciónConfiguración predeterminada | Cargo Entrada · Entrada **USD 0.00** por llamada Salida · Salida **USD 0.00** por llamada | Google: Nano Banana 2 (Gemini 3.1 Flash Image Preview) #### Precios por configuración | Configuración | Condiciones de facturación | Cargo | | --- | --- | --- | | ConfiguraciónGoogle: Nano Banana 2 (Gemini 3.1 Flash Image Preview) · Configuración predeterminada | Condiciones de facturaciónConfiguración predeterminada | Cargo Entrada · Tokens de entrada **USD 0.001** / 1K tokens Salida · Tokens de salida **USD 0.006** / 1K tokens Salida · Imagen de salida **USD 0.12** / 1K tokens Salida · Búsqueda web **USD 0.028** por búsqueda | 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 · OpenAI Chat curlPython SDKFlujo en Python ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" python3 - <<'PY_REQUEST' import json,os from pathlib import Path p=json.loads('{"model": "google/gemini-3.1-flash-image-preview", "messages": [{"role": "user", "content": "Explain the difference between an observation and a hypothesis in three sentences."}]}') Path("request.json").write_text(json.dumps(p,ensure_ascii=False)) PY_REQUEST curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/chat/completions \ -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \ --data-binary @request.json -D response-headers.txt -o result.json python3 - <<'PY_RESULT' import json from pathlib import Path r=json.loads(Path("result.json").read_text()) for x in r.get("choices",[]): if x.get("message",{}).get("content"): print(x["message"]["content"]) PY_RESULT ``` ```python from openai import OpenAI import os if not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request") client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0) result=client.chat.completions.create(model='google/gemini-3.1-flash-image-preview',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}]) import base64, json from pathlib import Path def save_result(data, stem="result"): # Keep every field, including usage, IDs, reasoning and tool requests. Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8") print(json.dumps(data, ensure_ascii=False, indent=2)) def save_blob(encoded, suffix, label): raw = base64.b64decode(encoded, altchars=b"-_", validate=True) ext = "png" if raw.startswith(b"\x89PNG\r\n\x1a\n") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else suffix file = Path(stem + "-" + label + "." + ext) file.write_bytes(raw) print("Saved", file) for index, block in enumerate(data.get("content") or []): print("Content", index, json.dumps(block, ensure_ascii=False)) for choice in data.get("choices") or []: print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False)) for index, item in enumerate(data.get("output") or []): print("Output", index, json.dumps(item, ensure_ascii=False)) if item.get("type") == "image_generation_call" and item.get("result"): save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index)) for ci, candidate in enumerate(data.get("candidates") or []): for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []): print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False)) blob = part.get("inlineData") or part.get("inline_data") if blob and blob.get("data"): mime = blob.get("mimeType") or blob.get("mime_type") suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin") save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi)) save_result(result.to_dict(mode="json")) ``` ```python from openai import OpenAI import os from pathlib import Path if not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request") client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0) import base64, json from pathlib import Path def save_result(data, stem="result"): # Keep every field, including usage, IDs, reasoning and tool requests. Path(stem + ".json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8") print(json.dumps(data, ensure_ascii=False, indent=2)) def save_blob(encoded, suffix, label): raw = base64.b64decode(encoded, altchars=b"-_", validate=True) ext = "png" if raw.startswith(b"\x89PNG\r\n\x1a\n") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4] == b"RIFF" and raw[8:12] == b"WEBP" else suffix file = Path(stem + "-" + label + "." + ext) file.write_bytes(raw) print("Saved", file) for index, block in enumerate(data.get("content") or []): print("Content", index, json.dumps(block, ensure_ascii=False)) for choice in data.get("choices") or []: print("Choice", choice.get("index"), json.dumps(choice.get("message", choice.get("delta", {})), ensure_ascii=False)) for index, item in enumerate(data.get("output") or []): print("Output", index, json.dumps(item, ensure_ascii=False)) if item.get("type") == "image_generation_call" and item.get("result"): save_blob(item["result"], item.get("output_format") or "bin", "output-" + str(index)) for ci, candidate in enumerate(data.get("candidates") or []): for pi, part in enumerate((candidate.get("content") or {}).get("parts") or []): print("Candidate/part", ci, pi, json.dumps(part, ensure_ascii=False)) blob = part.get("inlineData") or part.get("inline_data") if blob and blob.get("data"): mime = blob.get("mimeType") or blob.get("mime_type") suffix = {"image/png":"png", "image/jpeg":"jpg", "image/webp":"webp", "audio/wav":"wav", "audio/mpeg":"mp3", "video/mp4":"mp4"}.get(mime, "bin") save_blob(blob["data"], suffix, "candidate-" + str(ci) + "-part-" + str(pi)) with client.chat.completions.stream(model='google/gemini-3.1-flash-image-preview',messages=[{"role":"user","content":"Explain observations and hypotheses in three sentences."}]) as stream: with Path("stream-events.jsonl").open("w",encoding="utf-8") as log: for event in stream: payload=event.to_dict(mode="json") log.write(json.dumps(payload,ensure_ascii=False)+"\n"); log.flush() print(json.dumps(payload,ensure_ascii=False)) final=stream.get_final_completion() save_result(final.to_dict(mode="json"),"stream-result") ``` ### Recibir y guardar resultados #### Ailoot Ultra · OpenAI Chat json o SSE ##### Conserva todos los resultados completados Conserva todas las respuestas, archivos y partes de contenido completos recibidos. Conserva cada alternativa y su contenido, llamadas de herramientas y razonamiento. En SSE, ensambla los fragmentos incrementales por índice de alternativa/herramienta y conserva el motivo final de terminación y el uso. ##### Si es necesario revisar la respuesta original Conserva los ID de solicitud y respuesta y los encabezados. No se proporciona una URL genérica para recuperar tareas de texto. Campos de respuesta | Campo | Tipo | | --- | --- | | Campo`choices[].index` | Tipointeger | | Campo`choices[].message.content` | Tipostring\|null | | Campo`choices[].message.tool_calls` | Tipotool\_call\[\] | | Campo`choices[].message.reasoning_content` | Tipostring | | Campo`choices[].message.reasoning_details` | Tipoobject\|array | | Campo`choices[].finish_reason` | Tipostring\|null | | Campo`usage` | Tipoobject | Errores y siguientes pasos | Respuesta | Condición | Siguiente paso | | --- | --- | --- | | Respuesta400 · `invalid_request_error` | CondiciónCampos obligatorios, representación del material o valor del parámetro no válidos | Siguiente pasoCorrige los campos indicados antes de una nueva solicitud de creación. | ### Alias #### Alias del modelo **Ailoot Ultra** [`google/gemini-3.1-flash-image-preview`](https://ailoot.ai/models/es-mx/#m=google%2Fgemini-3.1-flash-image-preview&route=Ultra&caller=google%2Fgemini-3.1-flash-image-preview&fmt=chat) #### Alias de rutas de métodos `/v1/images` #### ID de modelo relacionados [`google/gemini-3.1-flash-image-preview`](https://ailoot.ai/models/es-mx/#m=google%2Fgemini-3.1-flash-image-preview&route=Ultra&caller=google%2Fgemini-3.1-flash-image-preview&fmt=chat) **Ailoot Ultra · Imágenes** `POST /v1/images/generations` `google/gemini-3.1-flash-image-preview` [`google/gemini-3.1-flash-image-preview`](https://ailoot.ai/models/es-mx/#m=google%2Fgemini-3.1-flash-image-preview&route=Ultra&caller=google%2Fgemini-3.1-flash-image-preview&fmt=images) Google /`google/gemini-3.1-flash-image-preview` ### Inicio Nano Banana 2 (Gemini 3.1 Flash Image Preview) crea y edita imágenes a partir de texto y referencias visuales. Sus fortalezas documentadas incluyen consistencia del sujeto, texto dentro de la imagen y localización, cambios conversacionales y control creativo de composición, relación de aspecto y resolución. Entradas aceptadas Texto · Imágenes Resultados Imágenes ### Disponible en Ailoot · entradas y métodos **Ailoot Ultra · Imágenes** `POST /v1/images/generations` Entrada `text`, `image` Salida `image` | Campo | Tipo | Requisito | Valores y límites | Predeterminado | | --- | --- | --- | --- | --- | | Campo`model` | Tipo`string` | RequisitoObligatorio | Valores y límites google/gemini-3.1-flash-image-preview | Predeterminado— | | Campo`prompt` | Tipo`string` | RequisitoObligatorio | Valores y límites Longitud mínima: 1 | Predeterminado— | | Campo`resolution` | Tipo`string` | RequisitoOpcional | Valores y límites 512, 1K, 2K, 4K | Predeterminado— | | Campo`aspect_ratio` | Tipo`string` | RequisitoOpcional | Valores y límites 1:1, 1:4, 1:8, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9 | Predeterminado— | | Campo`n` | Tipo`integer` | RequisitoOpcional | Valores y límites Mínimo: 1 Máximo: 1 | Predeterminado— | | Campo`input_references` | Tipo`array` | RequisitoOpcional | Valores y límites Número mínimo de elementos: 0 Número máximo de elementos: 14 | Predeterminado— | | Campo`provider` | Tipo`object` | RequisitoOpcional | Valores y límites | Predeterminado— | Parámetros del método y ciclo de vida | Parámetro | Contrato | | --- | --- | | Parámetro`content_type` | Contratoapplication/json | | Parámetro`required` | Contratomodel, prompt | | Parámetro`material_types` | Contratotext, image | Ciclo de vida: `synchronous_result_then_owned_library` `GET /v1/media/tasks/{task_id}` · El task\_id real devuelto o el registro de la biblioteca multimedia `GET /v1/media/assets/{asset_id}/content` `GET /v1/media/assets` `GET /v1/media/assets/{asset_id}` ### Tarifas ##### Cómo se calcula el cargo definitivo Las tarifas mostradas permiten estimar el costo antes de la generación. El cargo final se calcula a partir del costo registrado para la generación original. La duración medida de la salida y las cantidades estimadas no son la cantidad facturable final. 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 #### Tarifas estimadas para comparar #### 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 | Cantidad prevista | Cargo | | --- | --- | --- | --- | | ConfiguraciónTarifas base por token | Tabla de tarifasTarifa base | Cantidad prevista— | Cargo Entrada · Tokens de entrada · Estimación solo para comparar **—** / 1K tokens Salida · Tokens de salida · Estimación solo para comparar **—** / 1K tokens Entrada · Lectura de caché · Estimación solo para comparar **—** / 1K tokens Entrada · Escritura en caché · Estimación solo para comparar **—** / 1K tokens Entrada · Escritura en caché, 1 hora · Estimación solo para comparar **—** / 1K tokens | | ConfiguraciónCosto estimado de generación | Tabla de tarifas— | Cantidad previstaestimación para una generación | Cargo Salida · Costo estimado de generación · Estimación solo para comparar **$0.49152** estimación previa a la generación Esta estimación no es un cargo adicional ni una tarifa fija por la generación completada. | 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 · Imágenes curl ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" export AILOOT_API_KEY python3 - <<'PY_REQUEST' import json,os from pathlib import Path p={'model': 'google/gemini-3.1-flash-image-preview', 'prompt': 'a red panda astronaut floating in space, studio lighting'} Path("request.json").write_text(json.dumps(p,ensure_ascii=False)) PY_REQUEST curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \ -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \ --data-binary @request.json -D response-headers.txt -o result.json python3 - <<'PY_RESULT' import base64, json, os, subprocess from pathlib import Path from urllib.parse import urlsplit, urljoin def save_images(items): if not items: raise SystemExit("No completed images; retain the full response") for index, item in enumerate(items): encoded=item.get("b64_json") uri=item.get("url", "") if not encoded and uri.startswith("data:image/"): header, separator, encoded=uri.partition(",") if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI") if encoded: raw=base64.b64decode(encoded,validate=True) elif uri: uri=urljoin("https://api.ailoot.ai",uri) parsed=urlsplit(uri) if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password: raise SystemExit("Invalid returned image URL") owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content") args=["curl","--fail-with-body","--silent","--show-error",uri] if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]] temporary=Path(f"image-{index}.bin") subprocess.run(args+["-o",str(temporary)],check=True) raw=temporary.read_bytes() temporary.unlink() else: raise SystemExit("Image has neither bytes nor URL") if not raw: raise SystemExit("Empty image result") ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"