मुख्य सामग्री पर जाएं
POST
/
v1
/
images
/
generations
इमेज जेनरेट करें
curl --request POST \
  --url https://api.dedaluslabs.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>",
  "model": "openai/dall-e-3",
  "n": 1,
  "quality": "standard",
  "response_format": "url",
  "output_format": "png",
  "output_compression": 85,
  "stream": true,
  "partial_images": 0,
  "size": "1024x1024",
  "moderation": "auto",
  "background": "transparent",
  "style": "vivid",
  "user": "<string>"
}
'
{
  "created": 123,
  "data": [
    {
      "url": "<string>",
      "b64_json": "<string>",
      "revised_prompt": "<string>"
    }
  ]
}

प्राधिकरण

Authorization
string
header
आवश्यक

Bearer टोकन के माध्यम से API कुंजी का प्रमाणीकरण

बॉडी

application/json

छवियाँ उत्पन्न करने के लिए किया गया अनुरोध।

prompt
string
आवश्यक

आप जिन छवि/छवियों को बनवाना चाहते हैं, उनका टेक्स्ट विवरण। अधिकतम लंबाई: gpt-image-1 के लिए 32000 वर्ण, dall-e-2 के लिए 1000 वर्ण, और dall-e-3 के लिए 4000 वर्ण है।

उदाहरण:

"A white siamese cat"

model
string | null

image जनरेशन के लिए उपयोग किया जाने वाला model। निम्न में से एक होना चाहिए: openai/dall-e-2, openai/dall-e-3, या openai/gpt-image-1। जब तक gpt-image-1 से जुड़ा कोई विशेष पैरामीटर उपयोग न किया जाए, डिफ़ॉल्ट रूप से openai/dall-e-2 चुना जाता है।

उदाहरण:

"openai/dall-e-3"

n
integer | null

जनरेट की जाने वाली images की संख्या। यह 1 से 10 के बीच होनी चाहिए। dall-e-3 के लिए केवल n=1 ही समर्थित है।

आवश्यक सीमा: 1 <= x <= 10
उदाहरण:

1

quality
enum<string> | null

उत्पन्न की जाने वाली छवि की गुणवत्ता।

  • auto (डिफ़ॉल्ट मान) दिए गए model के लिए स्वचालित रूप से सर्वोत्तम गुणवत्ता चुन लेगा।
  • gpt-image-1 के लिए high, medium और low समर्थित हैं।
  • dall-e-3 के लिए hd और standard समर्थित हैं।
  • dall-e-2 के लिए केवल standard विकल्प उपलब्ध है।
उपलब्ध विकल्प:
auto,
high,
medium,
low,
hd,
standard
उदाहरण:

"standard"

response_format
enum<string> | null

dall-e-2 और dall-e-3 से जनरेट की गई इमेज किस फ़ॉर्मेट में लौटाई जाती हैं। मान निम्न में से एक होना चाहिए: url या b64_json। इमेज जनरेट होने के बाद URLs केवल 60 मिनट तक ही वैध रहते हैं। यह पैरामीटर gpt-image-1 के लिए समर्थित नहीं है, जो हमेशा base64-एन्कोडेड इमेज ही लौटाएगा।

उपलब्ध विकल्प:
url,
b64_json
उदाहरण:

"url"

output_format
enum<string> | null

जिस फ़ॉर्मेट में जनरेट की गई छवियाँ लौटाई जाएँगी। यह पैरामीटर केवल gpt-image-1 के लिए समर्थित है। इसका मान png, jpeg या webp में से एक होना चाहिए।

उपलब्ध विकल्प:
png,
jpeg,
webp
उदाहरण:

"png"

output_compression
integer | null

जनरेट की गई छवियों के लिए संपीड़न स्तर (0–100%)। यह पैरामीटर केवल gpt-image-1 के लिए तब समर्थित है जब आउटपुट फ़ॉर्मेट webp या jpeg हो, और डिफ़ॉल्ट मान 100 होता है।

आवश्यक सीमा: 0 <= x <= 100
उदाहरण:

85

stream
boolean | null

इमेज को स्ट्रीमिंग मोड में जेनरेट करें। डिफ़ॉल्ट मान false है। अधिक जानकारी के लिए Image generation guide देखें। यह पैरामीटर केवल gpt-image-1 के लिए समर्थित है।

उदाहरण:

true

partial_images
integer | null

जेनरेट की जाने वाली आंशिक (partial) इमेजों की संख्या। यह पैरामीटर उन स्ट्रीमिंग प्रतिक्रियाओं (responses) में उपयोग होता है जो आंशिक इमेजें लौटाती हैं। मान (value) 0 से 3 के बीच होना चाहिए। जब इसे 0 पर सेट किया जाता है, तो प्रतिक्रिया एक ही स्ट्रीमिंग इवेंट में भेजी गई एकल इमेज होगी।

ध्यान दें कि यदि पूर्ण इमेज तेज़ी से बन जाती है, तो अंतिम पूर्ण इमेज सभी निर्दिष्ट आंशिक इमेजें भेजे जाने से पहले ही भेजी जा सकती है।

आवश्यक सीमा: 0 <= x <= 3
उदाहरण:

0

size
enum<string> | null

जनरेट की गई छवियों का आकार। gpt-image-1 के लिए आकार इन मानों में से किसी एक पर सेट होना चाहिए: 1024x1024, 1536x1024 (लैंडस्केप), 1024x1536 (पोर्ट्रेट), या auto (डिफ़ॉल्ट मान)। dall-e-2 के लिए: 256x256, 512x512, या 1024x1024; और dall-e-3 के लिए: 1024x1024, 1792x1024, या 1024x1792

उपलब्ध विकल्प:
256x256,
512x512,
1024x1024,
1536x1024,
1024x1536,
1792x1024,
1024x1792,
auto
उदाहरण:

"1024x1024"

moderation
enum<string> | null

gpt-image-1 द्वारा जनरेट की गई छवियों के लिए कंटेंट मॉडरेशन स्तर नियंत्रित करें। इसे या तो low (कम सख्त फ़िल्टरिंग के लिए) या auto (डिफ़ॉल्ट मान) पर सेट होना चाहिए।

उपलब्ध विकल्प:
low,
auto
उदाहरण:

"auto"

background
enum<string> | null

उत्पन्न की गई इमेज के बैकग्राउंड की पारदर्शिता सेट करने की अनुमति देता है। यह पैरामीटर केवल gpt-image-1 के लिए समर्थित है। इसका मान निम्न में से एक होना चाहिए: transparent, opaque या auto (डिफ़ॉल्ट मान)। जब auto उपयोग किया जाता है, तो model स्वतः ही इमेज के लिए सबसे उपयुक्त बैकग्राउंड चुन लेगा।

अगर transparent चुना गया है, तो आउटपुट फ़ॉर्मेट को पारदर्शिता सपोर्ट करना चाहिए, इसलिए उसे या तो png (डिफ़ॉल्ट मान) या webp पर सेट किया जाना चाहिए।

उपलब्ध विकल्प:
transparent,
opaque,
auto
उदाहरण:

"transparent"

style
enum<string> | null

बनाई जाने वाली छवियों की शैली। यह पैरामीटर केवल dall-e-3 के लिए समर्थित है। मान अनिवार्य रूप से vivid या natural में से एक होना चाहिए। vivid के उपयोग पर model आमतौर पर अत्यधिक यथार्थवादी (hyper‑real) और नाटकीय छवियाँ बनाने की ओर झुकता है। natural के उपयोग पर model अपेक्षाकृत स्वाभाविक, कम hyper‑real दिखने वाली छवियाँ उत्पन्न करता है।

उपलब्ध विकल्प:
vivid,
natural
उदाहरण:

"vivid"

user
string | null

आपके एंड‑यूज़र (end‑user) का एक विशिष्ट पहचानकर्ता, जो OpenAI को दुरुपयोग की निगरानी और उसका पता लगाने में मदद कर सकता है। अधिक जानें

प्रतिक्रिया

सफल प्रतिक्रिया

इमेज जेनरेशन से प्राप्त रिस्पॉन्स।

created
integer
आवश्यक

वह UNIX टाइमस्टैम्प जब इमेजें जेनरेट की गई थीं।

data
Image · object[]
आवश्यक

जेनरेट की गई इमेजों की सूची।