प्रतिमा तयार करा
समकालीन 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 | स्ट्रिंग | मॉडेल-समर्थित आस्पेक्ट रेशो सिलेक्टर, जास्तीत जास्त 100 अक्षरे. |
quality | स्ट्रिंग | मॉडेल-समर्थित गुणवत्ता निवडकर्ता, जास्तीत जास्त 100 अक्षरे; वेगळी दर निवडली जाऊ शकते. |
response_format | स्ट्रिंग | मॉडेल-समर्थित प्रतिसाद स्वरूप, जास्तीत जास्त 100 अक्षरे. ऑपरेशन ठरवते की परिणाम JSON असेल किंवा बायनरी. |
output_format | स्ट्रिंग | मॉडेल-समर्थित आउटपुट एन्कोडिंग निवडकर्ता, जास्तीत जास्त 100 अक्षरे. |
background | स्ट्रिंग | मॉडेलद्वारे समर्थित असल्यास पर्यायी प्रतिमा पार्श्वभूमी सेटिंग. |
seed | पूर्णांक | पर्यायी मॉडेल-समर्थित बीज. व्हिडिओसाठी नकारात्मक नसलेला पूर्णांक आवश्यक आहे; पुनरुत्पादकता कार्यान्वाहकावर अवलंबून असते. |
input_references | अॅरे | जास्तीत जास्त 16 टाइप केलेले image_url भाग image_url.url सह HTTPS URL किंवा समर्थित image data URL सेट केलेले. मॉडेल समर्थन आवश्यक आहे. |
provider | ऑब्जेक्ट | पर्यायी प्रोव्हायडर रूटिंग प्राधान्ये. स्वीकारलेल्या प्रोव्हायडर टॅगसाठी provider.only वापरा, मॉडेल आयडीमध्ये उपसर्ग म्हणून नाही. खाते आणि क्रेडेन्शियल निर्बंध अद्याप लागू होतात. |
परिणाम वाचा#
यशस्वी प्रतिसाद 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