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/apikeysRufe 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-xxxLege API-Schlüssel nicht in browserseitigem Code offen. Verwende sie in deinem Backend, in Skripten oder serverlosen Funktionen.
Abrechnung
Die API-Nutzung verbraucht dieselben Credits wie die Web-App:
| Vorgang | Credit-Kosten |
|---|---|
| Bildgenerierung | 10 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/generationsAnfrage-Body
| Parameter | Typ | Pflicht | Beschreibung |
|---|---|---|---|
model | string | Nein | Verwende gpt-image-2. Interne Aliase gpt-image-2-text-to-image und gpt-image-2-image-to-image werden ebenfalls unterstützt. |
prompt | string | Ja | Textbeschreibung des Bildes. Pflichtfeld, sofern keine image_urls angegeben sind. |
image_urls | string[] | Nein | Referenzbilder-URLs für die Bild-zu-Bild-Generierung. |
n | integer | Nein | Anzahl der zu generierenden Bilder, von 1 bis 10. Standard: 1. |
size | string | Nein | Eines von 1024x1024, 1536x1024, 1024x1536, 1920x1088, 1088x1920, 3824x2160, 2160x3824 oder auto. |
quality | string | Nein | Anbieter-Qualitätsoption, zum Beispiel high oder auto. |
output_format | string | Nein | png, jpeg oder webp, sofern vom Anbieter unterstützt. |
response_format | string | Nein | Nur url wird unterstützt. |
user | string | Nein | Optionaler 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:
| Status | Bedeutung |
|---|---|
pending | Aufgabe ist in der Warteschlange. |
processing | Anbieter generiert das Bild. |
succeeded | Bild-URLs sind in data verfügbar. |
failed | Generierung fehlgeschlagen. |
canceled | Generierung 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
- Preise & Credits — Credit-Kosten pro Aufruf und Credit-Pakete
- Prompting-Leitfaden — Bessere Ergebnisse aus API-Aufrufen
- Anwendungsfälle — Reale API-Integrationsmuster
- Showcase-Galerie — Sehen Sie, was mit GPT Image 2 möglich ist
- OpenAI Image API Dokumentation — Offizielle Upstream-Referenz für Nutzer mit eigenem OpenAI-Key