చిత్రాలను సృష్టించండి
సమకాలీన JSON ప్రతిస్పందనలో డేటాలో చిత్ర ఫలితాలు ఉంటాయి.
ఈ పేజీలో
https://api.shareai.now/api/v1/imagesచిత్రాలను సృష్టించండి
- బేస్ URL
https://api.shareai.now- authentication
- Bearer API కీ లేదా ఆమోదించిన OAuth యాక్సెస్ టోకెన్
- అవసరమైన scope
inferenceormonetization_gateway
సమకాలీన JSON ప్రతిస్పందనలో చిత్ర ఫలితాలు ఉంటాయి data. అలియాస్ /api/v1/images/generations కూడా మద్దతు ఉంది. పరిమాణం, రిజల్యూషన్, ఆస్పెక్ట్ రేషియో, నాణ్యత మరియు అవుట్పుట్ ఫార్మాట్ వంటి ఎంపికలు ఎంపిక చేసిన మోడల్పై ఆధారపడి ఉంటాయి. ప్రతిస్పందనలు 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 లేదా మద్దతు ఉన్న ఇమేజ్ డేటా URL గా సెట్ చేయబడతాయి. మోడల్ మద్దతు అవసరం. |
provider | ఆబ్జెక్ట్ | ఐచ్ఛిక ప్రొవైడర్ రూటింగ్ ప్రాధాన్యతలు. మోడల్ IDలో ప్రిఫిక్స్గా కాకుండా, ప్రొవైడర్.ఒన్లీని ఆమోదించబడిన ప్రొవైడర్ ట్యాగ్ల కోసం ఉపయోగించండి. ఖాతా మరియు క్రెడెన్షియల్ పరిమితులు ఇంకా వర్తిస్తాయి. |
ఫలితాన్ని చదవండి#
విజయవంతమైన ప్రతిస్పందన HTTP 200 తో JSON ను తిరిగి ఇస్తుంది. సమకాలీన JSON ప్రతిస్పందనలో చిత్ర ఫలితాలు ఉంటాయి data. అలియాస్ /api/v1/images/generations కూడా మద్దతు ఉంది. పరిమాణం, రిజల్యూషన్, ఆస్పెక్ట్ రేషియో, నాణ్యత మరియు అవుట్పుట్ ఫార్మాట్ వంటి ఎంపికలు ఎంపిక చేసిన మోడల్పై ఆధారపడి ఉంటాయి. ప్రతిస్పందనలు 2 MiB వరకు పరిమితం చేయబడతాయి; అవసరమైతే చిత్రాల సంఖ్య లేదా పరిమాణాన్ని తగ్గించండి. తిరిగి ఇచ్చిన చిత్రాలు ప్రతి వైపున 8192 పిక్సెల్స్ వరకు పరిమితం చేయబడతాయి.
బిల్లింగ్ యూనిట్లు#
చిత్ర టారిఫ్లు ఉత్పత్తి చేసిన చిత్రాలు, కొలిచిన మెగాపిక్సెల్స్, ఇన్పుట్ రిఫరెన్స్లు, అభ్యర్థనలు లేదా ప్రొవైడర్-రిపోర్ట్ చేసిన టోకెన్లను ఉపయోగించవచ్చు. చిత్ర URL చిత్ర పరిమాణ కొలత కాదు. మెగాపిక్సెల్ టారిఫ్లు తిరిగి ఇచ్చిన చిత్ర పరిమాణాలను అవసరం చేస్తాయి; ఆ మార్గాల కోసం base64 అవుట్పుట్ను ఉపయోగించండి.
Console నుండి ఖచ్చితంగా ఎనేబుల్ చేయబడిన మోడల్ ఐడెంటిఫైయర్ను ఎంచుకోండి. దాని ప్రకటన చేసిన ఆపరేషన్ మరియు ఇన్పుట్/అవుట్పుట్ సామర్థ్యాలు ఈ ఎండ్పాయింట్కు సరిపోవాలి; ఒక ఆపరేషన్ కోసం టెక్స్ట్ చాట్ మోడల్ను మరొకదానితో మార్చలేరు. మీ క్రెడెన్షియల్, ప్రొవైడర్ మరియు ఖాతా పరిమితులు ఇంకా వర్తిస్తాయి.
ధరలు మరియు వినియోగం#
ఎంపిక చేసిన మోడల్, ప్రొవైడర్, యూనిట్లు మరియు వేరియంట్ల కోసం రేట్లు EUR AI క్రెడిట్లలో ప్రచురించబడతాయి. దాని క్రియాశీల టారిఫ్లో ఉన్న కొలతలకే ఛార్జ్ చేయబడుతుంది. అంచనా అమలు ముందు క్రెడిట్లను రిజర్వ్ చేస్తుంది; తుది ఛార్జీలు కొలిచిన వినియోగాన్ని ఉపయోగిస్తాయి. ధరలు రిజల్యూషన్, అవుట్పుట్ ఫార్మాట్ లేదా వినియోగ బ్యాండ్పై ఆధారపడి ఉండవచ్చు. తుది ShareAI డెబిట్ కోసం Console Usageని తనిఖీ చేయండి. అప్స్ట్రీమ్ ఖర్చు ఫీల్డ్స్ మరియు మీడియా బైట్లు ఆవిష్కృత టోకెన్ కౌంట్లుగా మార్చబడవు.
యాక్సెస్ మరియు లోపాలు#
ఉపయోగించండి inference ఆమోదించబడిన నెట్వర్క్-ఖర్చు ఇన్ఫరెన్స్ కోసం లేదా monetization_gateway ఆమోదించబడిన Builder మార్కప్ మరియు ఆమోదించబడిన బిల్లింగ్ నిబంధనల కోసం. ఐడెంటిటీ-మాత్రమే యాక్సెస్ ఖర్చు చేయడానికి అనుమతించదు. ధృవీకరణ, మోడల్ అనుమతి, తగినంత క్రెడిట్లు లేకపోవడం, రేట్ పరిమితులు మరియు అమలు వైఫల్యాలు నిర్మిత error. టైమ్ఔట్ లేదా అనిశ్చిత సమర్పణ తర్వాత, మరొక చెల్లించదగిన అభ్యర్థనను సృష్టించే ముందు Usage లేదా వీడియో పనిని తనిఖీ చేయండి.
చివరిసారి నవీకరించబడింది నవంబర్ 3, 2026