Документация API GPT Image Hub

Для всех конечных точек версии 1, кроме списка моделей, требуется ключ API в заголовке Authorization. Необработанный ключ отображается один раз во время создания; сервер хранит только хеш.

Authorization: Bearer gih_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Конечная точка моделей возвращает идентификаторы моделей, поставщиков, поддерживаемые соотношения сторон, поддерживаемое качество, ограничения на эталонные изображения и количество кредитов на изображение.

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

Конечная точка кредитов возвращает баланс, тип учетной записи и ближайшую дату сгорания кредитов для пользователя, которому принадлежит ключ API.

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

Конечная точка генерации изображений по умолчанию ожидает завершения. Установите async в true, чтобы сразу получить id генерации, и опрашивайте /api/v1/generations/:generationId для получения результата. Кредиты списываются до генерации у провайдера и автоматически возвращаются, если провайдер завершился с ошибкой или вернул меньше изображений, чем запрошено.

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

Асинхронная задача

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

Запрос с эталонным изображением

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"

Ответ

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

Используйте id, возвращенный конечной точкой генерации, чтобы получить сохраненный журнал и URL изображений. Ключи API могут читать только генерации, принадлежащие тому же пользователю.

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

• Синхронная генерация в продакшене может выполняться до 800 секунд.
• Значение n должно быть от 1 до 4.
• Для референсных изображений поддерживаются форматы PNG, JPG, JPEG и WebP. Весь запрос, включая каждое референсное изображение, должен быть менее 4.5MB (суммарный размер изображений — до 4MB). Более крупные запросы отклоняются платформой хостинга с простым текстовым ответом 413 еще до того, как достигнут API, поэтому сначала измените размер или сожмите изображения.
• Максимальное количество референсных изображений определяется параметром reference_image_limit конкретной модели.
• Ограничения частоты запросов: 60 запросов на генерацию в минуту на один ключ API и 120 в минуту на один IP-адрес. Каждый ответ содержит заголовки RateLimit-Limit, RateLimit-Remaining и RateLimit-Reset; ответ 429 также содержит Retry-After.
• Для безопасного повтора генерации отправьте заголовок Idempotency-Key (до 120 символов). Повторный запрос с тем же ключом для того же ключа API вернет исходную генерацию без повторного списания средств.
• Асинхронный режим возвращает 202 с poll_url. Вебхуки пока не поддерживаются.