GPT Image Hub API Dokümanları

Model listesi dışındaki tüm v1 uç noktaları, Authorization başlığında bir API anahtarı gerektirir. Ham anahtar, oluşturma sırasında bir kez gösterilir; sunucu yalnızca bir karma saklar.

Authorization: Bearer gih_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Modeller uç noktası, model kimliklerini, sağlayıcıları, desteklenen en boy oranlarını, desteklenen nitelikleri, referans görüntü sınırlarını ve görüntü başına krediyi döndürür.

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
  }'

Kredi uç noktası, API anahtarına sahip olan kullanıcının bakiyesini, hesap türünü ve yaklaşan kredi son kullanma tarihini döndürür.

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

Görüntü oluşturma uç noktası varsayılan olarak işlemin tamamlanmasını bekler. Hemen bir oluşturma kimliği almak için async değerini true yapın ve sonuç için /api/v1/generations/:generationId adresini yoklayın. Krediler sağlayıcıdaki oluşturmadan önce tahsil edilir; sağlayıcı başarısız olursa veya istenenden az görsel döndürürse otomatik olarak iade edilir.

JSON isteği

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
  }'

Asenkron görev

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"
}

Referans görseli isteği

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"

Yanıt

{
  "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
  }
}

Kaydedilen günlüğü ve görsel URL'lerini almak için oluşturma uç noktasının döndürdüğü kimliği kullanın. API anahtarları yalnızca aynı kullanıcıya ait oluşturmaları okuyabilir.

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"
  }
}

• Senkron üretim, prodüksiyon ortamında 800 saniyeye kadar sürebilir.
• n, 1 ile 4 arasında olmalıdır.
• Referans görseller PNG, JPG, JPEG ve WebP formatlarını destekler. Her bir referans görsel de dahil olmak üzere isteğin tamamı 4.5MB altında kalmalıdır (görsellerin toplamını 4MB altında tutun). Daha büyük istekler API'ye ulaşmadan önce barındırma platformu tarafından düz metin bir 413 ile reddedilir; bu nedenle görselleri önce yeniden boyutlandırın veya sıkıştırın.
• Maksimum referans görsel sayısı, her modelin reference_image_limit değeri tarafından tanımlanır.
• İstek sınırları: API anahtarı başına dakikada 60 ve IP adresi başına dakikada 120 üretim isteği. Her yanıt RateLimit-Limit, RateLimit-Remaining ve RateLimit-Reset başlıklarını taşır; 429 yanıtı ayrıca Retry-After başlığını da taşır.
• Bir üretimi güvenli bir şekilde yeniden denemek için bir Idempotency-Key başlığı (120 karaktere kadar) gönderin. Aynı anahtarı aynı API anahtarıyla tekrarlamak, tekrar ücretlendirmek yerine orijinal üretimi döndürür.
• Asenkron mod, poll_url ile birlikte 202 döndürür. Webhook desteği henüz mevcut değildir.