OneMux/दस्तावेज़/इमेज मॉडल

इमेज मॉडल

OneMux इमेज मॉडल API के ज़रिए इमेज जनरेट और संपादित करें।

API का विवरण

इमेज मॉडल के लिए अलग Images API का उपयोग करें। इमेज जनरेशन अनुरोध /v1/chat/completions पर न भेजें।

  • इमेज जनरेशन: POST https://api.onemux.net/v1/images/generations
  • इमेज संपादन: POST https://api.onemux.net/v1/images/edits
  • प्रमाणीकरण: Authorization: Bearer YOUR_API_KEY
  • मॉडल: मौजूदा मॉडल सूची API से मिला वास्तविक इमेज मॉडल ID इस्तेमाल करें

पहले उपलब्ध मौजूदा मॉडल प्राप्त करें:

curl https://api.onemux.net/v1/models \
  -H "Authorization: Bearer $ONEMUX_API_KEY"

इमेज मॉडल जनरेशन, संपादन, संदर्भ इमेज, आकार, गुणवत्ता और आउटपुट फ़ॉर्मैट जैसे पैरामीटरों का समर्थन करता है या नहीं, यह मॉडल सूची और वास्तविक अपस्ट्रीम क्षमताओं पर निर्भर करता है।

इमेज जनरेशन

टेक्स्ट से इमेज बनाने का अनुरोध भेजने के लिए /v1/images/generations का उपयोग करें।

curl https://api.onemux.net/v1/images/generations \
  -H "Authorization: Bearer $ONEMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_IMAGE_MODEL_ID",
    "prompt": "一只坐在窗边的橘猫,午后自然光,写实摄影风格",
    "size": "1024x1024",
    "quality": "medium"
  }'

आम पैरामीटर:

पैरामीटरआवश्यकविवरण
modelहाँवर्तमान में उपलब्ध इमेज मॉडल ID
promptहाँइमेज की सामग्री का विवरण
sizeनहींइमेज का आकार; समर्थित सीमा मॉडल पर निर्भर करती है
qualityनहींइमेज की गुणवत्ता; समर्थित मान मॉडल पर निर्भर करते हैं
nनहींजनरेट की जाने वाली इमेज की संख्या; समर्थित सीमा मॉडल पर निर्भर करती है
response_formatनहींb64_json या url; केवल समर्थित मॉडल पर उपलब्ध
backgroundनहींपारदर्शी या अपारदर्शी बैकग्राउंड; केवल समर्थित मॉडल पर उपलब्ध
output_formatनहींpng, jpeg, webp; केवल समर्थित मॉडल पर उपलब्ध

किसी मॉडल के समर्थित पैरामीटर सीधे दूसरे इमेज मॉडल पर इस्तेमाल न करें। model_not_found, invalid_model या असमर्थित पैरामीटर की त्रुटि मिलने पर, पहले मॉडल ID और मॉडल की क्षमताओं की पुष्टि करें।

इमेज संपादन

मौजूदा इमेज संपादित करने के लिए /v1/images/edits का उपयोग करें। आम तौर पर OpenAI के साथ संगत इमेज मॉडल में इमेज अपलोड करने के लिए multipart/form-data इस्तेमाल होता है:

curl https://api.onemux.net/v1/images/edits \
  -H "Authorization: Bearer $ONEMUX_API_KEY" \
  -F "model=YOUR_IMAGE_MODEL_ID" \
  -F "image[]=@input.png" \
  -F "prompt=将背景改为浅蓝色,保持主体和文字不变" \
  -F "size=1024x1024"

कई संदर्भ इमेज अपलोड करने के लिए image[] को बार-बार भेजा जा सकता है, उदाहरण के लिए:

-F "image[]=@person.png" \
-F "image[]=@product.png"

इमेज की संख्या, इमेज फ़ॉर्मैट, मास्क, संदर्भ इमेज URL और JSON संपादन फ़ॉर्मैट मॉडल और अपस्ट्रीम चैनल पर निर्भर करते हैं। इन पैरामीटरों का उपयोग केवल तभी करें, जब मॉडल स्पष्ट रूप से उनका समर्थन करता हो।

Python से कॉल करना

from openai import OpenAI
import os

client = OpenAI(
    api_key=os.environ["ONEMUX_API_KEY"],
    base_url="https://api.onemux.net/v1",
)

result = client.images.generate(
    model="YOUR_IMAGE_MODEL_ID",
    prompt="一张简洁的蓝色科技风产品海报",
    size="1024x1024",
)

print(result.data[0].b64_json or result.data[0].url)

इमेज संपादन के लिए आम तौर पर multipart फ़ाइल सीधे सबमिट करनी पड़ती है। अगर Python SDK का मौजूदा संस्करण लक्षित मॉडल के संपादन पैरामीटरों का समर्थन नहीं करता, तो ऊपर दिए गए cURL अनुरोध का उपयोग करें।

लौटाया गया परिणाम

सफल प्रतिक्रिया में आम तौर पर data ऐरे शामिल होता है:

{
  "created": 1760000000,
  "data": [
    {
      "b64_json": "iVBORw0KGgo..."
    }
  ]
}

कुछ मॉडल अनुरोध में response_format को url पर सेट करने पर इमेज URL लौटाते हैं:

{
  "created": 1760000000,
  "data": [
    {
      "url": "https://example.com/generated-image.png"
    }
  ]
}

Base64 मिलने पर, वास्तविक इमेज फ़ॉर्मैट के अनुसार फ़ाइल सहेजें। URL मिलने पर, अस्थायी पते की समय-सीमा समाप्त होने से पहले उसे डाउनलोड करके स्वयं सहेज लें।

बिलिंग

सभी इमेज मॉडल के लिए Token-आधारित बिलिंग लागू नहीं होती। OneMux मॉडल के लिए वर्तमान में प्रकाशित बिलिंग नियमों के अनुसार शुल्क लेता है। इनमें शामिल हो सकते हैं:

  • जनरेट की गई इमेज की संख्या के आधार पर शुल्क
  • इमेज के रिज़ॉल्यूशन या गुणवत्ता स्तर के आधार पर शुल्क
  • इमेज इनपुट, आउटपुट Token या अन्य अपस्ट्रीम उपयोग के आधार पर शुल्क

वास्तविक कीमत, बिलिंग इकाई और समर्थित विनिर्देशों के लिए मॉडल कैटलॉग में संबंधित मॉडल का मौजूदा विवरण देखें। अनुरोध विफल होने पर आम तौर पर सफल परिणाम से जुड़ा इमेज शुल्क नहीं लगता, लेकिन वास्तविक व्यवहार पेज पर दिखाए गए विवरण और सर्वर की प्रतिक्रिया पर निर्भर करता है।

आम सवाल

बातचीत वाले API से इमेज क्यों नहीं बना सकते?

इमेज मॉडल के लिए अलग Images रूट है। /v1/chat/completions या किसी अन्य असंगत API पर अनुरोध भेजने से यह त्रुटि मिल सकती है कि मॉडल उस एंडपॉइंट का समर्थन नहीं करता, या पैरामीटर अमान्य है।

मॉडल का नाम खोज में मिलता है, फिर भी अनुरोध क्यों विफल होता है?

जाँचें कि मॉडल इमेज जनरेशन या इमेज संपादन की अनुमति देता है या नहीं, मौजूदा API Key के पास आवश्यक अनुमति है या नहीं, अनुरोध पैरामीटर उस मॉडल की समर्थित सीमा में हैं या नहीं, और संबंधित अपस्ट्रीम चैनल उपलब्ध है या नहीं।

Base64 इमेज लिंक के बजाय क्यों मिलता है?

अलग-अलग मॉडल या response_format सेटिंग से लौटाया जाने वाला फ़ॉर्मैट तय होता है। b64_json मिलने पर क्लाइंट में उसे डिकोड करके सहेजना होगा; url मिलने पर लौटाए गए पते से इमेज डाउनलोड करनी होगी।

इमेज जनरेशन धीमा हो तो क्या करें?

उच्च रिज़ॉल्यूशन, उच्च गुणवत्ता या जटिल संपादन वाले अनुरोधों में अधिक समय लग सकता है। क्लाइंट में उचित अनुरोध टाइमआउट सेट करें। क्लाइंट टाइमआउट होने पर वही अनुरोध दोबारा सबमिट न करें, ताकि डुप्लिकेट कार्य या शुल्क न लगे।

GPT Image 2.6: SVG, GIF और जटिलता

GPT Image 2.6 सीरीज़ में SVG आउटपुट, GIF ऐनिमेशन आउटपुट और complexity पैरामीटर जोड़े गए हैं। ये सुविधाएँ केवल उन मॉडल और अपस्ट्रीम चैनलों पर उपलब्ध हैं जो इनका समर्थन करते हैं।

SVG आउटपुट

SVG का उपयोग इमेज जनरेशन के लिए होता है, इमेज संपादन के लिए नहीं। जनरेशन API कॉल करते समय output_format को svg पर सेट करें और n को 1 पर सेट करें। प्रतिक्रिया में इमेज डेटा Base64 में होगा। इसे डिकोड करके .svg फ़ाइल के रूप में सहेजें।

{
  "model": "YOUR_GPT_IMAGE_2_6_MODEL_ID",
  "prompt": "一个简洁的蓝色几何图形标志",
  "output_format": "svg",
  "n": 1
}

कुछ अपस्ट्रीम कॉन्फ़िगरेशन में अतिरिक्त svg ऑब्जेक्ट की भी आवश्यकता हो सकती है, जैसे svg.model। इसे केवल तभी जोड़ें, जब मॉडल या चैनल के विवरण में स्पष्ट रूप से इसकी माँग हो। सभी इमेज मॉडल और चैनल SVG का समर्थन नहीं करते।

GIF ऐनिमेशन आउटपुट

इस सुविधा का समर्थन करने वाले GPT Image 2.6 मॉडल में इमेज जनरेशन API पर output_format को gif पर सेट किया जा सकता है। मॉडल के समर्थन की स्थिति में, ऐनिमेशन फ़्रेम की संख्या और हर फ़्रेम की अवधि सेट करने के लिए frame_count और frame_duration_ms का उपयोग करें। GIF जनरेशन की सुविधा है; यह न मानें कि इमेज संपादन API भी GIF लौटा सकता है।

{
  "model": "YOUR_GPT_IMAGE_2_6_MODEL_ID",
  "prompt": "一只蓝色小鸟循环拍打翅膀的动画",
  "output_format": "gif",
  "frame_count": 6,
  "frame_duration_ms": 200
}

जटिलता पैरामीटर

GPT Image 2.6 सीरीज़ complexity का समर्थन करती है: low, medium, high। साधारण बदलावों के लिए कम जटिलता आज़माएँ। टेक्स्ट से भरी या जटिल लेआउट वाली इमेज के लिए अधिक जटिलता आज़माई जा सकती है। यह quality से अलग पैरामीटर है। जटिलता अधिक होने पर जनरेशन धीमा हो सकता है।

{
  "model": "YOUR_GPT_IMAGE_2_6_MODEL_ID",
  "prompt": "一张细节丰富的城市街景编辑插画",
  "complexity": "high",
  "quality": "high"
}

ऊपर दिए गए पैरामीटर सभी मॉडल पर लागू नहीं होते। अगर API बताए कि कोई पैरामीटर समर्थित नहीं है, तो वैकल्पिक पैरामीटर हटा दें या चुने गए मॉडल और चैनल की क्षमताओं की पुष्टि करें।