व्हिडिओ तयार करा
सबमिशन HTTP 202 परत करते आणि ShareAI जॉब ID आणि पोलिंग URL प्रदान करते.
या पृष्ठावर
https://api.shareai.now/api/v1/videosव्हिडिओ तयार करा
- बेस URL
https://api.shareai.now- प्रमाणीकरण
- Bearer API की किंवा मंजूर OAuth प्रवेश टोकन
- आवश्यक स्कोप
inferenceormonetization_gateway
सबमिशन HTTP 202 परत करते आणि ShareAI जॉब ID आणि पोलिंग URL प्रदान करते. स्थिर Idempotency-Key पुनरावृत्ती विनंत्यांसाठी हेडर पाठवा. वेगळ्या इनपुटसह त्या कीचा पुनर्वापर नाकारला जातो. पोल GET /api/v1/videos/{id} त्याच मूळ क्रेडेन्शियलसह. स्थितीमध्ये queued, pending, in_progress, finalizing, completed, failed आणि requires_review समाविष्ट आहे. requires_review परिणामासाठी टीम समेट आवश्यक आहे; पोलिंग कधीही दुसरी जनरेशन सुरू करत नाही.
सुरू करण्यापूर्वी#
तुमच्या सर्व्हरवर 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 किंवा समर्थित image data URL सेट केलेले. मॉडेल समर्थन आवश्यक आहे. |
provider | ऑब्जेक्ट | पर्यायी प्रोव्हायडर रूटिंग प्राधान्ये. स्वीकारलेल्या प्रोव्हायडर टॅगसाठी provider.only वापरा, मॉडेल आयडीमध्ये उपसर्ग म्हणून नाही. खाते आणि क्रेडेन्शियल निर्बंध अद्याप लागू होतात. |
allow_temporary_retention | बूलियन | फक्त व्हिडिओ. स्पष्ट true तात्पुरत्या अपस्ट्रीम परिणाम साठवणुकीला परवानगी देते ज्यांना त्याची आवश्यकता आहे. वगळलेले/false त्या मार्गांना अनुपलब्ध ठेवते. provider.zdr:true शी विरोधाभास; इतर ऑपरेशन्स अनिवार्य ZDR साठवतात. |
परिणाम वाचा#
यशस्वी HTTP 202 JSON सह परत करते. सबमिशन HTTP 202 परत करते आणि ShareAI जॉब ID आणि पोलिंग URL प्रदान करते. स्थिर Idempotency-Key पुनरावृत्ती विनंत्यांसाठी हेडर पाठवा. वेगळ्या इनपुटसह त्या कीचा पुनर्वापर नाकारला जातो. पोल GET /api/v1/videos/{id} त्याच मूळ क्रेडेन्शियलसह. स्थितीमध्ये queued, pending, in_progress, finalizing, completed, failed आणि requires_review समाविष्ट आहे. requires_review परिणामासाठी टीम समेट आवश्यक आहे; पोलिंग कधीही दुसरी जनरेशन सुरू करत नाही.
बिलिंग युनिट्स#
व्हिडिओ मार्ग त्यांच्या बिलिंग युनिट्स घोषित करतात. प्रति-सेकंद मार्ग प्रत्येक परत केलेल्या फाइलच्या मोजलेल्या कालावधीचा वापर करून सेटल होतो, कधीही विनंती केलेला कालावधी किंवा अपस्ट्रीम 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- प्रमाणीकरण
- Bearer API की किंवा मंजूर OAuth प्रवेश टोकन
- आवश्यक स्कोप
inferenceormonetization_gateway
JSON
{
"id": "YOUR_JOB_ID",
"object": "video",
"status": "pending",
"created_at": 1793664000,
"polling_url": "/api/v1/videos/YOUR_JOB_ID"
}वरील JSON स्थिर जॉब फील्ड्स दर्शवते, वास्तविक जनरेशन नाही. ShareAI मार्गावर त्याच कीसह पोल करा, तपासण्यांमध्ये प्रतीक्षा करा. queued, pending, in_progress आणि finalizing याचा अर्थ प्रतीक्षा करा; completed ShareAI सामग्री URL सह डेटा उघडते; failed आणि requires_review याचा अर्थ थांबा आणि तपासा. तात्पुरत्या त्रुटींनंतर स्थिती पुन्हा तपासा, परंतु जनरेशन आपोआप पुन्हा सबमिट करू नका. वेगळ्या किंवा रद्द केलेल्या क्रेडेन्शियलसह जॉब पुनर्प्राप्त करू शकत नाही.
cURL
curl --fail-with-body "https://api.shareai.now/api/v1/videos/YOUR_JOB_ID" \
-H "Authorization: Bearer $SHAREAI_API_KEY"निकाल डाउनलोड करा#
पूर्ण झाल्यावर, प्रत्येक डेटा एंट्रीमध्ये ShareAI सामग्री URL समाविष्ट असतो. Fetch GET /api/v1/videos/{id}/content?index=0 त्याच मूळ क्रेडेन्शियलचा वापर करून. एन्डपॉइंट एकाच HTTP बाइट रेंजला समर्थन देतो. Provider URLs, खाजगी तिकीट आणि provider क्रेडेन्शियल्स कधीही परत दिले जात नाहीत. Polling आणि डाउनलोडिंग दुसरी inference विनंती किंवा Monetization Gateway ingestion शुल्क तयार करत नाहीत. पूर्ण झालेली नोकरी म्हणजे फायली डाउनलोड करण्यायोग्य होण्यापूर्वी सेटलमेंटची पुष्टी केली जाते.
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 असते. एका विनंतीत frame images किंवा reference images वापरा, दोन्ही नाही. मॉडेल कालावधी, रिझोल्यूशन्स आणि आस्पेक्ट रेशो API च्या सुरक्षा मर्यादेपेक्षा अधिक प्रतिबंधात्मक असू शकतात. Webhooks आणि मनमानी callback URLs समर्थित नाहीत.
शेवटचे अद्यतनित नोव्हेंबर 3, 2026