Dokumentacja API GPT Image Hub

Wszystkie punkty końcowe w wersji 1 z wyjątkiem listy modeli wymagają klucza API w nagłówku Authorization. Surowy klucz jest wyświetlany raz w momencie tworzenia; serwer przechowuje tylko skrót.

Authorization: Bearer gih_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Punkt końcowy modeli zwraca identyfikatory modeli, dostawców, obsługiwane współczynniki proporcji, obsługiwane jakości, limity obrazów referencyjnych i kredyty na obraz.

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

Punkt końcowy kredytów zwraca saldo, typ konta i zbliżające się wygaśnięcie kredytów dla użytkownika będącego właścicielem klucza API.

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

Punkt końcowy generowania obrazów domyślnie czeka na zakończenie. Ustaw async na true, aby od razu otrzymać identyfikator generacji, i odpytuj /api/v1/generations/:generationId o wynik. Kredyty są pobierane przed generowaniem u dostawcy i zwracane automatycznie, gdy dostawca zawiedzie lub zwróci mniej obrazów, niż zażądano.

Żądanie JSON

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

Zadanie asynchroniczne

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

Żądanie obrazu referencyjnego

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"

Odpowiedź

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

Użyj identyfikatora zwróconego przez punkt końcowy generowania, aby pobrać zapisany dziennik i adresy URL obrazów. Klucze API mogą odczytywać tylko generacje należące do tego samego użytkownika.

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

• Generowanie synchroniczne w środowisku produkcyjnym może trwać do 800 sekund.
• Wartość n musi mieścić się w przedziale od 1 do 4.
• Obrazy referencyjne obsługują formaty PNG, JPG, JPEG i WebP. Całe żądanie, w tym każdy obraz referencyjny, musi mieć rozmiar poniżej 4.5MB (łączny rozmiar obrazów nie może przekraczać 4MB). Większe żądania są odrzucane przez platformę hostingową z kodem błędu 413 w postaci zwykłego tekstu, zanim dotrą do API, dlatego należy najpierw zmienić rozmiar lub skompresować obrazy.
• Maksymalna liczba obrazów referencyjnych jest określona przez parametr reference_image_limit danego modelu.
• Limity zapytań: 60 żądań generowania na minutę na klucz API oraz 120 na minutę na adres IP. Każda odpowiedź zawiera nagłówki RateLimit-Limit, RateLimit-Remaining i RateLimit-Reset; kod 429 zawiera również Retry-After.
• Aby bezpiecznie ponowić próbę generowania, prześlij nagłówek Idempotency-Key (do 120 znaków). Ponowne użycie tego samego klucza z tym samym kluczem API zwraca pierwotny wynik generowania zamiast ponownego pobierania opłaty.
• Tryb asynchroniczny zwraca 202 z poll_url. Webhooki nie są jeszcze dostępne.