> ## 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.

# Inicio rápido de la API de imágenes GPT: genera imágenes con CometAPI

> Genera una imagen GPT mediante CometAPI, decodifica `b64_json` y guarda el resultado con curl, Python o Node.js.

## Lo que vas a crear

Llamarás a `POST /v1/images/generations`, generarás una imagen con un modelo de imágenes GPT, decodificarás el `b64_json` devuelto y la guardarás como un archivo de imagen.

## Requisitos previos

* Una clave de API de CometAPI almacenada en `COMETAPI_KEY`
* Python 3.10+ o Node.js 18+ para los ejemplos de guardado de archivos
* Un entorno del lado del servidor. No llames a la generación de imágenes desde código frontend público con una clave secreta.

## Clave de API, URL base, autenticación

Usa el endpoint de imágenes compatible con OpenAI:

```text theme={null}
https://api.cometapi.com/v1/images/generations
```

Autentícate con un token Bearer:

```text theme={null}
Authorization: Bearer $COMETAPI_KEY
```

## Ejemplos de código

Usa las pestañas de abajo para ver ejemplos copiables en cURL, Python y Node.js.

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.cometapi.com/v1/images/generations \
    -H "Authorization: Bearer $COMETAPI_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "gpt-image-2",
      "prompt": "A paper boat floating on calm water at sunrise.",
      "quality": "low",
      "size": "1024x1024",
      "output_format": "jpeg"
    }'
  ```

  ```python Python theme={null}
  import base64
  import os
  from openai import OpenAI

  client = OpenAI(
      api_key=os.environ["COMETAPI_KEY"],
      base_url="https://api.cometapi.com/v1",
  )

  image = client.images.generate(
      model="gpt-image-2",
      prompt="A paper boat floating on calm water at sunrise.",
      quality="low",
      size="1024x1024",
      output_format="jpeg",
  )

  image_base64 = image.data[0].b64_json
  with open("cometapi-gpt-image.jpeg", "wb") as file:
      file.write(base64.b64decode(image_base64))
  ```

  ```javascript Node.js theme={null}
  import fs from "node:fs/promises";
  import OpenAI from "openai";

  const client = new OpenAI({
    apiKey: process.env.COMETAPI_KEY,
    baseURL: "https://api.cometapi.com/v1",
  });

  const image = await client.images.generate({
    model: "gpt-image-2",
    prompt: "A paper boat floating on calm water at sunrise.",
    quality: "low",
    size: "1024x1024",
    output_format: "jpeg",
  });

  const imageBase64 = image.data[0].b64_json;
  await fs.writeFile("cometapi-gpt-image.jpeg", Buffer.from(imageBase64, "base64"));
  ```
</CodeGroup>

## Explicación del flujo

La generación de imágenes GPT devuelve la respuesta completada en una sola solicitud. Los modelos de imágenes GPT devuelven datos de imagen en base64 en `data[0].b64_json`. Decodifica ese valor y escribe los bytes en un archivo que coincida con `output_format`.

Si necesitas una salida por URL, comprueba si el modelo seleccionado admite respuestas con URL. Los modelos de imágenes GPT usan salida base64 en el ejemplo de referencia mantenido.

## Parámetros comunes

| Parameter       | Use                                                                                     |
| --------------- | --------------------------------------------------------------------------------------- |
| `model`         | model ID del modelo de imágenes GPT. El ejemplo de referencia usa `gpt-image-2`.        |
| `prompt`        | Descripción de texto de la imagen que se va a generar.                                  |
| `size`          | Tamaño de salida solicitado. Los valores admitidos dependen del modelo seleccionado.    |
| `quality`       | Configuración de calidad para los modelos que la admiten.                               |
| `output_format` | Tipo de imagen codificada para resultados de imágenes GPT, como `jpeg`, `png` o `webp`. |

## Solución de problemas / Preguntas frecuentes

<AccordionGroup>
  <Accordion title="El archivo guardado no se abre">
    Confirma que decodificaste `b64_json` como bytes base64 y guardaste la extensión de archivo que coincide con `output_format`.
  </Accordion>

  <Accordion title="El modelo rechaza un parámetro">
    Los parámetros de imagen varían según el modelo. Comienza con el ejemplo de referencia mínimo y luego añade un campo opcional a la vez.
  </Accordion>

  <Accordion title="La respuesta no tiene URL">
    Usa `b64_json` para los modelos de imágenes GPT. La salida por URL depende del modelo.
  </Accordion>
</AccordionGroup>

## Próximos pasos

* Lee la [referencia de la API Create image](/api/image/openai/images).
* Encuentra los model IDs de imagen en [Models](/es/overview/models).
* Estima el costo de la solicitud con [Estimar el costo de una solicitud antes de llamar a un modelo](/es/guides/how-to-estimate-cost-before-calling-a-model).
* Gestiona los errores con [Códigos de error y estrategia de reintento](/es/guides/error-codes-and-retry-strategy).