gemini-3.1-flash-image API de imagem com IA

gemini-3.1-flash-image (Nano Banana 2): Gere imagens, edite referências e refine designs pela Flatkey. O exemplo usa contents/parts do Gemini, não um corpo intercambiável da Images API.

Texto para imagemImagem guiada por referência
Entrada /M
$0.5/ 1 M tokens$0.5/ 1 M tokens
Saída /M
$3/ 1 M tokens$3/ 1 M tokens
Provedor
Google
Configuração do gerador · Playground (edite antes de cadastrar)

Entrada

InstruçãoVer mais875 / 10000
Prompts rápidos
Imagens de referência
Começar a gerar

Saída

Prévia
Prévia de imagem

Gerado com Image 2

Resumo da solicitação

Endpoint da API
POST /v1beta/models/gemini-3.1-flash-image:generateContent
ID do modelo
gemini-3.1-flash-image
Proporção
1:1
Resolução
1K

Somente prévia. Entre para enviar esta solicitação à Flatkey.

Prévia da solicitação
{
  "model": "gemini-3.1-flash-image",
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Creative direction: Create a two-panel luxury skincare serum advertising poster. Show a frosted dropper bottle against warm ivory and champagne-gold liquid, with fine water droplets, translucent molecule diagrams, and carefully aligned areas for benefits, ingredients, and price. Keep the bottle proportions and reflections identical across both panels, use soft cream-and-gold lighting, and leave the typography zones clean for editorial copy.\n\nComposition, material and finish: Keep panel gutters equal and the bottle silhouette unobstructed. Render frosted glass with soft transmission, gold liquid with restrained specular highlights, and droplets at a believable scale. Treat molecule drawings as sparse graphic accents. Leave benefit and price fields unfilled for post-production; avoid invented efficacy claims, duplicate droppers, incompatible shadows and watermarks."
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "TEXT",
      "IMAGE"
    ],
    "imageConfig": {
      "aspectRatio": "1:1",
      "imageSize": "1K"
    }
  }
}

Desempenho da API

gemini-3.1-flash-image Confiabilidade e disponibilidade da API

A telemetria de solicitações da Flatkey para gemini-3.1-flash-image aparecerá aqui quando houver tráfego de produção suficiente.

Disponibilidade média do provedor
94.7%
últimos 30 dias
Latência
1.79s
últimos 30 dias
Solicitações
281
Janela de 30 dias
Tendência de inferências bem-sucedidas

Atividade da API

gemini-3.1-flash-image Uso e atividade de solicitações da API

Acompanhe o volume de solicitações e a atividade de inferência bem-sucedida de gemini-3.1-flash-image no período mais recente.

Solicitações
281
Janela de 30 dias
Latência
1.79s
últimos 30 dias
Disponibilidade
94.7%
últimos 30 dias
Tendência de inferências bem-sucedidasAtividade

gemini-3.1-flash-image preços

gemini-3.1-flash-image Preços e cobrança da API

Os cartões mostram as tarifas atuais de tokens de entrada e saída da Flatkey. Tarifa por token não é preço fixo por imagem: configurações, referências e saída afetam o consumo. Preços e cotas gratuitas diretas do Google não se aplicam automaticamente.

Preço Flatkey

Entrada /M

Modelo do catálogo ao vivo
$0.5/ 1 M tokens$0.5/ 1 M tokens
Entrada /M
$0.5/ 1 M tokens$0.5/ 1 M tokens
Saída /M
$3/ 1 M tokens$3/ 1 M tokens
Entrada de imagem /M
$0.06/ 1 M tokens$0.06/ 1 M tokens
Teste um prompt
Saldo compartilhado

Adicionar créditos

Adicionar créditos

Use o mesmo saldo e a mesma chave de API Flatkey para modelos de imagem, vídeo, áudio e texto.

Catálogo de modelos
Tipo de modelo
Texto para imagem
API
/v1beta/models/gemini-3.1-flash-image:generateContent
Base de cobrança
1M tokens
Saídas
1

gemini-3.1-flash-image gerador de imagens por IA e API: principais capacidades

A rota gemini-3.1-flash-image de Google aceita texto · imagem. Categorias do catálogo: Marketing.

Texto para imagem

Descreva assunto, composição, luz e texto. Defina controles de saída nos campos da solicitação, não apenas no prompt.

Imagem de referência

Adicione referências e indique o que preservar e alterar. Respeite os limites da matriz de parâmetros.

Saídas

Escolha apenas proporções e tamanhos oferecidos no Playground. Flash, Flash Lite e Pro têm limites diferentes.

API

Mantenha o ID exato e a estrutura contents/parts do exemplo. Teste uma solicitação pequena antes de processar lotes.

Comparar

gemini-3.1-flash-image Comparação de API: capacidades e acesso

Compare os fatos do catálogo de gemini-3.1-flash-image com a referência da geração anterior antes de alterar sua integração.

CapacidadeGeração anteriorgemini-3.1-flash-image
ProvedorNão verificado neste instantâneo do catálogoGoogle
ModalidadesNão verificado neste instantâneo do catálogotexto · imagem
ContextoNão verificado neste instantâneo do catálogoA janela de contexto não está listada no catálogo
Endpoint da APINão verificado neste instantâneo do catálogo/v1beta/models/gemini-3.1-flash-image:generateContent
CobrançaNão verificado neste instantâneo do catálogo$0.5/$3 per 1M tokens

Escolha a solicitação certa antes de integrar

Confira fluxos, custo atual e o contrato exato de parâmetros da Flatkey.

Estimativa de custo ao vivo

Calculada com a configuração atual e a tarifa do catálogo quando há preço unitário fixo.

Configuração atual
1×
Tarifa ao vivo
$0.06
Solicitação estimada
Preço por uso

A cobrança final depende da solicitação e do grupo; preços por tokens ou faixas não viram uma estimativa fixa.

Fluxos e Model ID

Use apenas fluxos disponíveis. A Flatkey mantém um ID público e o corpo escolhe a entrada.

Disponível

Texto para imagem

Gere uma imagem a partir de texto.

ID do modelo
gemini-3.1-flash-image
Endpoint
/v1beta/models/gemini-3.1-flash-image:generateContent
Disponível

Imagem guiada por referência

Use referências para editar ou variar imagens.

ID do modelo
gemini-3.1-flash-image
Endpoint
/v1beta/models/gemini-3.1-flash-image:generateContent

Compatibilidade de parâmetros

Valores da mesma configuração usada no Playground.

aspect_ratioProporção
Aceitos

1:1 · 2:3 · 3:2 · 3:4 · 4:3 · 4:5 · 5:4 · 9:16 · 16:9 · 21:9

Padrão: 1:1
image_sizeTamanho
Aceitos

1K · 2K · 4K

Padrão: 1K
imageLimite de referências
Aceitos

4 arquivos

Endpoint: /v1beta/models/gemini-3.1-flash-image:generateContent

Do primeiro teste à produção

Use o mesmo contrato no Playground e na API e trate validação, saldo, estado e resultado.

Ciclo da solicitação

  1. 1

    Validar modelo, prompt, referências e saída.

  2. 2

    Enviar a solicitação de imagem.

  3. 3

    Ler o resultado ou tarefa assíncrona.

  4. 4

    Armazenar arquivo e metadados.

Verificações de produção

Validação

Bloqueie valores e referências incompatíveis.

Autenticação e saldo

Trate chave, saldo, limites e grupo separadamente.

Entrada rejeitada

Identifique o prompt ou mídia a substituir.

Falha ou timeout

Guarde o task ID, limite tentativas e não trate timeout como sucesso.

Biblioteca de prompts

Exemplos de prompts de gemini-3.1-flash-image para geração de imagens

Comece com um prompt de gemini-3.1-flash-image para geração de imagens e ajuste os campos de solicitação exibidos no playground.

Interação de UI de jogo e troca de equipamento
Interação de UI de jogo e troca de equipamento

Gerado com 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.

Criar semelhante
Simulação de transmissão esportiva em TV
Simulação de transmissão esportiva em TV

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.

Criar semelhante
TVC de marca e vitrine de e-commerce
TVC de marca e vitrine de e-commerce

Gerado com 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.

Criar semelhante
Personagem cinematográfico e direção de storyboard
Personagem cinematográfico e direção de storyboard

Gerado com 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.

Criar semelhante
Esquete cômica e narrativa física
Esquete cômica e narrativa física

Gerado com 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.

Criar semelhante
Restauração de foto histórica e memória documental
Restauração de foto histórica e memória documental

Gerado com 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.

Criar semelhante

Por que usar a API gemini-3.1-flash-image

Por que usar gemini-3.1-flash-image pela Flatkey?

Use um único gateway para gemini-3.1-flash-image, controles da conta e o restante do catálogo de modelos.

gemini-3.1-flash-image em uma API

Mantenha o ID do modelo e o endpoint de gemini-3.1-flash-image explícitos usando a mesma chave Flatkey das demais cargas.

Preços do catálogo ao vivo

Veja as dimensões de cobrança atuais de gemini-3.1-flash-image antes do envio e confirme a estimativa final na conta.

Transição prática de modelo

Teste um prompt de gemini-3.1-flash-image no playground público e leve as mesmas configurações para uma integração autenticada.

Controles de uso e roteamento

Centralize chaves, cotas e roteamento de gemini-3.1-flash-image sem mudar o fluxo da aplicação voltado ao provedor.

API

gemini-3.1-flash-image API

Quatro formas de entrar, com a mesma chave e catálogo. Escolha uma para ver um exemplo executável.

Use qualquer modelo com uma API compatível com OpenAI. Copie um exemplo pronto para seu modelo e linguagem.
Use o SDK da OpenAI que você já conhece — com o Flatkey como gateway.
Gere imagens e vídeos direto do terminal. Deixe seu assistente de IA conduzir o fluxo de trabalho.
Conecte seu agente de programação com um comando e use o Flatkey nos seus projetos existentes.
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":"Crie com gemini-3.1-flash-image uma imagem de produto de alta qualidade: composição limpa, iluminação precisa, foco forte no produto e detalhes realistas."}]}],"generationConfig":{"responseModalities":["TEXT","IMAGE"],"imageConfig":{"aspectRatio":"1:1","imageSize":"1K"}}}'
Documentação

Perguntas frequentes

gemini-3.1-flash-image API
perguntas sobre preço, recursos e uso

Respostas sobre preços, capacidades, endpoints e limites do catálogo de gemini-3.1-flash-image.

Para que gemini-3.1-flash-image é usado?
gemini-3.1-flash-image (Nano Banana 2): Gere imagens, edite referências e refine designs pela Flatkey. O exemplo usa contents/parts do Gemini, não um corpo intercambiável da Images API.
Como gemini-3.1-flash-image é cobrado?
Entrada /M: $0.5; Saída /M: $3; Entrada de imagem /M: $0.06. Os cartões mostram as tarifas atuais de tokens de entrada e saída da Flatkey. Tarifa por token não é preço fixo por imagem: configurações, referências e saída afetam o consumo. Preços e cotas gratuitas diretas do Google não se aplicam automaticamente.
Qual endpoint da API chama gemini-3.1-flash-image?
POST /v1beta/models/gemini-3.1-flash-image:generateContent · gemini-3.1-flash-image
A Flatkey oferece todos os recursos documentados pelo Google?
Não. As especificações do Google e o contrato da rota Flatkey têm escopos distintos. Use os campos suportados aqui; o nome do modelo não garante busca, ferramentas ou todos os tipos de entrada oficiais.