API Hop दस्तावेज़
GPT-Image-2 चित्र जनरेशन
gpt-image-2 से चित्र बनाएँ या संदर्भ चित्र संपादित करें और वर्तमान JSON उत्तर या SSE कनेक्शन में परिणाम पाएँ।
https://api.apihop.ai/openai/v1/images/generationsgpt-image-2 उत्पाद चित्र, पोस्टर मसौदे, चित्रण, सोशल सामग्री, उच्च-रिज़ॉल्यूशन दृश्य, शैली स्थानांतरण और कई संदर्भों के संयोजन के लिए चित्र जनरेशन तथा संदर्भ-चित्र संपादन समर्थित करता है।
POST https://api.apihop.ai/openai/v1/images/generationsप्रमाणीकरण
Authorization: Bearer YOUR_API_KEY
Content-Type: application/jsonत्वरित शुरुआत
{
"model": "gpt-image-2",
"prompt": "A minimal black wireless earbud product poster on a white background, clean studio lighting, no text",
"n": 1,
"size": "2048x1152",
"resolution": "2k",
"quality": "low"
}कीमत तुलना का दायरा
API Hop के प्रकाशित 1K / 2K / 4K चित्र स्तर *API Hop की बिक्री कीमतें* हैं, OpenAI की आधिकारिक निश्चित प्रति-चित्र दरें नहीं। OpenAI मूल्य दस्तावेज़ चित्र/टेक्स्ट टोकन और संसाधन स्तर के शुल्क बताता है; वास्तविक लागत आकार, गुणवत्ता, संदर्भ इनपुट और आउटपुट पर निर्भर है। केवल दोनों में 1k या 2k होने से तुलना करना समान आधार पर छूट की गणना नहीं है।
बिना आधार बचत का दावा न हो, इसलिए GPT Image 2 के लिए पुराना समेकित प्रदाता USD per image संदर्भ और छूट बैज जानबूझकर छिपाए गए हैं। API Hop की कीमत दिखती रहती है और बिलिंग अनुबंध अपरिवर्तित है। भविष्य में प्रमाणित तुलना के लिए सही मॉडल, एंडपॉइंट, चित्र गुणवत्ता, आकार, इनपुट शर्तें, आधिकारिक स्रोत URL और संदर्भ सत्यापन तारीख दर्ज करें। भुगतान वाले कॉल से पहले अपने खाते की प्रभावी कीमत जाँचें।
अनुरोध बॉडी
modelstringआवश्यकडिफ़ॉल्ट: gpt-image-2चित्र मॉडल ID। gpt-image-2 इस्तेमाल करें।
promptstringआवश्यकचित्र प्रॉम्प्ट। विषय, दृश्य, संरचना, शैली, सामग्री, रोशनी, रंग और पाठ दिखना चाहिए या नहीं, बताएँ।
nintegerडिफ़ॉल्ट: 1बनाए जाने वाले चित्रों की संख्या। वर्तमान gpt-image-2 सार्वजनिक अनुबंध केवल 1 समर्थित करता है। अन्य मान आरक्षण से पहले 400 लौटाते हैं।
sizestringडिफ़ॉल्ट: autoआउटपुट पक्षानुपात या पिक्सेल आयाम।
सामान्य मान:
1:14:316:99:161024x10241536x10241024x15362048x20482048x11523840x21602160x3840auto
qualitystringडिफ़ॉल्ट: autoआउटपुट गुणवत्ता। समर्थित मान low, medium, high और auto हैं।
resolutionstringडिफ़ॉल्ट: 1kआउटपुट रिज़ॉल्यूशन स्तर। समर्थित मान 1k, 2k और 4k हैं।
इसे size के साथ जोड़ सकते हैं, जैसे size: "16:9" और resolution: "2k"।
image_urlsarray<string>निर्देश-आधारित संपादन या कई चित्रों के संयोजन के लिए संदर्भ चित्र।
- अधिकतम 16 चित्र।
- हर चित्र अधिकतम 20 MB; कुल इनपुट सीमा 256 MB।
- सार्वजनिक रूप से पहुँच योग्य चित्र URL समर्थित हैं।
data:image/...;base64,...जैसे Base64 data URI समर्थित हैं।- उसी ऐरे में URL और base64 data URI मिला सकते हैं।
output_formatstringडिफ़ॉल्ट: pngआउटपुट प्रारूप। समर्थित मान png, jpeg और webp हैं।
streambooleanडिफ़ॉल्ट: falseServer-Sent Events लौटाने हैं या नहीं।
संदर्भ चित्र और संपादन
संदर्भ-चित्र संपादन उसी JSON एंडपॉइंट से होता है। image_urls जोड़ें और prompt में बताएँ क्या रखना और बदलना है:
{
"model": "gpt-image-2",
"prompt": "Keep the product unchanged, replace the background with a dark blue studio, and add soft rim lighting",
"image_urls": [
"https://example.com/product.png"
],
"size": "1:1",
"resolution": "2k"
}कई संदर्भ विषय, संरचना या दृश्य शैली दे सकते हैं:
{
"model": "gpt-image-2",
"prompt": "Use the product from the first image and the composition from the second image to create a clean ecommerce hero image",
"image_urls": [
"https://example.com/product.png",
"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
],
"size": "4:3",
"resolution": "2k"
}वर्तमान सार्वजनिक अनुबंध की सीमाएँ:
image_urlsसे पूरे चित्र का संपादन, शैली स्थानांतरण और कई संदर्भों का संयोजन समर्थित है।- अलग
POST https://api.apihop.ai/openai/v1/images/editsरूट नहीं है। multipart/form-dataअपलोड स्वीकार नहीं हैं। पहले स्थानीय चित्र base64 data URI में बदलें या पहुँच योग्य URL पर अपलोड करें।- मास्क-आधारित inpainting समर्थित नहीं।
mask,mask_urlयाmaskUrlभेजने पर आरक्षण से पहले400लौटता है।
अनुरोध उदाहरण
1:1 उत्पाद चित्र
{
"model": "gpt-image-2",
"prompt": "A transparent glass cup on a light gray background, commercial product photography, soft shadow, no text",
"n": 1,
"size": "1024x1024",
"resolution": "1k",
"quality": "low",
"output_format": "png"
}16:9 पोस्टर
{
"model": "gpt-image-2",
"prompt": "A futuristic city night poster with neon lights, wet streets, cinematic composition, no text",
"n": 1,
"size": "2048x1152",
"resolution": "2k",
"quality": "medium",
"output_format": "jpeg"
}परिणाम कैसे लौटते हैं
यह OpenAI-संगत एंडपॉइंट बाद की पोलिंग के लिए पहले data.jobId वाला कार्य सबमिशन उत्तर नहीं लौटाता:
stream: falseपर वर्तमान HTTP अनुरोध पूर्णता तक प्रतीक्षा करता है और
JSON उत्तर में चित्र URL लौटाता है।
stream: trueपर वर्तमान SSE कनेक्शनimage_generation.completed
और [DONE] तक खुला रहता है।
इस एंडपॉइंट का परिणाम पाने के लिए GET https://api.apihop.ai/v1/jobs/{id} न लें। असिंक्रोनस जॉब प्राप्त करें तभी इस्तेमाल करें जब असिंक्रोनस निर्माण एंडपॉइंट स्पष्ट रूप से jobId लौटाए।
नॉन-स्ट्रीमिंग उत्तर
उत्तर में चित्र URL होते हैं। अपस्ट्रीम रूट मापन जानकारी दे तो usage शामिल होता है।
{
"created": 1777270000,
"data": [
{
"url": "https://image.example.com/generated/123456789012345678/0.png"
}
],
"usage": {
"input_tokens": 20,
"output_tokens": 1234,
"total_tokens": 1254
}
}स्ट्रीमिंग उत्तर
event: image_generation.completed
data: {"type":"image_generation.completed","data":[{"index":0,"url":"https://image.example.com/generated/123456789012345678/0.png"}],"usage":{"input_tokens":20,"output_tokens":1234,"total_tokens":1254}}
data: [DONE]आकार संदर्भ
| लक्ष्य अनुपात | 1K सुझाव | 2K सुझाव | 4K सुझाव |
|---|---|---|---|
1:1 | 1024x1024 | 2048x2048 | सुझाया नहीं जाता |
3:2 | 1536x1024 | 2048x1360 | सुझाया नहीं जाता |
2:3 | 1024x1536 | 1360x2048 | सुझाया नहीं जाता |
4:3 | 1024x768 | 2048x1536 | सुझाया नहीं जाता |
3:4 | 768x1024 | 1536x2048 | सुझाया नहीं जाता |
16:9 | 1536x864 | 2048x1152 | 3840x2160 |
9:16 | 864x1536 | 1152x2048 | 2160x3840 |
21:9 | 2016x864 | 2688x1152 | 3840x1648 |
9:21 | 864x2016 | 1152x2688 | 1648x3840 |
त्रुटि उत्तर
पूरी कोड सूची, प्रोटोकॉल अंतर और निदान चरणों के लिए त्रुटि कोड और निदान देखें।
{
"code": 10000,
"message": "prompt is required",
"type": "api_error"
}सामान्य त्रुटियाँ:
400: आवश्यक पैरामीटर अनुपस्थित या असमर्थित संयोजन401: प्रमाणीकरण विफल या API कुंजी गलत402: अपर्याप्त शेष राशि404: मॉडल मौजूद नहीं या चालू नहीं429: दर सीमा पार5xx: सेवा अस्थायी रूप से अनुपलब्ध या चित्र जनरेशन विफल