Gemini 3.1 Flash Image — geração de imagens rápida de 512px a 4K
O Gemini 3.1 Flash Image é o modelo de imagem de uso geral do Google: de rascunhos em 512px a versões finais em 4K, 14 proporções, referências em imagem, vídeo e PDF. Mantenha seu corpo generateContent. A partir de $0.03 por imagem.
- Texto para imagem
- Edição de imagens
- De 512px a 4K
- 14 proporções
- Até 14 referências
- Entrada de vídeo e PDF
Teste o Gemini 3.1 Flash Image antes de escrever qualquer código
Rode o Gemini 3.1 Flash Image com exatamente o JSON que seu código vai enviar. Todos os campos generateContent que o endpoint aceita estão aqui.
gemini-3.1-flash-image-official$45.00 / 1M image output tokens
Descreva uma imagem, adicione referências se tiver e envie uma vez. O resultado aparece quando a tarefa termina.
O que criar ou mudar. Tema, cenário, iluminação e estilo.
Imagens, vídeos ou PDFs que o modelo deve ler. Os arquivos são enviados e passados como URLs.
Até 14, enviadas como URLs em fileData.
Por padrão segue a primeira referência; sem referência, 1:1.
Resolução de saída. O padrão é 1K.
Só a imagem, ou a imagem com uma breve resposta em texto.
Regras fixas para o modelo, como um estilo da casa.
Limite de bloqueio para esta categoria.
As opções em cinza afrouxam a filtragem de conteúdo. Elas estão disponíveis somente pela API, não no Playground.
Limite de bloqueio para esta categoria.
As opções em cinza afrouxam a filtragem de conteúdo. Elas estão disponíveis somente pela API, não no Playground.
Limite de bloqueio para esta categoria.
As opções em cinza afrouxam a filtragem de conteúdo. Elas estão disponíveis somente pela API, não no Playground.
Limite de bloqueio para esta categoria.
As opções em cinza afrouxam a filtragem de conteúdo. Elas estão disponíveis somente pela API, não no Playground.
0–2. Deixe vazio para usar o padrão do modelo.
0–1. Deixe vazio para usar o padrão do modelo.
Número inteiro, 1 ou mais.
Número inteiro. Reutilize para reproduzir um resultado com mais fidelidade.
Limita a saída de texto e de raciocínio.
Uma por linha, até 5.
Só 1: uma requisição devolve uma imagem.
Quantos tokens cada referência consome. Menor é mais barato.
Devolve o resumo do raciocínio do modelo junto com a imagem.
IMAGE_JPEG é o único valor documentado.
Só vale quando “Proporção” acima está em “Padrão”; se os dois estiverem definidos, “Proporção” prevalece.
Só vale quando “Tamanho da imagem” acima está em “Padrão”; se os dois estiverem definidos, “Tamanho da imagem” prevalece.
Estimado pelas tarifas atuais a partir dos tokens de imagem do tamanho selecionado, mais uma amostra medida de tokens de texto e de raciocínio. As referências de entrada somam um pouco no Official.
Experimente um destes prompts
Imagens de exemplo geradas com o Gemini 3.1 Flash Image por esta API
Preço do Gemini 3.1 Flash Image
Duas formas de pagar pelo Gemini 3.1 Flash Image. O Standard é um preço fixo por imagem em qualquer tamanho. O Official cobra os tokens que cada renderização informa, então imagens pequenas custam menos e 4K custa mais.
- Official
- $0.05132/imagem
- Standard
- $0.03/imagem
- Official
- 389imagens
- Standard
- 666imagens
Os dois preços vêm das tarifas cobradas na sua conta. Requisições que falham não são cobradas.
As estimativas do Official usam os tokens de imagem que o Google publica para cada tamanho, mais uma amostra medida de 405 tokens de texto e de raciocínio e 27 tokens de prompt.
Custo do Gemini 3.1 Flash Image por tamanho de imagem
O Google publica os tokens de imagem de cada tamanho do Gemini 3.1 Flash Image, de 747 em 512px a 2.520 em 4K. Os preços Official abaixo somam uma amostra medida de texto e raciocínio.
| Tamanho da imagem | Tokens de imagem | Preço · Official | Preço · Standard |
|---|---|---|---|
| 512 | 747 | $0.03454 | $0.03 |
| 1K | 1,120 | $0.05132 | $0.03 |
| 2K | 1,680 | $0.07652 | $0.03 |
| 4K | 2,520 | $0.11432 | $0.03 |
O Standard é um preço fixo por imagem em todos os tamanhos. O Official segue os tokens de imagem, então tamanhos maiores custam mais.
Calcule o preço da sua requisição ao Gemini 3.1 Flash Image
Escolha um tamanho e veja o número mudar. Ele é calculado com a tarifa ao vivo e com os tokens de imagem que o Google publica para cada tamanho, então acompanha o preço.
Uma estimativa antes do envio. O Standard cobra cada imagem entregue; o Official cobra a saída de imagem, a saída de texto e de raciocínio e a entrada, cada uma com sua própria tarifa.
| Item | Como é medido | Tarifa | Cobrança |
|---|---|---|---|
| Official · Saída de imagem | Tokens de imagem informados na renderização | $45.00 / 1M$60.00 / 1M | Cobrado pelo consumo real |
| Official · Saída de texto e raciocínio | Tokens de texto e de raciocínio informados na renderização | $2.25 / 1M$3.00 / 1M | Cobrado pelo consumo real |
| Official · Entrada | Tokens de prompt e de referências | $0.375 / 1M$0.50 / 1M | Cobrado pelo consumo real |
| Standard · Por imagem | Cada imagem entregue, em qualquer tamanho | $0.03 /imagem$0.04 /imagem | Cobrado quando a imagem é entregue |
| Requisições que falham | Qualquer tarefa que termine como failed | Grátis | Nada é cobrado |
O que é o Gemini 3.1 Flash Image?
O Gemini 3.1 Flash Image é o modelo de geração e edição de imagens do Google, vendido com o nome Nano Banana 2. O Google o descreve como seu modelo de imagem mais versátil, equilibrando velocidade com saída em 4K, conhecimento de mundo e renderização de texto confiável.
No SeedRouter você chama o Gemini 3.1 Flash Image com o próprio corpo de requisição generateContent do Google mais um campo model. Envie uma vez, guarde o ID da tarefa e leia a URL da imagem hospedada quando a tarefa terminar.
ID do modelo: gemini-3.1-flash-image · ID com cobrança por token: gemini-3.1-flash-image-official · Limite de entrada: 131.072 tokens.
Duas formas de usar o Gemini 3.1 Flash Image
Chame a API a partir do seu backend ou passe o trabalho para um agente de programação.
Chamar a API
Envie a requisição ao Gemini 3.1 Flash Image do seu servidor, guarde o ID da tarefa e leia a imagem pronta na tarefa.
- 1Criar uma chave de API
- 2Envie o corpo da requisição por POST
- 3Consulte a tarefa até ela terminar
Deixe um agente fazer
Copie um prompt pronto no Claude Code, Codex ou Cursor. Ele pede confirmação antes de gastar e baixa o resultado.
- 1Copie o prompt
- 2Preencha o que você quer
- 3Aprove a requisição
Por que desenvolvedores escolhem o Gemini 3.1 Flash Image
O modelo de imagem Gemini padrão: rápido, flexível e barato para rascunhos.
O corpo de requisição do Google
O Gemini 3.1 Flash Image aceita os mesmos contents e generationConfig que você enviaria ao Google. Adicione um campo model e pronto.
Quatro tamanhos de saída
Faça o rascunho em 512px e finalize em 4K com a mesma requisição ao Gemini 3.1 Flash Image.
Proporções extremas
O Gemini 3.1 Flash Image acrescenta 1:4, 4:1, 1:8 e 8:1 para banners e formatos altos.
Referências em vídeo e PDF
Aponte o Gemini 3.1 Flash Image para um clipe ou uma ficha de produto, não só para fotos.
14 referências
Combine até 14 referências em uma única requisição ao Gemini 3.1 Flash Image, passadas como URLs em fileData.
Baseado em tarefas
As renderizações do Gemini 3.1 Flash Image nunca prendem sua conexão aberta. Você consulta uma tarefa e recebe uma URL.
O que os times constroem com o Gemini 3.1 Flash Image
Imagens de catálogo
O Gemini 3.1 Flash Image trata fotos de produto em volume.
Formatos para redes sociais
Versões quadradas, verticais e horizontais com o Gemini 3.1 Flash Image a partir de um único prompt.
Banners
O Gemini 3.1 Flash Image preenche layouts em 8:1 e 1:8 sem cortar.
Rascunhos baratos
Itere com o Gemini 3.1 Flash Image em 512px e depois gere em 4K a versão escolhida.
A partir de documentos
Transforme um briefing em PDF em um visual com o Gemini 3.1 Flash Image.
Edições
Mude um fundo, uma cor ou um objeto com o Gemini 3.1 Flash Image e mantenha o resto.
Comece com o Gemini 3.1 Flash Image em quatro passos
- 01
Criar uma chave
Entre, recarregue qualquer valor e crie uma chave de API. Os créditos nunca expiram.
- 02
Enviar uma requisição
Envie por POST o corpo do Gemini 3.1 Flash Image para /v1/images/generations com seu prompt e as URLs de referência, se houver.
- 03
Consultar a tarefa
Guarde o ID da tarefa e consulte a cada poucos segundos até o status ser completed.
- 04
Baixar a imagem
Salve no seu próprio armazenamento a URL da imagem hospedada que vem na saída da tarefa.
Gemini 3.1 Flash Image em resumo
Os fatos que decidem se o Gemini 3.1 Flash Image serve para o trabalho.
| Característica | Gemini 3.1 Flash Image |
|---|---|
| ID do modelo | gemini-3.1-flash-image |
| Tamanhos de saída | 512, 1K, 2K, 4K |
| Proporções | 14 (de 1:8 a 8:1) |
| Referências | Até 14 |
| Tipos de referência | Imagem, vídeo, PDF |
| Cobrança | Por imagem (Standard) ou por token (Official) |
Para as tarefas visuais mais complexas, veja o Gemini 3 Pro Image. Para o menor custo em 1K, veja o Gemini 3.1 Flash Lite Image.
Antes de migrar seu código do Gemini 3.1 Flash Image
O ID preview continua funcionando
O Google aposentou o gemini-3.1-flash-image-preview em 25 de junho de 2026. Aqui ele continua rodando, atendido pelo gemini-3.1-flash-image.
URLs, não inlineData
Envie as referências do Gemini 3.1 Flash Image como URLs em fileData. O inlineData em base64 é recusado antes de qualquer cobrança.
Ainda sem grounding com a Pesquisa
Por enquanto, requisições ao Gemini 3.1 Flash Image com tools são recusadas.
Uma imagem por requisição
candidateCount é 1. Envie várias requisições ao Gemini 3.1 Flash Image para um lote.
Por que usar o Gemini 3.1 Flash Image no SeedRouter
Duas formas de pagar
Escolha o Standard para um preço fixo por imagem do Gemini 3.1 Flash Image, ou o Official para pagar os tokens que cada renderização informa. Mesma chave, mesmo corpo de requisição.
Requisições que falham são grátis
Se uma tarefa termina como failed, nada é cobrado. Você só paga pelas imagens entregues.
Os créditos nunca expiram
Recarregue uma vez e use o saldo quando precisar. Sem assinatura.
Resultados hospedados
As imagens prontas voltam como URLs no nosso CDN. Guarde uma cópia de tudo o que você precisar a longo prazo.
Uma chave para todos os modelos
A mesma chave e o mesmo saldo funcionam para os outros modelos de imagem do catálogo.
Outros modelos de imagem no SeedRouter
Mesma chave, mesmo saldo, mesma API de tarefas.
Crie e edite imagens com o GPT Image 2 no SeedRouter. Prompts de texto, imagens de referência e fundos transparentes, com playground ao vivo e preço por uso.
Ver preçosGere e edite imagens com o GPT Image 2.5 Flare ou Sunburst no SeedRouter. Seis níveis de qualidade até max, fundos transparentes, playground ao vivo e preço por uso.
Ver preçosUse o Gemini 3 Pro Image com o corpo generateContent do Google: de 1K a 4K, raciocínio integrado, 14 referências. Preço por imagem ou por token.
Ver preçosUse o Gemini 3.1 Flash Lite Image (gemini-3.1-flash-lite-image), o modelo de imagem mais rápido e barato do Google, com seu corpo generateContent. Saída 1K.
Ver preçosGuias do Gemini 3.1 Flash Image
Guias práticos para escolher, calcular o preço e integrar o modelo.
Nano Banana é grátis? O que o app Gemini e a API do Gemini incluem sem pagar para o Nano Banana 2 e o Nano Banana Pro, e quando você começa a pagar.
Use a API do Nano Banana 2 passo a passo: crie uma chave, envie uma requisição generateContent, consulte a tarefa, adicione referências e use um agente.
Compare Nano Banana 2, Nano Banana Pro e Nano Banana 2 Lite em tamanho de imagem, proporções, referências, raciocínio e cobrança; escolha um por trabalho.
Preços atuais da API Nano Banana para Nano Banana 2, Pro e 2 Lite: preço fixo por imagem e cobrança por tokens, custo por resolução e quando usar cada uma.
Perguntas frequentes sobre o Gemini 3.1 Flash Image
O Gemini 3.1 Flash Image é o mesmo que o Nano Banana 2?+
Sim. Nano Banana 2 é o nome comercial que o Google dá ao Gemini 3.1 Flash Image, e o ID do modelo é gemini-3.1-flash-image. A página do Nano Banana 2 trata do mesmo modelo pelo ângulo do produto.
Existe um Gemini 3 Flash Image?+
Não. O modelo de imagem Flash da família Gemini 3 é o Gemini 3.1 Flash Image, ID do modelo gemini-3.1-flash-image. Quem pesquisa por Gemini 3 Flash Image geralmente está procurando este modelo.
O gemini-3.1-flash-image-preview ainda está disponível?+
O Google desativou o ID preview em 25 de junho de 2026. No SeedRouter o gemini-3.1-flash-image-preview ainda é aceito e roda no gemini-3.1-flash-image, então o código antigo continua funcionando enquanto você troca o ID.
Quanto custa o Gemini 3.1 Flash Image?+
Uma imagem 1K custa $0.03 no Standard, seja qual for o prompt. No Official você paga os tokens que cada renderização informa; uma renderização 1K típica sai por cerca de $0.05132. A seção de preços mostra todos os tamanhos pela tarifa ao vivo.
O Gemini 3.1 Flash Image é grátis?+
A página de preços do Google não lista nenhum nível gratuito para o Gemini 3.1 Flash Image na Gemini API. No SeedRouter você recarrega uma vez, os créditos nunca expiram e as requisições que falham não são cobradas.
Preciso mudar minha requisição do Gemini?+
Mantenha contents, systemInstruction, safetySettings e generationConfig como estão. Adicione um campo model, envie para /v1/images/generations e leia o resultado do Gemini 3.1 Flash Image na tarefa.
Como obter uma chave de API para o Gemini 3.1 Flash Image?+
Entre, recarregue qualquer valor e crie uma chave na página de chaves de API. A mesma chave funciona para o Gemini 3.1 Flash Image e para todos os outros modelos daqui.
Gemini 3.1 Flash Image ou Gemini 3 Pro Image?+
Comece com o Gemini 3.1 Flash Image para velocidade, rascunhos em 512px, proporções extremas e referências em vídeo ou PDF. Passe para o Gemini 3 Pro Image em instruções complexas e peças profissionais.
Envie sua primeira requisição ao Gemini 3.1 Flash Image
Teste o Gemini 3.1 Flash Image no Playground e depois cole o mesmo JSON no seu código.