gemini-3.1-flash-image API de imágenes con IA
gemini-3.1-flash-image (Nano Banana 2): Genera imágenes, edita con referencias e itera diseños mediante Flatkey. El ejemplo usa contents/parts de Gemini, no un cuerpo intercambiable de Images API.
Salida
Vista previa
Generado con Image 2
Resumen de la solicitud
- Punto de conexión
- POST /v1beta/models/gemini-3.1-flash-image:generateContent
- ID del modelo
- gemini-3.1-flash-image
- Relación de aspecto
- 16:9
- Resolución
- 1K
Solo vista previa. Inicia sesión para enviar esta solicitud a Flatkey.
{
"model": "gemini-3.1-flash-image",
"contents": [
{
"role": "user",
"parts": [
{
"text": "Scene: A cloaked figure crouches on a rain-slick elevated walkway beneath massive futuristic bridges. Cyan fog, magenta tower lights, railings, and wet reflections lead toward the distant city. Hold the figure's silhouette, facing direction, cloak edge, camera height, and neon light placement as a cinematic storyboard keyframe. No readable signs, logos, or watermark.\n\nComposition and rendering: Deliver one 16:9 storyboard keyframe, not a collage or an action sequence. Separate foreground, character plane and background through the existing light and atmospheric depth. Keep the stated pose and eyelines readable, and retain environmental landmarks for continuity. Match the described photographic, illustrated or puppet medium; give fabric and surfaces texture appropriate to that medium.\n\nAvoid: warped perspective, malformed anatomy, merged objects, inconsistent shadows, excessive sharpening and watermarks. Follow the scene-specific text and branding restrictions above."
}
]
}
],
"generationConfig": {
"responseModalities": [
"TEXT",
"IMAGE"
],
"imageConfig": {
"aspectRatio": "16:9",
"imageSize": "1K"
}
}
}Rendimiento de la API
gemini-3.1-flash-image Fiabilidad y disponibilidad de la API
Aquí aparecerá la telemetría de solicitudes de Flatkey para gemini-3.1-flash-image cuando haya suficiente tráfico de producción.
Actividad de la API
gemini-3.1-flash-image Uso y actividad de solicitudes de la API
Consulta el volumen de solicitudes y la actividad de inferencia correcta de gemini-3.1-flash-image durante el último periodo informado.
gemini-3.1-flash-image precios
gemini-3.1-flash-image Precios y facturación de la API
Las tarjetas muestran las tarifas actuales de tokens de entrada y salida de Flatkey. Una tarifa por token no es un precio fijo por imagen: los ajustes, referencias y resultados afectan al consumo. Las tarifas y cuotas gratuitas directas de Google no se aplican automáticamente.
Añadir crédito
Usa el mismo saldo y la misma clave API de Flatkey para modelos de imagen, vídeo, audio y texto.
- Tipo de modelo
- Texto a imagen
- API
- /v1beta/models/gemini-3.1-flash-image:generateContent
- Base de facturación
- 1M tokens
- Salidas
- 1
gemini-3.1-flash-image generador de imágenes IA y API: capacidades principales
La ruta de gemini-3.1-flash-image de Google admite texto · imagen. Categorías del catálogo: Marketing.
Texto a imagen
Describe sujeto, composición, luz y texto. Configura los controles de salida en los campos de la solicitud, no solo en el prompt.
Imagen de referencia
Añade referencias e indica qué conservar y modificar. Respeta los límites de referencias de la matriz de parámetros.
Salidas
Elige únicamente proporciones y tamaños disponibles en el Playground. Flash, Flash Lite y Pro tienen límites distintos.
API
Conserva el ID exacto y la estructura contents/parts del ejemplo. Prueba una solicitud pequeña antes de procesar lotes.
Comparar
gemini-3.1-flash-image Comparación de API: capacidades y acceso
Compara los datos de catálogo de gemini-3.1-flash-image con la referencia de la generación anterior antes de cambiar la integración.
| Capacidad | Generación anterior | gemini-3.1-flash-image |
|---|---|---|
| Proveedor | No verificado en esta instantánea del catálogo | |
| Modalidades | No verificado en esta instantánea del catálogo | texto · imagen |
| Contexto | No verificado en esta instantánea del catálogo | El catálogo no indica la ventana de contexto |
| Punto de conexión | No verificado en esta instantánea del catálogo | /v1beta/models/gemini-3.1-flash-image:generateContent |
| Facturación | No verificado en esta instantánea del catálogo | $0.5/$3 per 1M tokens |
Elige la solicitud correcta antes de integrar
Revisa los flujos compatibles, el coste actual y el contrato exacto de parámetros de Flatkey.
Se calcula con la configuración actual y la tarifa del catálogo cuando existe un precio unitario fijo.
- Configuración actual
- 1×
- Tarifa en vivo
- $0.06
- Solicitud estimada
- Precio según uso
El cargo final depende de la solicitud enviada y del grupo de cuenta; los precios por tokens o niveles no admiten una cifra fija.
Flujos y Model ID
Usa solo los flujos disponibles. Flatkey mantiene un ID público y el cuerpo elige el tipo de entrada.
Texto a imagen
Genera una imagen desde texto.
- ID del modelo
gemini-3.1-flash-image- Endpoint
/v1beta/models/gemini-3.1-flash-image:generateContent
Imagen guiada por referencia
Usa referencias para editar o crear variaciones.
- ID del modelo
gemini-3.1-flash-image- Endpoint
/v1beta/models/gemini-3.1-flash-image:generateContent
Compatibilidad de parámetros
Valores procedentes de la misma configuración usada por Playground.
aspect_ratioRelación de aspecto1:1 · 2:3 · 3:2 · 3:4 · 4:3 · 4:5 · 5:4 · 9:16 · 16:9 · 21:9
Predeterminado: 1:1image_sizeTamaño1K · 2K · 4K
Predeterminado: 1KimageLímite de referencias4 archivos
Endpoint: /v1beta/models/gemini-3.1-flash-image:generateContentDe la primera prueba a producción
Usa el mismo contrato en Playground y API y trata explícitamente validación, saldo, estado y resultados.
Ciclo de la solicitud
- 1
Validar modelo, prompt, referencias y salida.
- 2
Enviar la solicitud de imagen.
- 3
Leer el resultado generado o la tarea asíncrona.
- 4
Guardar archivo y metadatos.
Controles de producción
Bloquea valores o referencias no admitidos antes del envío.
Trata claves, saldo, límites y precios de grupo por separado.
Identifica el prompt o recurso que debe sustituirse.
Conserva el task ID, limita reintentos y no marques un timeout como éxito.
Biblioteca de prompts
Ejemplos de prompts de gemini-3.1-flash-image para generación de imágenes
Empieza con un prompt de gemini-3.1-flash-image para generación de imágenes y ajusta los campos de solicitud que muestra el playground.
Generado con Image 2
Scene: A 16:9 futuristic game loadout frame shows a helmeted rider beside a black-and-orange motorcycle in a rainy industrial hangar. Blue-and-orange interface controls and a circular part-selection panel sit around the vehicle. Keep the rider, motorcycle geometry, wet floor reflections, lighting direction, and selected-part position fixed for a clean equipment swap. No readable words, logos, invented stats, or watermark. Composition and rendering: Deliver one 16:9 game-interface keyframe. Separate the character, held equipment and HUD into clear depth layers; keep slot spacing and icon scale consistent, with the selected item visually dominant. Preserve the scene-specific game art style. Let material edges catch the existing light without letting interface glow obscure the silhouette. Keep all equipment fully inside the frame. Avoid: warped perspective, malformed anatomy, merged objects, inconsistent shadows, excessive sharpening and watermarks. Follow the scene-specific text and branding restrictions above.
Scene: A poolside sports broadcast catches a swimmer in a blue cap during freestyle, with one arm entering the water and a sharp splash across the lane. Use a low pool-deck camera, blue water, lane markings, and abstract blue lower-third graphics without readable text. Keep swimmer direction, splash shape, and framing consistent; no real athletes, teams, logos, or watermark. Composition and rendering: Deliver one 16:9 broadcast still at the decisive instant. Use coherent perspective for the playing surface and equipment, readable separation between competitors, and a softer crowd behind the action. Keep the principal subject sharp, with directional blur limited to fast extremities and spray. Preserve the specified broadcast angle and reserve overlay areas clear of the action. Avoid: warped perspective, malformed anatomy, merged objects, inconsistent shadows, excessive sharpening and watermarks. Follow the scene-specific text and branding restrictions above.
Generado con Image 2
Scene: A metallic wireless-earbud charging case floats open above a glossy black surface while the two matching earbuds hover above their slots. Purple and cyan rim lights define the rounded metal, black interior, reflections, and empty dark background. Preserve the case, earbuds, hinge, highlights, and three-quarter camera angle. No readable branding, extra products, hands, or watermark. Composition and rendering: Deliver one 16:9 commercial product still. Keep the complete product silhouette inside generous crop-safe margins. Resolve edges, seams and material transitions precisely; shape highlights to describe volume without clipping bright surfaces or crushing dark details. Align reflections with the object and light source. Retain the stated camera angle and existing negative space; add no decorative props. Avoid: warped perspective, malformed anatomy, merged objects, inconsistent shadows, excessive sharpening and watermarks. Follow the scene-specific text and branding restrictions above.
Generado con Image 2
Scene: A cloaked figure crouches on a rain-slick elevated walkway beneath massive futuristic bridges. Cyan fog, magenta tower lights, railings, and wet reflections lead toward the distant city. Hold the figure's silhouette, facing direction, cloak edge, camera height, and neon light placement as a cinematic storyboard keyframe. No readable signs, logos, or watermark. Composition and rendering: Deliver one 16:9 storyboard keyframe, not a collage or an action sequence. Separate foreground, character plane and background through the existing light and atmospheric depth. Keep the stated pose and eyelines readable, and retain environmental landmarks for continuity. Match the described photographic, illustrated or puppet medium; give fabric and surfaces texture appropriate to that medium. Avoid: warped perspective, malformed anatomy, merged objects, inconsistent shadows, excessive sharpening and watermarks. Follow the scene-specific text and branding restrictions above.
Generado con Image 2
Scene: In a wet green park, a man in a coral-red raincoat and yellow boots struggles with an inverted rainbow umbrella in a gust of wind. His arms brace against the bent canopy while rain streaks through the trees and puddles reflect the bright colors. Keep the umbrella shape, body pose, wind direction, and safe footing clear; no injury, readable text, logos, or watermark. Composition and rendering: Deliver one 16:9 physical-comedy still at the described instant. Make the cause of the gag readable through body balance, grip and object spacing. Separate the reaction from the airborne props; retain believable gravity and contact points. Keep the face and important props sharp, with only restrained directional blur on fast edges. Preserve the stated lighting and room or stage layout. Avoid: warped perspective, malformed anatomy, merged objects, inconsistent shadows, excessive sharpening and watermarks. Follow the scene-specific text and branding restrictions above.
Generado con Image 2
Scene: A softly faded historical dock scene shows several workers repairing a large wooden boat at a riverside boatyard. Timber ribs, scaffolding, hand tools, smaller boats, and weathered work clothes fill the wide documentary frame. Restore the wood grain, riverbank structures, faces, and natural color aging without modern objects, readable signs, logos, captions, or watermark. Composition and restoration: Deliver one 16:9 archival-style still. Preserve the original framing, period-specific construction and restrained tonal range; retain monochrome, sepia or faded color as described. Recover modest detail in faces, clothing and architecture without synthetic sharpening. Keep fine grain and authentic aging consistent across the frame; repair damage without replacing historical features. Avoid: warped perspective, malformed anatomy, merged objects, inconsistent shadows, excessive sharpening and watermarks. Follow the scene-specific text and branding restrictions above.
Por qué usar la API de gemini-3.1-flash-image
¿Por qué usar gemini-3.1-flash-image mediante Flatkey?
Usa una sola pasarela para gemini-3.1-flash-image, los controles de la cuenta y el resto del catálogo de modelos.
gemini-3.1-flash-image en una sola API
Mantén explícitos el ID de modelo y el endpoint de gemini-3.1-flash-image usando la misma clave Flatkey que en otras cargas.
Precios del catálogo en vivo
Consulta las dimensiones de facturación actuales de gemini-3.1-flash-image antes de enviar la solicitud y confirma la estimación final en tu cuenta.
Entrega práctica del modelo
Prueba un prompt de gemini-3.1-flash-image en el playground público y lleva la misma configuración a una integración autenticada.
Controles de uso y enrutamiento
Centraliza claves, cuotas y rutas para gemini-3.1-flash-image sin cambiar el flujo de trabajo de tu aplicación frente al proveedor.
API
gemini-3.1-flash-image API
Cuatro formas de acceder, con la misma clave y catálogo. Elige una para ver un ejemplo ejecutable.
curl https://router.flatkey.ai/v1beta/models/gemini-3.1-flash-image:generateContent \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-***" \ -d '{"model":"gemini-3.1-flash-image","contents":[{"role":"user","parts":[{"text":"Crea con gemini-3.1-flash-image una imagen de producto de alta calidad: composición limpia, iluminación precisa, sujeto destacado y detalle realista."}]}],"generationConfig":{"responseModalities":["TEXT","IMAGE"],"imageConfig":{"aspectRatio":"1:1","imageSize":"1K"}}}'
Preguntas frecuentes
gemini-3.1-flash-image API
preguntas sobre precios, funciones y uso
Respuestas sobre precios, capacidades, endpoints y límites del catálogo de gemini-3.1-flash-image.




