Resposta rápida
- Aceita texto para imagem por prompt com várias proporções.
- Aceita imagens de referência em reference_images para reforçar a consistência de estilo.
- As variantes oficiais oferecem mais controles de geração para ajustes em produção.
Parâmetros principais
- model | string | obrigatório | gemini-3.1-flash-lite-image-official | - | Identificador exato do modelo de imagem fornecido pela ToAPIs.
- prompt | string | obrigatório | - | - | Texto descritivo da imagem.
- size | string | opcional | 1:1 | 1:1 | 16:9 | 9:16 | 4:3 | 3:4 | 21:9 | Proporção de saída.
- resolution | string | opcional | 1K | 1K | 2K | 4K (conforme a capacidade do modelo) | Resolução de saída; os valores variam conforme a versão do modelo.
- reference_images | file[] | opcional | - | max 14 | Matriz de imagens de referência para controlar estilo e composição.
- temperature | number | opcional | 0.8 | 0-2 | Temperatura de amostragem que controla a diversidade da geração.
- topP | number | opcional | 0.95 | 0-1 | Limite de amostragem de núcleo que controla o intervalo de truncamento de probabilidade.
Erros comuns
- 400 invalid_request_error: gatilho=Faltam campos no corpo da requisição ou o tipo é inválido.; correção=Valide os campos e valores model/prompt/size/resolution.; nova tentativa=Tente novamente apenas após corrigir os parâmetros.
- 401 authentication_error: gatilho=Chave de API ausente ou inválida.; correção=Verifique o cabeçalho Authorization 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 a cota atual acionam o limite do provedor.; correção=Aplique primeiro um recuo exponencial e depois revise o ritmo de requisições, a concorrência e o uso da cota.; nova tentativa=Recomenda-se 1s/2s/4s + jitter; se persistir, reduza o ritmo de envio.







