छवियां उत्पन्न करें
समकालिक JSON प्रतिक्रिया में डेटा में छवि परिणाम शामिल हैं।.
इस पेज पर
https://api.shareai.now/api/v1/imagesछवियां उत्पन्न करें
- बेस URL
https://api.shareai.now- प्रमाणीकरण
- Bearer API कुंजी या स्वीकृत OAuth एक्सेस टोकन
- आवश्यक स्कोप
inferenceormonetization_gateway
समकालिक JSON प्रतिक्रिया में छवि परिणाम शामिल हैं data. । उपनाम /api/v1/images/generations भी समर्थित है। आकार, रिज़ॉल्यूशन, aspect_ratio, गुणवत्ता और आउटपुट प्रारूप जैसे विकल्प चयनित मॉडल पर निर्भर करते हैं। प्रतिक्रियाएं 2 MiB तक सीमित हैं; आवश्यकता होने पर छवि संख्या या आकार कम करें। लौटाई गई छवियां प्रत्येक पक्ष में 8192 पिक्सल तक सीमित हैं।.
शुरू करने से पहले#
अपने सर्वर पर SHAREAI_API_KEY सेट करें और मॉडल प्लेसहोल्डर को वर्तमान में सक्षम मॉडल से बदलें। ब्राउज़र कोड में कभी भी API कुंजी को उजागर न करें। मॉडल, खाता, क्रेडेंशियल और प्रोवाइडर सभी को इस ऑपरेशन की अनुमति देनी चाहिए। नीचे दिए गए वैकल्पिक सेटिंग्स के लिए मॉडल समर्थन की आवश्यकता है; API सुरक्षा सीमाएँ यह वादा नहीं करतीं कि हर मॉडल हर मान का समर्थन करेगा।.
एक अनुरोध भेजें#
cURL
curl --fail-with-body --request POST "https://api.shareai.now/api/v1/images" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "YOUR_ENABLED_IMAGES_MODEL",
"prompt": "A quiet forest painted in watercolor.",
"n": 1
}'Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_IMAGES_MODEL',
'prompt': 'A quiet forest painted in watercolor.',
'n': 1}
headers = {'Content-Type': 'application/json'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/images', data=json.dumps(payload).encode(), headers=headers, method="POST")
with urllib.request.urlopen(request, timeout=180) as response:
result = json.load(response)
print(result)TypeScript
const response = await fetch("https://api.shareai.now/api/v1/images", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_IMAGES_MODEL",
"prompt": "A quiet forest painted in watercolor.",
"n": 1
}),
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
console.log(result);अनुरोध फ़ील्ड्स#
| फ़ील्ड | प्रकार | अर्थ और सीमाएँ |
|---|---|---|
model आवश्यक | स्ट्रिंग | सटीक सक्षम सार्वजनिक मॉडल पहचानकर्ता। इस ऑपरेशन को घोषित करना चाहिए और आपके क्रेडेंशियल द्वारा अनुमत होना चाहिए।. |
prompt आवश्यक | स्ट्रिंग | गैर-खाली जनरेशन प्रॉम्प्ट, अधिकतम 256 KiB UTF-8 टेक्स्ट।. |
n | पूर्णांक | वैकल्पिक छवि संख्या, 1–10; डिफ़ॉल्ट 1। आपका मॉडल कम संख्या की अनुमति दे सकता है।. |
size | स्ट्रिंग | मॉडल-समर्थित आउटपुट आकार, अधिकतम 100 वर्ण, उदाहरण के लिए 1024×1024। हर मॉडल इस विकल्प का समर्थन नहीं करता।. |
resolution | स्ट्रिंग | मॉडल-समर्थित रिज़ॉल्यूशन चयनकर्ता, अधिकतम 100 वर्ण; प्रकाशित टैरिफ संस्करण से मेल खाना चाहिए।. |
aspect_ratio | स्ट्रिंग | मॉडल-समर्थित aspect ratio चयनकर्ता, अधिकतम 100 वर्ण।. |
quality | स्ट्रिंग | मॉडल-समर्थित गुणवत्ता चयनकर्ता, अधिकतम 100 वर्ण; एक अलग दर का चयन कर सकता है।. |
response_format | स्ट्रिंग | मॉडल-समर्थित प्रतिक्रिया प्रारूप, अधिकतम 100 वर्ण। ऑपरेशन यह निर्धारित करता है कि परिणाम JSON है या बाइनरी।. |
output_format | स्ट्रिंग | मॉडल-समर्थित आउटपुट एन्कोडिंग चयनकर्ता, अधिकतम 100 वर्ण।. |
background | स्ट्रिंग | मॉडल द्वारा समर्थित होने पर वैकल्पिक छवि पृष्ठभूमि सेटिंग।. |
seed | पूर्णांक | वैकल्पिक मॉडल-समर्थित बीज। वीडियो के लिए गैर-नकारात्मक पूर्णांक की आवश्यकता होती है; पुनरुत्पादन निष्पादक पर निर्भर करता है।. |
input_references | ऐरे | अधिकतम 16 टाइप की गई image_url भागों के साथ image_url.url को एक HTTPS URL या समर्थित छवि डेटा URL पर सेट करें। मॉडल समर्थन आवश्यक है।. |
provider | ऑब्जेक्ट | वैकल्पिक प्रोवाइडर रूटिंग प्राथमिकताएँ। स्वीकृत प्रोवाइडर टैग के लिए provider.only का उपयोग करें, मॉडल ID में प्रीफिक्स के रूप में नहीं। खाता और क्रेडेंशियल प्रतिबंध अभी भी लागू होते हैं।. |
परिणाम पढ़ें#
सफलता HTTP 200 के साथ JSON लौटाती है। समकालिक JSON प्रतिक्रिया में छवि परिणाम शामिल हैं data. । उपनाम /api/v1/images/generations भी समर्थित है। आकार, रिज़ॉल्यूशन, aspect_ratio, गुणवत्ता और आउटपुट प्रारूप जैसे विकल्प चयनित मॉडल पर निर्भर करते हैं। प्रतिक्रियाएं 2 MiB तक सीमित हैं; आवश्यकता होने पर छवि संख्या या आकार कम करें। लौटाई गई छवियां प्रत्येक पक्ष में 8192 पिक्सल तक सीमित हैं।.
बिलिंग इकाइयाँ#
छवि टैरिफ उत्पन्न छवियों, मापे गए मेगापिक्सल, इनपुट संदर्भों, अनुरोधों या प्रदाता-रिपोर्टेड टोकन का उपयोग कर सकते हैं। एक छवि URL छवि-आकार माप नहीं है। मेगापिक्सल टैरिफ को लौटाई गई छवि आयामों की आवश्यकता होती है; उन मार्गों के लिए base64 आउटपुट का उपयोग करें।.
Console से सटीक सक्षम मॉडल पहचानकर्ता चुनें। इसका घोषित ऑपरेशन और इनपुट/आउटपुट क्षमताएँ इस एंडपॉइंट से मेल खानी चाहिए; एक टेक्स्ट चैट मॉडल को किसी अन्य ऑपरेशन के लिए प्रतिस्थापित नहीं किया जा सकता। आपके क्रेडेंशियल, प्रोवाइडर और खाता प्रतिबंध अभी भी लागू होते हैं।.
मूल्य निर्धारण और उपयोग#
दरें चयनित मॉडल, प्रोवाइडर, इकाइयों और वेरिएंट के लिए EUR AI क्रेडिट में प्रकाशित की जाती हैं। केवल इसकी सक्रिय टैरिफ में शामिल आयामों का शुल्क लिया जाता है। एक अनुमान निष्पादन से पहले क्रेडिट आरक्षित करता है; अंतिम शुल्क मापे गए उपयोग का उपयोग करते हैं। कीमतें रिज़ॉल्यूशन, आउटपुट फॉर्मेट या उपयोग बैंड पर निर्भर हो सकती हैं। अंतिम ShareAI डेबिट के लिए Console Usage की जाँच करें। अपस्ट्रीम लागत फ़ील्ड और मीडिया बाइट्स को आविष्कृत टोकन गिनती में परिवर्तित नहीं किया जाता।.
एक्सेस और त्रुटियाँ#
उपयोग करें inference अनुमोदित नेटवर्क-लागत इन्फरेंस के लिए monetization_gateway अनुमोदित Builder मार्कअप और स्वीकृत बिलिंग शर्तों के लिए। केवल पहचान-आधारित एक्सेस खर्च को अधिकृत नहीं करता। सत्यापन, मॉडल प्राधिकरण, अपर्याप्त क्रेडिट, दर सीमाएँ और निष्पादन विफलताएँ एक संरचित error. लौटाती हैं। टाइमआउट या अनिश्चित सबमिशन के बाद, Usage या वीडियो जॉब का निरीक्षण करें इससे पहले कि आप एक और संभावित भुगतान अनुरोध बनाएँ।.
अंतिम अपडेट नवम्बर 3, 2026