Resposta rápida
- O ponto de entrada é POST /v1/images/generations; envie a tarefa de imagem com o identificador de modelo do Nano Banana 2 indicado na documentação.
- Aceita texto para imagem por prompt e geração com imagens de referência em reference_images, ideal para publicidade, e-commerce, redes sociais e criativos em lote.
- O fluxo é assíncrono: envie a tarefa, receba um id de tarefa e consulte o resultado no endpoint de status da tarefa de imagem.
- O preço oficial de referência fica em torno de $0.067 / $0.101 / $0.151 por imagem em 1K / 2K / 4K; a ToAPIs mostra atualmente $0.030 / $0.040 / $0.060 por imagem na página comparativa, com a cobrança final baseada no preço da sua conta.
- Com a tarifa 1K da ToAPIs de $0.030 por imagem, uma recarga de $10 equivale a cerca de 333 imagens 1K adicionais; com a tarifa 4K de $0.060 por imagem, a cerca de 166 imagens 4K.
Parâmetros principais
- model | string | obrigatório | nano_banana_2 | - | Use o identificador de modelo do Nano Banana 2 indicado na documentação ou na tabela de preços da ToAPIs.
- prompt | string | obrigatório | - | - | Prompt principal de geração de imagens.
- size | string | opcional | 1:1 | 1:1 | 16:9 | 9:16 | 4:3 | 3:4 | Proporção de saída; os valores disponíveis seguem a documentação e a capacidade do modelo.
- resolution | string | opcional | 1K | 1K | 2K | 4K | Nível de resolução de saída; afeta o preço por imagem e o custo de geração.
- reference_images | string[] | opcional | - | Matriz de URL | Matriz de URLs de imagens de referência para geração guiada e controle de estilo ou sujeito.
- response_format | string | opcional | url | url | b64_json | Formato do resultado; recomenda-se usar URL na maioria dos fluxos.
Erros comuns
- 400 invalid_request_error: gatilho=Falta model/prompt, ou os campos de resolução, proporção ou imagens de referência não seguem a documentação.; correção=Valide model, prompt, size, resolution e reference_images conforme a documentação da ToAPIs.; nova tentativa=Tente novamente apenas após corrigir os parâmetros; não convém repetir às cegas.
- 401 authentication_error: gatilho=Cabeçalho Authorization ausente ou chave de API inválida.; correção=Verifique o formato do token Bearer e as permissões da chave.; nova tentativa=Tente novamente após corrigir a autenticação.
- 429 rate_limit_exceeded: gatilho=A frequência de requisições, a concorrência ou os créditos atuais atingem o limite.; correção=Aplique recuo exponencial, reduza a concorrência e revise os créditos da conta.; nova tentativa=Recomenda-se recuo de 1s/2s/4s com jitter; se persistir, enfileire as requisições.










