वीडियो जनरेट करें
सबमिशन HTTP 202 के साथ एक ShareAI जॉब आईडी और पोलिंग 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 | स्ट्रिंग | मॉडल-समर्थित 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 | ऑब्जेक्ट | वैकल्पिक प्रोवाइडर रूटिंग प्राथमिकताएँ। स्वीकृत प्रोवाइडर टैग के लिए provider.only का उपयोग करें, मॉडल ID में प्रीफिक्स के रूप में नहीं। खाता और क्रेडेंशियल प्रतिबंध अभी भी लागू होते हैं।. |
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 सामग्री URLs के साथ डेटा को उजागर करता है; 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 होता है। प्राप्त करें 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 शामिल हो। एक ही अनुरोध में frame images या reference images का उपयोग करें, दोनों का नहीं। मॉडल की अवधि, रिज़ॉल्यूशन और आस्पेक्ट रेशियो API की सुरक्षा सीमाओं से अधिक प्रतिबंधात्मक हो सकते हैं। Webhooks और मनमाने callback URLs समर्थित नहीं हैं।.
अंतिम अपडेट नवम्बर 3, 2026