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

# Guida rapida all'API GPT Image: genera immagini con CometAPI

> Genera un'immagine GPT tramite CometAPI, decodifica `b64_json` e salva il risultato con curl, Python o Node.js.

## Cosa creerai

Eseguirai una chiamata a `POST /v1/images/generations`, genererai un'immagine con un modello di immagini GPT, decodificherai il valore `b64_json` restituito e lo salverai come file immagine.

## Prerequisiti

* Una chiave API CometAPI archiviata in `COMETAPI_KEY`
* Python 3.10+ o Node.js 18+ per gli esempi di salvataggio dei file
* Un ambiente server-side. Non chiamare la generazione di immagini da codice frontend pubblico con una chiave segreta.

## Chiave API, URL di base, autenticazione

Usa l'endpoint immagini compatibile con OpenAI:

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

Autenticati con un token Bearer:

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

## Esempi di codice

Usa le schede qui sotto per esempi copiabili in cURL, Python e 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>

## Spiegazione del flusso

La generazione di immagini GPT restituisce la risposta completata in una sola richiesta. I modelli di immagini GPT restituiscono i dati dell'immagine in base64 in `data[0].b64_json`. Decodifica quel valore e scrivi i byte in un file che corrisponda a `output_format`.

Se ti serve un output URL, verifica se il modello selezionato supporta risposte URL. I modelli di immagini GPT usano l'output base64 nell'esempio di riferimento mantenuto.

## Parametri comuni

| Parameter       | Use                                                                                                |
| --------------- | -------------------------------------------------------------------------------------------------- |
| `model`         | model ID del modello di immagini GPT. L'esempio di riferimento usa `gpt-image-2`.                  |
| `prompt`        | Descrizione testuale dell'immagine da generare.                                                    |
| `size`          | Dimensione di output richiesta. I valori supportati dipendono dal modello selezionato.             |
| `quality`       | Impostazione di qualità per i modelli che la supportano.                                           |
| `output_format` | Tipo di immagine codificata per i risultati delle immagini GPT, ad esempio `jpeg`, `png` o `webp`. |

## Risoluzione dei problemi / FAQ

<AccordionGroup>
  <Accordion title="Il file salvato non si apre">
    Verifica di aver decodificato `b64_json` come byte base64 e di aver salvato il file con l'estensione corrispondente a `output_format`.
  </Accordion>

  <Accordion title="Il modello rifiuta un parametro">
    I parametri delle immagini variano in base al modello. Inizia con l'esempio di riferimento minimo, poi aggiungi un campo opzionale alla volta.
  </Accordion>

  <Accordion title="La risposta non contiene alcun URL">
    Usa `b64_json` per i modelli di immagini GPT. L'output URL è specifico del modello.
  </Accordion>
</AccordionGroup>

## Passaggi successivi

* Leggi il [riferimento API Create image](/api/image/openai/images).
* Trova i model ID per le immagini in [Models](/it/overview/models).
* Stima il costo della richiesta con [Stimare il costo di una richiesta prima di chiamare un modello](/it/guides/how-to-estimate-cost-before-calling-a-model).
* Gestisci gli errori con [Codici di errore e strategia di retry](/it/guides/error-codes-and-retry-strategy).