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

# Démarrage rapide de l’API GPT Image : générer des images avec CometAPI

> Générez une image GPT via CometAPI, décodez `b64_json`, et enregistrez le résultat avec curl, Python ou Node.js.

## Ce que vous allez créer

Vous allez appeler `POST /v1/images/generations`, générer une image avec un modèle d’image GPT, décoder le `b64_json` renvoyé, et l’enregistrer en tant que fichier image.

## Prérequis

* Une clé API CometAPI stockée dans `COMETAPI_KEY`
* Python 3.10+ ou Node.js 18+ pour les exemples d’enregistrement de fichier
* Un environnement côté serveur. N’appelez pas la génération d’images depuis du code frontend public avec une clé secrète.

## Clé API, URL de base, authentification

Utilisez le point de terminaison d’image compatible OpenAI :

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

Authentifiez-vous avec un jeton Bearer :

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

## Exemples de code

Utilisez les onglets ci-dessous pour des exemples copiables en cURL, Python et 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>

## Explication du flux

La génération d’images GPT renvoie la réponse complète en une seule requête. Les modèles d’image GPT renvoient les données de l’image en base64 dans `data[0].b64_json`. Décodez cette valeur et écrivez les octets dans un fichier correspondant à `output_format`.

Si vous avez besoin d’une sortie sous forme d’URL, vérifiez si le modèle sélectionné prend en charge les réponses par URL. Les modèles d’image GPT utilisent une sortie base64 dans l’exemple de référence maintenu.

## Paramètres courants

| Parameter       | Use                                                                                      |
| --------------- | ---------------------------------------------------------------------------------------- |
| `model`         | model ID du modèle d’image GPT. L’exemple de référence utilise `gpt-image-2`.            |
| `prompt`        | Description textuelle de l’image à générer.                                              |
| `size`          | Taille de sortie demandée. Les valeurs prises en charge dépendent du modèle sélectionné. |
| `quality`       | Paramètre de qualité pour les modèles qui le prennent en charge.                         |
| `output_format` | Type d’image encodée pour les résultats d’image GPT, comme `jpeg`, `png` ou `webp`.      |

## Dépannage / FAQ

<AccordionGroup>
  <Accordion title="Le fichier enregistré ne s’ouvre pas">
    Vérifiez que vous avez décodé `b64_json` en octets base64 et enregistré l’extension de fichier correspondant à `output_format`.
  </Accordion>

  <Accordion title="Le modèle rejette un paramètre">
    Les paramètres d’image varient selon le modèle. Commencez par l’exemple de référence minimal, puis ajoutez un champ facultatif à la fois.
  </Accordion>

  <Accordion title="La réponse ne contient pas d’URL">
    Utilisez `b64_json` pour les modèles d’image GPT. La sortie URL dépend du modèle.
  </Accordion>
</AccordionGroup>

## Prochaines étapes

* Consultez la [référence de l’API Create image](/api/image/openai/images).
* Trouvez les model IDs des modèles dans [Models](/fr/overview/models).
* Estimez le coût de la requête avec [Estimate request cost before calling a model](/fr/guides/how-to-estimate-cost-before-calling-a-model).
* Gérez les échecs avec [Error codes and retry strategy](/fr/guides/error-codes-and-retry-strategy).