> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Guia rápido da API de imagem Gemini: gere imagens Nano Banana com CometAPI
> Gere imagens com modelos de imagem Gemini por meio da CometAPI, incluindo famílias de modelos Nano Banana, e salve a saída `inlineData` com curl, Python ou Node.js.
## O que você vai criar
Você chamará a rota Gemini image `generateContent` 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-preview` como exemplo de texto para imagem.
## Chave de API, URL base, autenticação
Use a rota de imagem Gemini por meio da CometAPI:
```text theme={null}
https://api.cometapi.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent
```
Autentique com `x-goog-api-key`:
```text theme={null}
x-goog-api-key: $COMETAPI_KEY
```
## Exemplos de código
Use as abas abaixo para exemplos copiáveis em cURL, Python e Node.js.
```bash cURL theme={null}
curl -s -X POST \
"https://api.cometapi.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent" \
-H "x-goog-api-key: $COMETAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"contents": [
{
"parts": [
{
"text": "A Monarch butterfly anatomical sketch on textured parchment"
}
]
}
],
"generationConfig": {
"responseModalities": ["TEXT", "IMAGE"],
"imageConfig": {
"aspectRatio": "1:1",
"imageSize": "4K"
}
}
}'
```
```python Python theme={null}
import base64
import os
import requests
response = requests.post(
"https://api.cometapi.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent",
headers={
"x-goog-api-key": os.environ["COMETAPI_KEY"],
"Content-Type": "application/json",
},
json={
"contents": [
{
"parts": [
{
"text": "A Monarch butterfly anatomical sketch on textured parchment"
}
]
}
],
"generationConfig": {
"responseModalities": ["TEXT", "IMAGE"],
"imageConfig": {"aspectRatio": "1:1", "imageSize": "4K"},
},
},
timeout=120,
)
response.raise_for_status()
parts = response.json()["candidates"][0]["content"]["parts"]
for part in reversed(parts):
if part.get("thought") is True:
continue
inline_data = part.get("inlineData")
if inline_data:
image_bytes = base64.b64decode(inline_data["data"])
mime_type = inline_data.get("mimeType", "image/png")
extension = "jpg" if mime_type == "image/jpeg" else "png"
with open(f"nano-banana-result.{extension}", "wb") as file:
file.write(image_bytes)
break
else:
raise RuntimeError("No final image part found")
```
```javascript Node.js theme={null}
import fs from "node:fs/promises";
const response = await fetch(
"https://api.cometapi.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent",
{
method: "POST",
headers: {
"x-goog-api-key": process.env.COMETAPI_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
contents: [
{
parts: [
{
text: "A Monarch butterfly anatomical sketch on textured parchment",
},
],
},
],
generationConfig: {
responseModalities: ["TEXT", "IMAGE"],
imageConfig: { aspectRatio: "1:1", imageSize: "4K" },
},
}),
},
);
if (!response.ok) {
throw new Error(await response.text());
}
const body = await response.json();
const parts = body.candidates[0].content.parts;
const finalImage = [...parts]
.reverse()
.find((part) => part.thought !== true && part.inlineData);
if (!finalImage) {
throw new Error("No final image part found");
}
const mimeType = finalImage.inlineData.mimeType || "image/png";
const extension = mimeType === "image/jpeg" ? "jpg" : "png";
await fs.writeFile(
`nano-banana-result.${extension}`,
Buffer.from(finalImage.inlineData.data, "base64"),
);
```
## Explicação do fluxo
A geração de imagens Gemini é síncrona nesta rota. A resposta usa `candidates[].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
| Parameter | Use |
| ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| `model` path segment | Model ID de imagem Gemini no caminho da URL. |
| `contents` | Prompt e partes opcionais de imagem de entrada. |
| `generationConfig.responseModalities` | Inclua `IMAGE` quando precisar de saída de imagem. |
| `generationConfig.imageConfig` | Opções de imagem, como proporção e tamanho da imagem, quando compatíveis com o modelo selecionado. |
| `tools` | Ferramentas opcionais do Gemini. Adicione apenas quando a referência da API documentar o fluxo de trabalho selecionado. |
## Solução de problemas / FAQ
Não salve partes em que `thought` é `true`. Essas são imagens intermediárias, não a saída final.
Verifique se `generationConfig.responseModalities` inclui `IMAGE` e se o modelo selecionado oferece suporte a saída de 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](/api/image/gemini/gemini-generates-image).
* Veja mais exemplos em [Usar modelos de imagem Gemini](/api/image/gemini/generate-image-guide).
* Encontre modelos de imagem disponíveis em [Models](/pt/overview/models).
* Estime o custo com [Estimar o custo da solicitação antes de chamar um modelo](/pt/guides/how-to-estimate-cost-before-calling-a-model).