GPT Image Hub API-Dokumentation

Alle v1-Endpunkte außer der Modellauflistung erfordern einen API-Schlüssel im Authorization-Header. Der Rohschlüssel wird nur einmal bei der Erstellung angezeigt; der Server speichert nur einen Hash.

Authorization: Bearer gih_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Der Modellendpunkt gibt Modell-IDs, Anbieter, unterstützte Seitenverhältnisse, unterstützte Qualitäten, Referenzbildgrenzen und Credits pro Bild zurück.

curl https://www.gptimagehub.com/api/v1/models

curl https://www.gptimagehub.com/api/v1/images/generations \
  -H "Authorization: Bearer gih_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "z-image-turbo",
    "prompt": "A cinematic product photo with premium studio lighting",
    "size": "1024x1024",
    "quality": "high",
    "n": 1
  }'

Der Credits-Endpunkt gibt das Guthaben, den Kontotyp und den bevorstehenden Credit-Ablauf für den Benutzer zurück, dem der API-Schlüssel gehört.

curl https://www.gptimagehub.com/api/v1/credits \
  -H "Authorization: Bearer gih_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Der Bildgenerierungsendpunkt wartet standardmäßig auf den Abschluss. Setzen Sie async auf true, um sofort eine Generierungs-ID zu erhalten, und fragen Sie das Ergebnis über /api/v1/generations/:generationId ab. Credits werden vor der Generierung beim Anbieter abgebucht und automatisch erstattet, wenn der Anbieter fehlschlägt oder weniger Bilder als angefordert zurückgibt.

JSON-Anfrage

curl https://www.gptimagehub.com/api/v1/images/generations \
  -H "Authorization: Bearer gih_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A cinematic product photo of a transparent perfume bottle on black marble",
    "size": "1024x1024",
    "quality": "high",
    "n": 1
  }'

Asynchrone Aufgabe

curl https://www.gptimagehub.com/api/v1/images/generations \
  -H "Authorization: Bearer gih_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-1042-hero-image" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "A cinematic product photo with premium studio lighting",
    "size": "1024x1024",
    "quality": "high",
    "n": 1,
    "async": true
  }'

{
  "object": "image_generation",
  "id": "clx_generation_log_id",
  "status": "queued",
  "model": "gpt-image-2",
  "aspect_ratio": "1:1",
  "quality": "1K",
  "created_at": "2026-04-30T08:00:00.000Z",
  "images": [],
  "usage": {
    "credits": 0,
    "credits_requested": 7
  },
  "poll_url": "https://www.gptimagehub.com/api/v1/generations/clx_generation_log_id"
}

Referenzbildanfrage

curl https://www.gptimagehub.com/api/v1/images/generations \
  -H "Authorization: Bearer gih_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -F "model=gpt-image-2" \
  -F "prompt=Use the reference image and render it as a premium studio product shot" \
  -F "size=1024x1024" \
  -F "quality=high" \
  -F "n=1" \
  -F "reference_image=@./reference.png"

Antwort

{
  "object": "image_generation",
  "id": "clx_generation_log_id",
  "status": "succeeded",
  "model": "gpt-image-2",
  "aspect_ratio": "1:1",
  "quality": "1K",
  "images": [
    {
      "id": "clx_image_id",
      "object": "image",
      "url": "https://cdn.example.com/generations/user/image.png",
      "created_at": "2026-04-30T08:00:00.000Z"
    }
  ],
  "usage": {
    "credits": 7
  },
  "balance": {
    "credits": 113,
    "account_type": "PRO",
    "next_expiration": null
  }
}

Verwenden Sie die vom Generierungsendpunkt zurückgegebene ID, um das gespeicherte Protokoll und die Bild-URLs abzurufen. API-Schlüssel können nur Generierungen lesen, die demselben Benutzer gehören.

curl https://www.gptimagehub.com/api/v1/generations/clx_generation_log_id \
  -H "Authorization: Bearer gih_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

{
  "error": {
    "message": "Invalid request body",
    "code": "invalidRequest"
  }
}

• Die synchrone Generierung kann in der Produktivumgebung bis zu 800 Sekunden dauern.
• n muss zwischen 1 und 4 liegen.
• Referenzbilder unterstützen PNG, JPG, JPEG und WebP. Die gesamte Anfrage, einschließlich jedes Referenzbilds, muss unter 4.5MB bleiben (die Bilder dürfen insgesamt maximal 4MB groß sein). Größere Anfragen werden von der Hosting-Plattform mit einem Plain-Text-413 abgewiesen, bevor sie die API erreichen. Ändern Sie daher vorab die Bildgröße oder komprimieren Sie die Bilder.
• Die maximale Anzahl an Referenzbildern wird durch das jeweilige reference_image_limit des Modells bestimmt.
• Rate-Limits: 60 Generierungsanfragen pro Minute pro API-Key und 120 pro Minute pro IP-Adresse. Jede Antwort enthält die Header RateLimit-Limit, RateLimit-Remaining und RateLimit-Reset; ein 429 enthält zusätzlich Retry-After.
• Um eine Generierung sicher zu wiederholen, senden Sie einen Idempotency-Key-Header (bis zu 120 Zeichen). Bei erneuter Verwendung desselben Schlüssels mit demselben API-Key wird die ursprüngliche Generierung zurückgegeben, anstatt erneut abgerechnet zu werden.
• Der asynchrone Modus gibt 202 mit poll_url zurück. Webhooks sind derzeit noch nicht verfügbar.