> ## 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-Schnellstart: Bilder mit CometAPI generieren

> Generieren Sie ein GPT-Bild über CometAPI, dekodieren Sie `b64_json` und speichern Sie das Ergebnis mit curl, Python oder Node.js.

## Was Sie erstellen werden

Sie rufen `POST /v1/images/generations` auf, generieren ein Bild mit einem GPT-Bildmodell, dekodieren das zurückgegebene `b64_json` und speichern es als Bilddatei.

## Voraussetzungen

* Ein CometAPI API-Schlüssel, gespeichert in `COMETAPI_KEY`
* Python 3.10+ oder Node.js 18+ für Beispiele zum Speichern von Dateien
* Eine serverseitige Umgebung. Rufen Sie die Bildgenerierung nicht aus öffentlichem Frontend-Code mit einem geheimen Schlüssel auf.

## API-Schlüssel, Basis-URL, Authentifizierung

Verwenden Sie den OpenAI-kompatiblen Bild-Endpoint:

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

Authentifizieren Sie sich mit einem Bearer-Token:

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

## Codebeispiele

Verwenden Sie die Tabs unten für kopierbare Beispiele in cURL, Python und 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>

## Erklärung des Ablaufs

Die GPT-Bildgenerierung gibt die vollständige Antwort in einer einzigen Anfrage zurück. GPT-Bildmodelle geben base64-Bilddaten in `data[0].b64_json` zurück. Dekodieren Sie diesen Wert und schreiben Sie die Bytes in eine Datei, die zu `output_format` passt.

Wenn Sie eine URL-Ausgabe benötigen, prüfen Sie, ob das ausgewählte Modell URL-Antworten unterstützt. GPT-Bildmodelle verwenden im gepflegten Referenzbeispiel eine base64-Ausgabe.

## Häufige Parameter

| Parameter       | Verwendung                                                                        |
| --------------- | --------------------------------------------------------------------------------- |
| `model`         | GPT-Bildmodell model ID. Das Referenzbeispiel verwendet `gpt-image-2`.            |
| `prompt`        | Textbeschreibung des zu generierenden Bildes.                                     |
| `size`          | Angeforderte Ausgabegröße. Unterstützte Werte hängen vom ausgewählten Modell ab.  |
| `quality`       | Qualitätseinstellung für Modelle, die dies unterstützen.                          |
| `output_format` | Kodierter Bildtyp für GPT-Bildergebnisse, zum Beispiel `jpeg`, `png` oder `webp`. |

## Fehlerbehebung / FAQ

<AccordionGroup>
  <Accordion title="Die gespeicherte Datei lässt sich nicht öffnen">
    Stellen Sie sicher, dass Sie `b64_json` als base64-Bytes dekodiert und die Dateiendung gespeichert haben, die zu `output_format` passt.
  </Accordion>

  <Accordion title="Das Modell lehnt einen Parameter ab">
    Bildparameter unterscheiden sich je nach Modell. Beginnen Sie mit dem minimalen Referenzbeispiel und fügen Sie dann jeweils ein optionales Feld hinzu.
  </Accordion>

  <Accordion title="Die Antwort enthält keine URL">
    Verwenden Sie `b64_json` für GPT-Bildmodelle. Die URL-Ausgabe ist modellspezifisch.
  </Accordion>
</AccordionGroup>

## Nächste Schritte

* Lesen Sie die [API-Referenz zu Create image](/api/image/openai/images).
* Finden Sie image model IDs unter [Models](/de/overview/models).
* Schätzen Sie die Anfragekosten mit [Anfragekosten vor dem Aufruf eines Modells schätzen](/de/guides/how-to-estimate-cost-before-calling-a-model).
* Behandeln Sie Fehler mit [Fehlercodes und Retry-Strategie](/de/guides/error-codes-and-retry-strategy).