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

# GPT Image API-snelstart: genereer afbeeldingen met CometAPI

> Genereer een GPT-afbeelding via CometAPI, decodeer b64_json en sla het resultaat op met curl, Python of Node.js.

## Wat je gaat bouwen

Je roept `POST /v1/images/generations` aan, genereert één afbeelding met een GPT-afbeeldingsmodel, decodeert de geretourneerde `b64_json` en slaat die op als een afbeeldingsbestand.

## Vereisten

* Een CometAPI API-sleutel opgeslagen in `COMETAPI_KEY`
* Python 3.10+ of Node.js 18+ voor voorbeelden van het opslaan van bestanden
* Een server-side omgeving. Roep afbeeldingsgeneratie niet aan vanuit publieke frontendcode met een geheime sleutel.

## API-sleutel, basis-URL, authenticatie

Gebruik het OpenAI-compatibele afbeeldingeneindpunt:

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

Authenticeer met een Bearer-token:

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

## Codevoorbeelden

Gebruik de tabs hieronder voor kopieerbare voorbeelden in cURL, Python en 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>

## Uitleg van de flow

Het genereren van GPT-afbeeldingen retourneert de voltooide response in één request. GPT-afbeeldingsmodellen retourneren base64-afbeeldingsdata in `data[0].b64_json`. Decodeer die waarde en schrijf de bytes naar een bestand dat overeenkomt met `output_format`.

Als je URL-output nodig hebt, controleer dan of het geselecteerde model URL-responses ondersteunt. GPT-afbeeldingsmodellen gebruiken base64-output in het onderhouden referentievoorbeeld.

## Algemene parameters

| Parameter       | Gebruik                                                                                  |
| --------------- | ---------------------------------------------------------------------------------------- |
| `model`         | GPT-afbeeldingsmodel ID. Het referentievoorbeeld gebruikt `gpt-image-2`.                 |
| `prompt`        | Tekstbeschrijving van de te genereren afbeelding.                                        |
| `size`          | Gevraagde outputgrootte. Ondersteunde waarden hangen af van het geselecteerde model.     |
| `quality`       | Kwaliteitsinstelling voor modellen die dit ondersteunen.                                 |
| `output_format` | Gecodeerd afbeeldingstype voor GPT-afbeeldingsresultaten, zoals `jpeg`, `png` of `webp`. |

## Probleemoplossing / FAQ

<AccordionGroup>
  <Accordion title="Het opgeslagen bestand kan niet worden geopend">
    Controleer of je `b64_json` hebt gedecodeerd als base64-bytes en de bestandsextensie hebt opgeslagen die overeenkomt met `output_format`.
  </Accordion>

  <Accordion title="Het model weigert een parameter">
    Afbeeldingsparameters verschillen per model. Begin met het minimale referentievoorbeeld en voeg daarna telkens één optioneel veld toe.
  </Accordion>

  <Accordion title="De response heeft geen URL">
    Gebruik `b64_json` voor GPT-afbeeldingsmodellen. URL-output is modelspecifiek.
  </Accordion>
</AccordionGroup>

## Volgende stappen

* Lees de [Create image API-reference](/api/image/openai/images).
* Vind image model ID's in [Models](/nl/overview/models).
* Schat de requestkosten met [Schat requestkosten voordat je een model aanroept](/nl/guides/how-to-estimate-cost-before-calling-a-model).
* Handel fouten af met [Foutcodes en retry-strategie](/nl/guides/error-codes-and-retry-strategy).