వీడియోలను సృష్టించండి
సమర్పణ HTTP 202 ను ShareAI జాబ్ ID మరియు పోలింగ్ URL తో తిరిగి ఇస్తుంది.
ఈ పేజీలో
https://api.shareai.now/api/v1/videosవీడియోలను సృష్టించండి
- బేస్ URL
https://api.shareai.now- authentication
- Bearer API కీ లేదా ఆమోదించిన OAuth యాక్సెస్ టోకెన్
- అవసరమైన scope
inferenceormonetization_gateway
సమర్పణ HTTP 202 ను ShareAI జాబ్ ID మరియు పోలింగ్ URL తో తిరిగి ఇస్తుంది. స్థిరమైన Idempotency-Key అదే అభ్యర్థనకు పునరుద్ధరణల కోసం హెడ్డర్ను పంపండి. వేర్వేరు ఇన్పుట్తో ఆ కీని మళ్లీ ఉపయోగించడం తిరస్కరించబడుతుంది. పోలింగ్ GET /api/v1/videos/{id} అదే మూల సాక్ష్యంతో చేయండి. స్థితులు క్యూడ్, పెండింగ్, ప్రోగ్రెస్లో, ఫైనలైజింగ్, పూర్తి, విఫలమైంది మరియు సమీక్ష అవసరం ఉన్నాయి. సమీక్ష అవసరం ఉన్న ఫలితానికి జట్టు సమన్వయం అవసరం; పోలింగ్ మరో జనరేషన్ను ప్రారంభించదు.
మీరు ప్రారంభించడానికి ముందు#
మీ సర్వర్లో SHAREAI_API_KEY సెట్ చేసి, మోడల్ ప్లేస్హోల్డర్ను ప్రస్తుతం ఎనేబుల్ చేయబడిన మోడల్తో మార్చండి. API కీని బ్రౌజర్ కోడ్లో ఎప్పుడూ బహిర్గతం చేయవద్దు. మోడల్, ఖాతా, క్రెడెన్షియల్ మరియు ప్రొవైడర్ ఈ ఆపరేషన్ను అనుమతించాలి. క్రింది ఐచ్ఛిక సెట్టింగ్లు మోడల్ మద్దతును అవసరం చేస్తాయి; API భద్రత పరిమితులు ప్రతి మోడల్ ప్రతి విలువను మద్దతు ఇస్తుందని హామీ ఇవ్వవు.
అభ్యర్థనను పంపండి#
cURL
curl --fail-with-body --request POST "https://api.shareai.now/api/v1/videos" \
-H "Authorization: Bearer $SHAREAI_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
--data '{
"model": "YOUR_ENABLED_VIDEOS_MODEL",
"prompt": "A slow camera move through a quiet forest.",
"duration": 8
}'Python
import json
import os
import urllib.request
payload = {'model': 'YOUR_ENABLED_VIDEOS_MODEL',
'prompt': 'A slow camera move through a quiet forest.',
'duration': 8}
headers = {'Content-Type': 'application/json', 'Idempotency-Key': 'YOUR_UNIQUE_REQUEST_ID'}
headers["Authorization"] = "Bearer " + os.environ["SHAREAI_API_KEY"]
request = urllib.request.Request('https://api.shareai.now/api/v1/videos', 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/videos", {
method: "POST",
headers: { Authorization: `Bearer ${process.env.SHAREAI_API_KEY}`, ...{"Content-Type": "application/json", "Idempotency-Key": "YOUR_UNIQUE_REQUEST_ID"} },
body: JSON.stringify({
"model": "YOUR_ENABLED_VIDEOS_MODEL",
"prompt": "A slow camera move through a quiet forest.",
"duration": 8
}),
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
console.log(result);అభ్యర్థన ఫీల్డ్స్#
| ఫీల్డ్ | రకం | అర్థం మరియు పరిమితులు |
|---|---|---|
model అవసరం | స్ట్రింగ్ | ఖచ్చితంగా ఎనేబుల్ చేయబడిన పబ్లిక్ మోడల్ ఐడెంటిఫైయర్. ఈ ఆపరేషన్ను ప్రకటించాలి మరియు మీ క్రెడెన్షియల్ ద్వారా అనుమతించబడాలి. |
prompt అవసరం | స్ట్రింగ్ | ఖాళీ కాని జనరేషన్ ప్రాంప్ట్, గరిష్టంగా 256 KiB UTF-8 టెక్స్ట్. |
duration | పూర్ణాంకం | ఐచ్ఛికంగా అభ్యర్థించిన వీడియో వ్యవధి సెకన్లలో, 1–600, ఎంపిక చేసిన మోడల్ ద్వారా మరింత పరిమితం చేయబడింది. వాస్తవంగా తిరిగి వచ్చిన వ్యవధులు వ్యవధి బిల్లింగ్ను నిర్ణయిస్తాయి. |
resolution | స్ట్రింగ్ | మోడల్-మద్దతు ఉన్న రిజల్యూషన్ సెలెక్టర్, గరిష్టంగా 100 అక్షరాలు; ప్రచురించిన టారిఫ్ వేరియంట్తో సరిపోలాలి. |
aspect_ratio | స్ట్రింగ్ | మోడల్-మద్దతు ఉన్న ఆస్పెక్ట్ రేషియో సెలెక్టర్, గరిష్టంగా 100 అక్షరాలు. |
size | స్ట్రింగ్ | మోడల్-మద్దతు ఉన్న అవుట్పుట్ పరిమాణం, గరిష్టంగా 100 అక్షరాలు, ఉదాహరణకు 1024×1024. ప్రతి మోడల్ ఈ ఎంపికను మద్దతు ఇవ్వదు. |
generate_audio | బూలియన్ | ఐచ్ఛిక వీడియో సౌండ్ట్రాక్ సెలెక్టర్. మోడల్ మద్దతు మరియు సరిపోలే టారిఫ్ వేరియంట్ అవసరం. |
seed | పూర్ణాంకం | ఐచ్ఛిక మోడల్-మద్దతు ఉన్న సీడ్. వీడియోకు అప్రతికూల పూర్ణాంకం అవసరం; పునరుత్పత్తి ఎగ్జిక్యూటర్పై ఆధారపడి ఉంటుంది. |
frame_images | అర్రే | గరిష్టంగా రెండు image_url భాగాలు, ప్రతి ఒక్కటి frame_type తో first_frame లేదా last_frame, డూప్లికేట్లు లేకుండా. frame_images మరియు input_references ను కలపవద్దు. |
input_references | అర్రే | గరిష్టంగా 16 టైప్ చేయబడిన image_url భాగాలు image_url.url HTTPS URL లేదా మద్దతు ఉన్న ఇమేజ్ డేటా URL గా సెట్ చేయబడతాయి. మోడల్ మద్దతు అవసరం. |
provider | ఆబ్జెక్ట్ | ఐచ్ఛిక ప్రొవైడర్ రూటింగ్ ప్రాధాన్యతలు. మోడల్ IDలో ప్రిఫిక్స్గా కాకుండా, ప్రొవైడర్.ఒన్లీని ఆమోదించబడిన ప్రొవైడర్ ట్యాగ్ల కోసం ఉపయోగించండి. ఖాతా మరియు క్రెడెన్షియల్ పరిమితులు ఇంకా వర్తిస్తాయి. |
allow_temporary_retention | బూలియన్ | వీడియో మాత్రమే. తాత్కాలిక అప్స్ట్రీమ్ ఫలిత నిల్వను అనుమతించడానికి స్పష్టమైన true రూట్లపై అవసరం. వదిలివేయబడిన/తప్పుడు వాటిని అందుబాటులో ఉంచదు. provider.zdr:true తో విరుద్ధంగా ఉంటుంది; ఇతర ఆపరేషన్లు తప్పనిసరి ZDR ను నిల్వ చేస్తాయి. |
ఫలితాన్ని చదవండి#
విజయవంతం అయితే JSON తో HTTP 202 ను తిరిగి ఇస్తుంది. సమర్పణ HTTP 202 ను ShareAI జాబ్ ID మరియు పోలింగ్ URL తో తిరిగి ఇస్తుంది. స్థిరమైన Idempotency-Key అదే అభ్యర్థనకు పునరుద్ధరణల కోసం హెడ్డర్ను పంపండి. వేర్వేరు ఇన్పుట్తో ఆ కీని మళ్లీ ఉపయోగించడం తిరస్కరించబడుతుంది. పోలింగ్ GET /api/v1/videos/{id} అదే మూల సాక్ష్యంతో చేయండి. స్థితులు క్యూడ్, పెండింగ్, ప్రోగ్రెస్లో, ఫైనలైజింగ్, పూర్తి, విఫలమైంది మరియు సమీక్ష అవసరం ఉన్నాయి. సమీక్ష అవసరం ఉన్న ఫలితానికి జట్టు సమన్వయం అవసరం; పోలింగ్ మరో జనరేషన్ను ప్రారంభించదు.
బిల్లింగ్ యూనిట్లు#
వీడియో రూట్లు తమ బిల్లింగ్ యూనిట్లను ప్రకటిస్తాయి. సెకన్కు రూట్ ప్రతి తిరిగి వచ్చిన ఫైల్ యొక్క కొలిచిన వ్యవధిని ఉపయోగించి సెటిల్ అవుతుంది, అభ్యర్థించిన వ్యవధి లేదా అప్స్ట్రీమ్ USD ఖర్చు కాదు. అభ్యర్థించిన వ్యవధి 1 నుండి 600 సెకన్ల మధ్య ఉండాలి మరియు మోడల్ మద్దతు ఇవ్వాలి. కన్జర్వేటివ్ క్రెడిట్ హోల్డ్ నాలుగు అవుట్పుట్ల వరకు కవర్ చేయగలదు.
Console నుండి ఖచ్చితంగా ఎనేబుల్ చేయబడిన మోడల్ ఐడెంటిఫైయర్ను ఎంచుకోండి. దాని ప్రకటన చేసిన ఆపరేషన్ మరియు ఇన్పుట్/అవుట్పుట్ సామర్థ్యాలు ఈ ఎండ్పాయింట్కు సరిపోవాలి; ఒక ఆపరేషన్ కోసం టెక్స్ట్ చాట్ మోడల్ను మరొకదానితో మార్చలేరు. మీ క్రెడెన్షియల్, ప్రొవైడర్ మరియు ఖాతా పరిమితులు ఇంకా వర్తిస్తాయి.
ధరలు మరియు వినియోగం#
ఎంపిక చేసిన మోడల్, ప్రొవైడర్, యూనిట్లు మరియు వేరియంట్ల కోసం రేట్లు EUR AI క్రెడిట్లలో ప్రచురించబడతాయి. దాని క్రియాశీల టారిఫ్లో ఉన్న కొలతలకే ఛార్జ్ చేయబడుతుంది. అంచనా అమలు ముందు క్రెడిట్లను రిజర్వ్ చేస్తుంది; తుది ఛార్జీలు కొలిచిన వినియోగాన్ని ఉపయోగిస్తాయి. ధరలు రిజల్యూషన్, అవుట్పుట్ ఫార్మాట్ లేదా వినియోగ బ్యాండ్పై ఆధారపడి ఉండవచ్చు. తుది ShareAI డెబిట్ కోసం Console Usageని తనిఖీ చేయండి. అప్స్ట్రీమ్ ఖర్చు ఫీల్డ్స్ మరియు మీడియా బైట్లు ఆవిష్కృత టోకెన్ కౌంట్లుగా మార్చబడవు.
యాక్సెస్ మరియు లోపాలు#
ఉపయోగించండి inference ఆమోదించబడిన నెట్వర్క్-ఖర్చు ఇన్ఫరెన్స్ కోసం లేదా monetization_gateway ఆమోదించబడిన Builder మార్కప్ మరియు ఆమోదించబడిన బిల్లింగ్ నిబంధనల కోసం. ఐడెంటిటీ-మాత్రమే యాక్సెస్ ఖర్చు చేయడానికి అనుమతించదు. ధృవీకరణ, మోడల్ అనుమతి, తగినంత క్రెడిట్లు లేకపోవడం, రేట్ పరిమితులు మరియు అమలు వైఫల్యాలు నిర్మిత error. టైమ్ఔట్ లేదా అనిశ్చిత సమర్పణ తర్వాత, మరొక చెల్లించదగిన అభ్యర్థనను సృష్టించే ముందు Usage లేదా వీడియో పనిని తనిఖీ చేయండి.
తాత్కాలిక వీడియో నిల్వ#
కొన్ని వీడియో రూట్లకు తాత్కాలిక అప్స్ట్రీమ్ నిల్వ అవసరం, తద్వారా ఉత్పత్తి చేయబడిన ఫలితాన్ని పొందవచ్చు. అవి మీ స్పష్టమైన allow_temporary_retention:true ఆ వీడియో అభ్యర్థనపై అంగీకారాన్ని అవసరం చేస్తాయి. దాన్ని వదిలివేయడం ఆ రూట్లను అందుబాటులో ఉంచదు. ఈ మినహాయింపు వీడియోకు మాత్రమే వర్తిస్తుంది మరియు ఇతర ఆపరేషన్ల కోసం మోడల్ శిక్షణ లేదా నిల్వను అనుమతించదు. స్పష్టమైన ZDR విధానాన్ని మౌనంగా బలహీనపరచలేరు.
JSON
{"allow_temporary_retention": true}జాబ్ స్థితిని తనిఖీ చేయండి#
https://api.shareai.now/api/v1/videos/{id}మూల సాక్ష్యంతో వీడియో జనరేషన్ను చదవండి
- బేస్ URL
https://api.shareai.now- authentication
- Bearer API కీ లేదా ఆమోదించిన OAuth యాక్సెస్ టోకెన్
- అవసరమైన scope
inferenceormonetization_gateway
JSON
{
"id": "YOUR_JOB_ID",
"object": "video",
"status": "pending",
"created_at": 1793664000,
"polling_url": "/api/v1/videos/YOUR_JOB_ID"
}పై JSON స్థిరమైన జాబ్ ఫీల్డ్లను చూపిస్తుంది, నిజమైన జనరేషన్ను కాదు. అదే కీతో ShareAI మార్గాన్ని పోలింగ్ చేయండి, తనిఖీల మధ్య వేచి ఉండండి. క్యూడ్, పెండింగ్, ప్రోగ్రెస్లో మరియు ఫైనలైజింగ్ అంటే వేచి ఉండండి; పూర్తి ShareAI కంటెంట్ URLలతో డేటాను ప్రదర్శిస్తుంది; విఫలమైంది మరియు సమీక్ష అవసరం అంటే ఆపి తనిఖీ చేయండి. తాత్కాలిక లోపాల తర్వాత స్థితిని మళ్లీ ప్రయత్నించండి, కానీ జనరేషన్ను ఆటోమేటిక్గా మళ్లీ సమర్పించవద్దు. వేర్వేరు లేదా రద్దు చేయబడిన సాక్ష్యం జాబ్ను పొందలేరు.
cURL
curl --fail-with-body "https://api.shareai.now/api/v1/videos/YOUR_JOB_ID" \
-H "Authorization: Bearer $SHAREAI_API_KEY"ఫలితాన్ని డౌన్లోడ్ చేయండి#
పూర్తయిన తర్వాత, ప్రతి డేటా ఎంట్రీలో ShareAI కంటెంట్ URL ఉంటుంది. పొందండి GET /api/v1/videos/{id}/content?index=0 అదే మూలం క్రెడెన్షియల్ ఉపయోగించి. ఎండ్పాయింట్ ఒకే HTTP బైట్ రేంజ్ను మద్దతు ఇస్తుంది. ప్రొవైడర్ URLs, ప్రైవేట్ టికెట్లు మరియు ప్రొవైడర్ క్రెడెన్షియల్స్ ఎప్పుడూ తిరిగి ఇవ్వబడవు. పోలింగ్ మరియు డౌన్లోడ్ చేయడం రెండవ ఇన్ఫరెన్స్ అభ్యర్థన లేదా Monetization Gateway ఇన్జెక్షన్ ఛార్జ్ను సృష్టించవు. పూర్తయిన పని అంటే ఫైల్ డౌన్లోడ్ చేయదగినదిగా మారే ముందు సెటిల్మెంట్ ధృవీకరించబడింది.
cURL
curl --fail-with-body "https://api.shareai.now/api/v1/videos/YOUR_JOB_ID/content?index=0" \
-H "Authorization: Bearer $SHAREAI_API_KEY" --output result.mp4ఐచ్ఛిక frame_images లో image_url భాగాలు ఉండాలి, first_frame లేదా last_frame తో. ఒక అభ్యర్థనలో ఫ్రేమ్ చిత్రాలు లేదా రిఫరెన్స్ చిత్రాలను ఉపయోగించండి, రెండింటిని కాదు. మోడల్ వ్యవధులు, రిజల్యూషన్లు మరియు ఆస్పెక్ట్ రేషియోలు API యొక్క భద్రత పరిమితుల కంటే మరింత పరిమితంగా ఉండవచ్చు. వెబ్హుక్స్ మరియు యాదృచ్ఛిక కాల్బ్యాక్ URLs మద్దతు ఇవ్వబడవు.
చివరిసారి నవీకరించబడింది నవంబర్ 3, 2026