एक छवि उत्पन्न करें

ShareAI पर वर्तमान में सक्षम और आपके क्रेडेंशियल द्वारा अनुमत एक छवि मॉडल का उपयोग करें। मॉडल यह निर्धारित करता है कि कौन से आकार, गुणवत्ता स्तर और आउटपुट विकल्प समर्थित हैं।

एक अनुरोध भेजें#

curl --fail-with-body --request POST \
  "https://api.shareai.now/api/v1/images/generations" \
  -H "Authorization: Bearer $SHAREAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "YOUR_IMAGE_MODEL",
  "prompt": "A quiet forest painted in watercolor.",
  "n": 1,
  "size": "1024x1024"
}'

import json
import os
import urllib.request

headers = {"Authorization": "Bearer " + os.environ["SHAREAI_API_KEY"]}
headers["Content-Type"] = "application/json"
payload = {'model': 'YOUR_IMAGE_MODEL', 'prompt': 'A quiet forest painted in watercolor.', 'n': 1, 'size': '1024x1024'}
data = json.dumps(payload).encode()
request = urllib.request.Request('https://api.shareai.now/api/v1/images/generations', data=data, headers=headers, method='POST')
with urllib.request.urlopen(request, timeout=180) as response:
    print(json.load(response))

const url = "https://api.shareai.now/api/v1/images/generations";
const headers: Record = {
  Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`,
};
headers["Content-Type"] = "application/json";
const payload = {
  "model": "YOUR_IMAGE_MODEL",
  "prompt": "A quiet forest painted in watercolor.",
  "n": 1,
  "size": "1024x1024"
};
const response = await fetch(url, { method: "POST", headers, body: JSON.stringify(payload) });
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());

अनुरोध फ़ील्ड्स#

छवि पढ़ें#

लौटाए गए data प्रविष्टियों का निरीक्षण करें। मॉडल और अनुरोधित प्रारूप के आधार पर, एक प्रविष्टि में HTTPS छवि URL या base64 छवि डेटा होता है। वास्तविक लौटाए गए प्रारूप का उपयोग करें; यह न मानें कि हर प्रदाता URL लौटाता है। API आपके लिए लौटाए गए छवि URL डाउनलोड नहीं करता।

आकार और समय सीमा#

अनुरोध सिंक्रोनस हैं। संयुक्त टेक्स्ट 256 KiB तक सीमित है, प्रदाता कॉल 120 सेकंड तक और प्रतिक्रिया 2 MiB तक। बड़े base64 चित्र उस प्रतिक्रिया सीमा को पार कर सकते हैं। एक उपयुक्त आउटपुट आकार चुनें या एक मॉडल जो URL आउटपुट का समर्थन करता हो।

सावधानीपूर्वक पुनः प्रयास करें#

एक छवि उत्पन्न करना उपयोग को बढ़ा सकता है। टाइमआउट या अस्पष्ट नेटवर्क विफलता के बाद, पुनः प्रयास करने से पहले गतिविधि की जांच करें; अनुरोध को दोहराने से एक और छवि उत्पन्न हो सकती है और शुल्क लग सकता है। API प्रदाता को सबमिशन के बाद स्वचालित रूप से छवि अनुरोध को पुनः प्रयास नहीं करता।

समर्थित संचालन#

यह रूट टेक्स्ट से छवियां उत्पन्न करता है। छवि संपादन, विविधताएं, मल्टीपार्ट अपलोड और स्ट्रीमिंग छवि जनरेशन समर्थित नहीं हैं। वर्तमान बिलिंग के लिए एक संगत मॉडल/प्रदाता टोकन-उपयोग अनुबंध की आवश्यकता होती है; केवल प्रति-छवि प्रदाता अनुपलब्ध हो सकते हैं।

ग्राहक प्राधिकरण का उपयोग करें#

एक स्वीकृत OAuth फ्लो के लिए, एक्सेस टोकन को Bearer के रूप में भेजें। खाता-वित्त पोषित छवि जनरेशन के लिए surcharge और एक स्वीकृत उपयोग योजना की आवश्यकता होती है। सभी मॉडल, प्रदाता और खाता प्रतिबंध लागू रहते हैं।