O que você vai criar
Você chamará a rota Gemini imagegenerateContent por meio da CometAPI, solicitará uma saída de imagem de modelos de imagem Gemini, incluindo famílias de modelos Nano Banana, ignorará partes intermediárias de imagem thought e salvará a imagem final inlineData.
Pré-requisitos
- Uma chave de API da CometAPI armazenada em
COMETAPI_KEY - Python 3.10+ com
requests, ou Node.js 18+ - Um model ID de imagem Gemini. A referência de API mantida usa
gemini-3.1-flash-image-previewcomo exemplo de texto para imagem.
Chave de API, URL base, autenticação
Use a rota de imagem Gemini por meio da CometAPI:x-goog-api-key:
Exemplos de código
Use as abas abaixo para exemplos copiáveis em cURL, Python e Node.js.Explicação do fluxo
A geração de imagens Gemini é síncrona nesta rota. A resposta usacandidates[].content.parts[] nativo do Gemini. As partes podem incluir texto, imagens geradas e partes intermediárias de imagem em que thought é true.
Ao salvar o resultado, percorra as partes de imagem, ignore thought: true e salve a última imagem inlineData restante.
Parâmetros comuns
Solução de problemas / FAQ
A resposta contém imagens thought
A resposta contém imagens thought
Não salve partes em que
thought é true. Essas são imagens intermediárias, não a saída final.A solicitação retorna apenas texto
A solicitação retorna apenas texto
Verifique se
generationConfig.responseModalities inclui IMAGE e se o modelo selecionado oferece suporte a saída de imagem.Preciso de imagem para imagem
Preciso de imagem para imagem
Use partes de solicitação
inline_data como mostrado no guia de imagem Gemini e mantenha a mesma lógica de análise da imagem final.Próximos passos
- Leia a referência da API de imagem Gemini.
- Veja mais exemplos em Usar modelos de imagem Gemini.
- Encontre modelos de imagem disponíveis em Models.
- Estime o custo com Estimar o custo da solicitação antes de chamar um modelo.