Erros
Todos os status HTTP e códigos de erro que a API do Cheapest Imagen devolve, o que cada um significa, se houve cobrança e o que fazer em seguida.
Os erros têm o mesmo formato dos da OpenAI:
{
"error": {
"message": "Not enough credits for this request.",
"type": "invalid_request_error",
"param": null,
"code": "insufficient_credits"
}
}Toda resposta traz um cabeçalho x-request-id. Informe-o ao falar com o suporte.
| Status | code | Significado | O que fazer |
|---|---|---|---|
| 400 | missing_required_parameter | Falta um campo obrigatório | Adicione o campo indicado em param |
| 400 | invalid_value | Um campo tem um valor que não é aceito | Corrija o campo indicado em param |
| 400 | unsupported_parameter | O campo não está disponível, ou não existe neste modelo (por exemplo, svg em um modelo sem saída SVG) | Remova o campo ou escolha um modelo que o tenha |
| 400 | model_not_found | O modelo não existe ou não está disponível | Use um modelo de GET /v1/models |
| 400 | moderation_blocked | O prompt ou a imagem foi recusado pela verificação de conteúdo | Mude o prompt. Sem cobrança, exceto nos canais estáveis do Nano Banana (-1k, -2k, -4k) |
| 401 | invalid_api_key | A chave está ausente ou errada | Confira o cabeçalho Authorization |
| 402 | insufficient_credits | Créditos insuficientes | Recarregue |
| 403 | account_suspended | A conta ou a chave está desativada | Fale com o suporte |
| 409 | idempotency_key_in_use | A Idempotency-Key já foi usada | Espere a primeira requisição ou use uma chave nova |
| 413 | request_too_large | A requisição ou uma imagem é grande demais | Envie imagens menores ou em menor número |
| 429 | rate_limit_exceeded | Mais de 300 requisições em um minuto | Diminua o ritmo e tente de novo |
| 429 | concurrency_limit_exceeded | Mais de 50 requisições ao mesmo tempo | Espere uma terminar |
| 429 | moderation_paused | Mais de 10 requisições recusadas em uma hora | Espere uma hora |
| 502 | upstream_error | Não foi possível gerar a imagem | Tente de novo. Sem cobrança |
| 504 | upstream_timeout | A geração levou mais de 420 segundos | Tente de novo. Sem cobrança |
Quando há cobrança
Só pelas imagens que você recebe. Requisições que falham, expiram ou são recusadas não custam nada. A exceção: os canais estáveis do Nano Banana (-1k, -2k, -4k) cobram pelas imagens recusadas por causa do conteúdo, porque o provedor cobra por elas.
Limites de uso e geração em lote
Os limites da API do Cheapest Imagen (300 por minuto, 50 ao mesmo tempo), o que significa um 429 e como gerar milhares de imagens com novas tentativas sem cobrança dupla.
Migrar da OpenAI
Passe o código que usa a API de Imagens da OpenAI para o Cheapest Imagen trocando só a URL base e a chave de API; os campos da requisição e da resposta continuam iguais.