Gemini 3 Pro Image — o modelo de imagem premium do Google, a uma chamada de API
O Gemini 3 Pro Image é o modelo do Google para trabalho profissional com imagens: saída de 1K a 4K, raciocínio integrado e até 14 referências. Envie o corpo generateContent que você já conhece. A partir de $0.03 por imagem.
- Texto para imagem
- Edição de imagens
- De 1K a 4K
- Raciocínio integrado
- Até 14 referências
- Corpo generateContent
Teste o Gemini 3 Pro Image antes de escrever qualquer código
Rode o Gemini 3 Pro Image com exatamente o JSON que seu código vai enviar. Todos os campos generateContent que o endpoint aceita estão aqui.
gemini-3-pro-image-official$90.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 de referência que o modelo deve seguir. 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 Pro Image por esta API
Preço do Gemini 3 Pro Image
Duas formas de pagar pelo Gemini 3 Pro Image. O Standard é um preço fixo por imagem em qualquer tamanho. O Official cobra os tokens que cada renderização informa: 1K e 2K custam o mesmo e 4K custa mais.
- Official
- $0.10304/imagem
- Standard
- $0.03/imagem
- Official
- 194imagens
- 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 246 tokens de texto e de raciocínio e 14 tokens de prompt.
Custo do Gemini 3 Pro Image por tamanho de imagem
O Google publica os tokens de imagem de cada tamanho do Gemini 3 Pro Image: 1K e 2K usam 1.120, 4K usa 2.000. Os preços Official abaixo somam uma amostra medida de raciocínio.
| Tamanho da imagem | Tokens de imagem | Preço · Official | Preço · Standard |
|---|---|---|---|
| 1K | 1,120 | $0.10304 | $0.03 |
| 2K | 1,120 | $0.10304 | $0.03 |
| 4K | 2,000 | $0.18224 | $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 Pro 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 | $90.00 / 1M$120.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 | $9.00 / 1M$12.00 / 1M | Cobrado pelo consumo real |
| Official · Entrada | Tokens de prompt e de referências | $1.50 / 1M$2.00 / 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 Pro Image?
O Gemini 3 Pro Image é o modelo de geração e edição de imagens do Google, vendido com o nome Nano Banana Pro. O Google o chama de opção premium para as tarefas visuais mais complexas e o projetou para a produção de peças profissionais.
No SeedRouter você chama o Gemini 3 Pro 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-pro-image · ID com cobrança por token: gemini-3-pro-image-official · Limite de entrada: 65.536 tokens.
Duas formas de usar o Gemini 3 Pro 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 Pro 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 Pro Image
O modelo Gemini para usar quando uma renderização precisa acertar instruções complexas.
O corpo de requisição do Google
O Gemini 3 Pro Image aceita os mesmos contents e generationConfig que você enviaria ao Google. Adicione um campo model e pronto.
Raciocina antes de desenhar
O Gemini 3 Pro Image raciocina primeiro sobre o layout. Peça resumos do raciocínio com includeThoughts quando quiser entender o porquê.
Texto legível
O Google lista texto legível e estilizado para infográficos, cardápios e diagramas entre os pontos fortes dos seus modelos de imagem Gemini 3.
Saída em 4K
O Gemini 3 Pro Image gera em 1K, 2K e 4K. Na cobrança por token, 2K custa o mesmo que 1K.
14 referências
Combine até 14 imagens de referência em uma única requisição ao Gemini 3 Pro Image, passadas como URLs em fileData.
Baseado em tarefas
Renderizações longas do Gemini 3 Pro Image nunca prendem sua conexão aberta. Você consulta uma tarefa e recebe uma URL.
O que os times constroem com o Gemini 3 Pro Image
Infográficos e diagramas
O Gemini 3 Pro Image transforma anotações em explicações visuais com rótulos.
Conjuntos fiéis à marca
O Google cita a consistência precisa de marca entre os pontos fortes do Gemini 3 Pro Image, algo útil para peças de campanha.
Artes para impressão
Pôsteres e embalagens em 4K com o Gemini 3 Pro Image.
Peças localizadas
O Google destaca a localização avançada, então um único design do Gemini 3 Pro Image pode levar texto em vários idiomas.
Cenas de produto
Coloque um produto de uma foto de referência em novas cenas do Gemini 3 Pro Image.
Edições precisas
Mude um elemento de uma imagem com o Gemini 3 Pro Image e mantenha o resto.
Comece com o Gemini 3 Pro 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 Pro 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 Pro Image em resumo
Os fatos que decidem se o Gemini 3 Pro Image serve para o trabalho.
| Característica | Gemini 3 Pro Image |
|---|---|
| ID do modelo | gemini-3-pro-image |
| Tamanhos de saída | 1K, 2K, 4K |
| Proporções | 10 (de 9:16 a 21:9) |
| Referências | Até 14 imagens |
| Raciocínio | Sempre ativado; resumos de raciocínio opcionais |
| Cobrança | Por imagem (Standard) ou por token (Official) |
Precisa de rascunhos em 512px, proporções extremas ou entrada de vídeo? Veja o Gemini 3.1 Flash Image.
Antes de migrar seu código do Gemini 3 Pro Image
O ID preview continua funcionando
O Google aposentou o gemini-3-pro-image-preview em 25 de junho de 2026. Aqui ele continua rodando, atendido pelo gemini-3-pro-image.
URLs, não inlineData
Envie as referências do Gemini 3 Pro 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 Pro Image com tools são recusadas.
Uma imagem por requisição
candidateCount é 1. Envie várias requisições ao Gemini 3 Pro Image para um lote.
Por que usar o Gemini 3 Pro Image no SeedRouter
Duas formas de pagar
Escolha o Standard para um preço fixo por imagem do Gemini 3 Pro 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.1 Flash Image (gemini-3.1-flash-image) com o corpo generateContent do Google: de 512px a 4K, 14 proporções, 14 referências. Preço por imagem.
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 Pro 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 Pro Image
O Gemini 3 Pro Image é o mesmo que o Nano Banana Pro?+
Sim. Nano Banana Pro é o nome comercial que o Google dá ao Gemini 3 Pro Image, e o ID do modelo é gemini-3-pro-image. A página do Nano Banana Pro trata do mesmo modelo pelo ângulo do produto.
O gemini-3-pro-image-preview ainda está disponível?+
O Google desativou o ID preview em 25 de junho de 2026. No SeedRouter o gemini-3-pro-image-preview ainda é aceito e roda no gemini-3-pro-image, então o código antigo continua funcionando enquanto você troca o ID.
Quanto custa o Gemini 3 Pro Image?+
Uma imagem custa $0.03 no Standard, em qualquer tamanho. No Official você paga os tokens que cada renderização informa; uma renderização típica em 1K ou 2K sai por cerca de $0.10304. A seção de preços mostra todos os tamanhos pela tarifa ao vivo.
O Gemini 3 Pro Image é grátis?+
A página de preços do Google não lista nenhum nível gratuito para o Gemini 3 Pro 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 Pro Image na tarefa.
Como obter uma chave de API para o Gemini 3 Pro Image?+
Entre, recarregue qualquer valor e crie uma chave na página de chaves de API. A mesma chave funciona para o Gemini 3 Pro Image e para todos os outros modelos daqui.
Dá para desligar o raciocínio do Gemini 3 Pro Image?+
Não. O Gemini 3 Pro Image sempre raciocina antes de desenhar. Você pode pedir um resumo do raciocínio com includeThoughts, e os tokens de raciocínio só são cobrados no Official.
Gemini 3 Pro Image ou Gemini 3.1 Flash Image?+
Use o Gemini 3 Pro Image para instruções complexas e peças profissionais. O Gemini 3.1 Flash Image é mais rápido, acrescenta saída em 512px e proporções extremas, e lê referências em vídeo e PDF.
Envie sua primeira requisição ao Gemini 3 Pro Image
Teste o Gemini 3 Pro Image no Playground e depois cole o mesmo JSON no seu código.