GPT Image Hub API दस्तावेज़

मॉडल सूची को छोड़कर सभी v1 एंडपॉइंट के लिए Authorization हेडर में API कुंजी की आवश्यकता होती है। पूरी कुंजी केवल बनाते समय एक बार दिखाई जाती है; सर्वर केवल उसका हैश संग्रहीत करता है।

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"

छवि जनरेशन एंडपॉइंट डिफ़ॉल्ट रूप से काम पूरा होने तक प्रतीक्षा करता है। तुरंत generation id पाने के लिए async को true पर सेट करें और परिणाम के लिए /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 का उपयोग करके उसका सहेजा गया लॉग और छवि URLs प्राप्त करें। 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"
  }
}

• Production पर synchronous generation अधिकतम 800 सेकंड तक चल सकता है।
• n 1 और 4 के बीच होना चाहिए।
• Reference images PNG, JPG, JPEG और WebP को सपोर्ट करती हैं। प्रत्येक reference image सहित पूरा request 4.5MB के अंदर होना चाहिए (कुल मिलाकर images को 4MB से कम रखें)। बड़े requests API तक पहुँचने से पहले ही होस्टिंग प्लेटफ़ॉर्म द्वारा plain-text 413 के साथ रिजेक्ट कर दिए जाते हैं, इसलिए पहले images को resize या compress करें।
• अधिकतम reference image की संख्या प्रत्येक मॉडल के reference_image_limit द्वारा निर्धारित की जाती है।
• Rate limits: प्रति API key प्रति मिनट 60 generation requests और प्रति IP address प्रति मिनट 120। प्रत्येक response में RateLimit-Limit, RateLimit-Remaining और RateLimit-Reset headers होते हैं; 429 में Retry-After भी शामिल होता है।
• Generation को सुरक्षित रूप से retry करने के लिए, एक Idempotency-Key header (अधिकतम 120 कैरेक्टर तक) भेजें। उसी API key के साथ वही key दोहराने पर दोबारा चार्ज करने के बजाय मूल generation ही प्राप्त होता है।
• Async मोड poll_url के साथ 202 लौटाता है। Webhooks अभी उपलब्ध नहीं हैं।