API Hop

दस्तावेज़

API Hop दस्तावेज़

GPT-Image-2 चित्र जनरेशन

gpt-image-2 से चित्र बनाएँ या संदर्भ चित्र संपादित करें और वर्तमान JSON उत्तर या SSE कनेक्शन में परिणाम पाएँ।

POSThttps://api.apihop.ai/openai/v1/images/generations

gpt-image-2 उत्पाद चित्र, पोस्टर मसौदे, चित्रण, सोशल सामग्री, उच्च-रिज़ॉल्यूशन दृश्य, शैली स्थानांतरण और कई संदर्भों के संयोजन के लिए चित्र जनरेशन तथा संदर्भ-चित्र संपादन समर्थित करता है।

text
POST https://api.apihop.ai/openai/v1/images/generations

प्रमाणीकरण

http
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

त्वरित शुरुआत

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:1
  • 4:3
  • 16:9
  • 9:16
  • 1024x1024
  • 1536x1024
  • 1024x1536
  • 2048x2048
  • 2048x1152
  • 3840x2160
  • 2160x3840
  • auto
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डिफ़ॉल्ट: false

Server-Sent Events लौटाने हैं या नहीं।

संदर्भ चित्र और संपादन

संदर्भ-चित्र संपादन उसी JSON एंडपॉइंट से होता है। image_urls जोड़ें और prompt में बताएँ क्या रखना और बदलना है:

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

कई संदर्भ विषय, संरचना या दृश्य शैली दे सकते हैं:

json
{
  "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 उत्पाद चित्र

json
{
  "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 पोस्टर

json
{
  "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 शामिल होता है।

json
{
  "created": 1777270000,
  "data": [
    {
      "url": "https://image.example.com/generated/123456789012345678/0.png"
    }
  ],
  "usage": {
    "input_tokens": 20,
    "output_tokens": 1234,
    "total_tokens": 1254
  }
}

स्ट्रीमिंग उत्तर

text
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:11024x10242048x2048सुझाया नहीं जाता
3:21536x10242048x1360सुझाया नहीं जाता
2:31024x15361360x2048सुझाया नहीं जाता
4:31024x7682048x1536सुझाया नहीं जाता
3:4768x10241536x2048सुझाया नहीं जाता
16:91536x8642048x11523840x2160
9:16864x15361152x20482160x3840
21:92016x8642688x11523840x1648
9:21864x20161152x26881648x3840

त्रुटि उत्तर

पूरी कोड सूची, प्रोटोकॉल अंतर और निदान चरणों के लिए त्रुटि कोड और निदान देखें।

json
{
  "code": 10000,
  "message": "prompt is required",
  "type": "api_error"
}

सामान्य त्रुटियाँ:

  • 400: आवश्यक पैरामीटर अनुपस्थित या असमर्थित संयोजन
  • 401: प्रमाणीकरण विफल या API कुंजी गलत
  • 402: अपर्याप्त शेष राशि
  • 404: मॉडल मौजूद नहीं या चालू नहीं
  • 429: दर सीमा पार
  • 5xx: सेवा अस्थायी रूप से अनुपलब्ध या चित्र जनरेशन विफल