> ## 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.
# Guía de inicio rápido de la API de imágenes de Gemini: genera imágenes de Nano Banana con CometAPI
> Genera imágenes con modelos de imágenes de Gemini a través de CometAPI, incluidas las familias de modelos Nano Banana, y guarda la salida `inlineData` con curl, Python o Node.js.
## Lo que vas a crear
Llamarás a la ruta `generateContent` de imágenes de Gemini a través de CometAPI, solicitarás una salida de imagen de los modelos de imágenes de Gemini, incluidas las familias de modelos Nano Banana, omitirás las partes de imagen `thought` intermedias y guardarás la imagen `inlineData` final.
## Requisitos previos
* Una clave de API de CometAPI almacenada en `COMETAPI_KEY`
* Python 3.10+ con `requests`, o Node.js 18+
* Un model ID de imágenes de Gemini. La referencia de API mantenida usa `gemini-3.1-flash-image-preview` como ejemplo de texto a imagen.
## Clave de API, URL base, autenticación
Usa la ruta de imágenes de Gemini a través de CometAPI:
```text theme={null}
https://api.cometapi.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent
```
Autentícate con `x-goog-api-key`:
```text theme={null}
x-goog-api-key: $COMETAPI_KEY
```
## Ejemplos de código
Usa las pestañas de abajo para ejemplos copiables en cURL, Python y 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"),
);
```
## Explicación del flujo
La generación de imágenes de Gemini es síncrona en esta ruta. La respuesta usa `candidates[].content.parts[]` nativo de Gemini. Las partes pueden incluir texto, imágenes generadas y partes de imagen intermedias donde `thought` es `true`.
Al guardar el resultado, itera por las partes de imagen, ignora `thought: true` y guarda la última imagen `inlineData` restante.
## Parámetros comunes
| Parameter | Use |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| `model` path segment | model ID de imágenes de Gemini en la ruta de la URL. |
| `contents` | Prompt y partes opcionales de imagen de entrada. |
| `generationConfig.responseModalities` | Incluye `IMAGE` cuando necesites salida de imagen. |
| `generationConfig.imageConfig` | Opciones de imagen como relación de aspecto y tamaño de imagen cuando el modelo seleccionado las admita. |
| `tools` | Herramientas opcionales de Gemini. Agrégalas solo cuando la referencia de API documente el flujo de trabajo seleccionado. |
## Solución de problemas / Preguntas frecuentes
No guardes las partes donde `thought` sea `true`. Estas son imágenes intermedias, no la salida final.
Verifica que `generationConfig.responseModalities` incluya `IMAGE` y que el modelo seleccionado admita salida de imagen.
Usa partes de solicitud `inline_data` como se muestra en la guía de imágenes de Gemini, y mantén igual la lógica de análisis de la imagen final.
## Siguientes pasos
* Lee la [referencia de la API de imágenes de Gemini](/api/image/gemini/gemini-generates-image).
* Consulta más ejemplos en [Usar modelos de imágenes de Gemini](/api/image/gemini/generate-image-guide).
* Encuentra los modelos de imágenes disponibles en [Models](/es/overview/models).
* Estima el costo con [Estimar el costo de una solicitud antes de llamar a un modelo](/es/guides/how-to-estimate-cost-before-calling-a-model).