API-Referenz

Verwende die offene API von GPT Image 2, um Bilder programmgesteuert zu generieren und zu bearbeiten. Authentifiziere dich mit deinem eigenen API-Schlüssel, zahle mit Credits und erhalte Ergebnisse per Polling.

Übersicht

Die GPT Image 2 API ermöglicht es dir, Bilder über dein GPT Image 2-Konto zu generieren. Anfragen verwenden deinen Website-API-Schlüssel und werden über unsere serverseitige Kie-Integration weitergeleitet.

Erstelle einen API-Schlüssel unter:

/settings/apikeys

Rufe dann auf:

POST /api/v1/images/generations
GET /api/v1/images/tasks/{task_id}

Die Bildgenerierung ist asynchron. Der Erstellungs-Endpunkt gibt eine Task-ID zurück, und der Task-Endpunkt gibt die finalen Bild-URLs zurück, sobald die Generierung erfolgreich abgeschlossen ist.

Authentifizierung

Sende deinen GPT Image 2 API-Schlüssel als Bearer-Token:

Authorization: Bearer sk-xxx

Lege API-Schlüssel nicht in browserseiti­gem Code offen. Verwende sie in deinem Backend, in Skripten oder serverlosen Funktionen.

Abrechnung

Die API-Nutzung verbraucht dieselben Credits wie die Web-App:

VorgangCredit-Kosten
Bildgenerierung10 Credits pro Bild

Schlägt eine Anbieteranfrage fehl, bevor eine Aufgabe angenommen wird, werden die verbrauchten Credits automatisch durch den Task-Fehlerprozess erstattet.

Bildgenerierung erstellen

Endpunkt

POST https://gpt-image-2.art/api/v1/images/generations

Anfrage-Body

ParameterTypPflichtBeschreibung
modelstringNeinVerwende gpt-image-2. Interne Aliase gpt-image-2-text-to-image und gpt-image-2-image-to-image werden ebenfalls unterstützt.
promptstringJaTextbeschreibung des Bildes. Pflichtfeld, sofern keine image_urls angegeben sind.
image_urlsstring[]NeinReferenzbilder-URLs für die Bild-zu-Bild-Generierung.
nintegerNeinAnzahl der zu generierenden Bilder, von 1 bis 10. Standard: 1.
sizestringNeinEines von 1024x1024, 1536x1024, 1024x1536, 1920x1088, 1088x1920, 3824x2160, 2160x3824 oder auto.
qualitystringNeinAnbieter-Qualitätsoption, zum Beispiel high oder auto.
output_formatstringNeinpng, jpeg oder webp, sofern vom Anbieter unterstützt.
response_formatstringNeinNur url wird unterstützt.
userstringNeinOptionaler Endbenutzer-Bezeichner für dein eigenes Tracking.

Text-zu-Bild-Beispiel

curl https://gpt-image-2.art/api/v1/images/generations \
  -H "Authorization: Bearer $GPT_IMAGE_2_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A cinematic product photo of a matte black coffee bag on a marble counter",
    "size": "1536x1024",
    "quality": "high",
    "n": 1
  }'

Bild-zu-Bild-Beispiel

curl https://gpt-image-2.art/api/v1/images/generations \
  -H "Authorization: Bearer $GPT_IMAGE_2_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "Keep the product unchanged and place it on a clean studio background",
    "image_urls": ["https://example.com/product.png"],
    "size": "1024x1024",
    "n": 1
  }'

Erstellungs-Antwort

{
  "id": "8f6d9f87-1b3f-4f89-bdfb-3df8e77b7af3",
  "object": "image.generation",
  "created": 1714000000,
  "model": "gpt-image-2-text-to-image",
  "status": "pending",
  "credits": 10,
  "data": []
}

Speichere die id und frage den Task-Endpunkt regelmäßig ab.

Bildaufgabe abfragen

Endpunkt

GET https://gpt-image-2.art/api/v1/images/tasks/{task_id}

Beispiel

curl https://gpt-image-2.art/api/v1/images/tasks/8f6d9f87-1b3f-4f89-bdfb-3df8e77b7af3 \
  -H "Authorization: Bearer $GPT_IMAGE_2_API_KEY"

Erfolgsantwort

{
  "id": "8f6d9f87-1b3f-4f89-bdfb-3df8e77b7af3",
  "object": "image.generation",
  "created": 1714000000,
  "model": "gpt-image-2-text-to-image",
  "status": "succeeded",
  "credits": 10,
  "data": [
    {
      "url": "https://..."
    }
  ]
}

Mögliche status-Werte:

StatusBedeutung
pendingAufgabe ist in der Warteschlange.
processingAnbieter generiert das Bild.
succeededBild-URLs sind in data verfügbar.
failedGenerierung fehlgeschlagen.
canceledGenerierung wurde abgebrochen.

JavaScript-Beispiel

const apiKey = process.env.GPT_IMAGE_2_API_KEY;

const createRes = await fetch(
  'https://gpt-image-2.art/api/v1/images/generations',
  {
    method: 'POST',
    headers: {
      Authorization: `Bearer ${apiKey}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      model: 'gpt-image-2',
      prompt:
        'A premium skincare bottle on wet stone with soft studio lighting',
      size: '1024x1024',
      n: 1,
    }),
  }
);

const task = await createRes.json();

let result = task;
while (['pending', 'processing'].includes(result.status)) {
  await new Promise((resolve) => setTimeout(resolve, 3000));
  const queryRes = await fetch(
    `https://gpt-image-2.art/api/v1/images/tasks/${task.id}`,
    {
      headers: {
        Authorization: `Bearer ${apiKey}`,
      },
    }
  );
  result = await queryRes.json();
}

console.log(result.data);

Fehlerformat

Fehler folgen dem OpenAI-Stil:

{
  "error": {
    "message": "Invalid API key provided.",
    "type": "authentication_error",
    "param": null,
    "code": "invalid_api_key"
  }
}

Verwandte Ressourcen