GPT Image Hub API ドキュメント

モデル リストを除くすべての v1 エンドポイントでは、Authorization ヘッダーに API キーが必要です。生のキーは作成時に 1 回表示されます。サーバーにはハッシュのみが保存されます。

Authorization: Bearer gih_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

モデル エンドポイントは、モデル ID、プロバイダー、サポートされているアスペクト比、サポートされている品質、参照画像の制限、および画像ごとのクレジットを返します。

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 に設定すると generation 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未満に抑えてください）。これを超えるリクエストはAPIに到達する前にホスティングプラットフォームによってプレーンテキストの413で拒否されるため、あらかじめ画像をリサイズまたは圧縮してください。
• 参照画像の最大数は、各モデルのreference_image_limitによって定義されます。
• レート制限: APIキーごとに1分あたり60回の生成リクエスト、IPアドレスごとに1分あたり120回です。すべてのレスポンスにはRateLimit-Limit、RateLimit-Remaining、RateLimit-Resetヘッダーが付与され、429の場合はRetry-Afterも付与されます。
• 生成を安全に再試行するには、Idempotency-Keyヘッダー（最大120文字）を送信してください。同じAPIキーで同じキーを繰り返し送信した場合、再課金されることなく元の生成結果が返されます。
• 非同期モードではpoll_urlを含む202が返されます。Webhookは現在まだ利用できません。