दस्तावेज़API संदर्भ SDK संदर्भ एजेंटिक उपयोग AI स्किल्स

वीडियो

वीडियो जनरेशन अनुरोध सबमिट करें

असिंक्रोनस वीडियो जनरेशन जॉब सबमिट करता है और तुरंत 202 के साथ job ID लौटाता है। GET /v1/videos/{id} को completed या failed होने तक poll करें; पूरा होने पर unsigned_urls से डाउनलोड करें। सबमिट करते समय duration और resolution के आधार पर credits आरक्षित होते हैं; जरूरत पड़ने पर worst-case अनुमान इस्तेमाल होता है। पूरा होने पर usage.cost वास्तविक डिलीवर किए गए सेकंड के आधार पर ग्राहक से ली गई USD राशि है।

POST/v1/videos

प्राधिकरण

Authorizationआवश्यक

string · header

Authorization हेडर में bearer token के रूप में API कुंजी।

Body

modelआवश्यक

string

वीडियो जनरेशन मॉडल ID (प्रदाता-उपसर्ग प्रारूप)।

Example: "bytedance/seedance-2.0"

promptआवश्यक

string

जनरेट होने वाले वीडियो का वर्णन करने वाला टेक्स्ट प्रॉम्प्ट।

duration

integer

वीडियो की लंबाई सेकंड में। डिफ़ॉल्ट 2। प्रत्येक मॉडल की अपनी सीमाएँ हैं — जैसे reference-to-video (r2v) 2–10 सेकंड; सीमा से बाहर मान क्रेडिट आरक्षित होने से पहले 400 लौटाते हैं।

1–600 (per-model bounds are tighter; reference-to-video: 2–10)

Example: 5

resolution

string

आउटपुट गुणवत्ता स्तर, डिफ़ॉल्ट "720p"। समर्थित स्तर मॉडल के अनुसार भिन्न हैं; असमर्थित स्तर क्रेडिट आरक्षण से पहले 400 लौटाता है, और त्रुटि में समर्थित स्तर सूचीबद्ध होते हैं।

480p720p1080p

Example: "720p"

aspect_ratio

string

आस्पेक्ट रेशियो। सामान्य मान: "16:9", "9:16", "1:1", "4:3", "3:4"; सटीक सेट मॉडल पर निर्भर है (कुछ "21:9" जैसे चौड़े अनुपात भी लेते हैं)। असमर्थित संयोजन क्रेडिट आरक्षण से पहले 400 लौटाते हैं; इनपुट फ़्रेम वाले मोड फ़्रेम से अनुपात लेते हैं और इस फ़ील्ड को अनदेखा करते हैं।

16:99:161:14:33:43:22:321:99:21

Example: "16:9"

frame_images

array

पहला/अंतिम कीफ़्रेम चित्र (image-to-video, keyframe-to-video)। URL स्ट्रिंग, या ऑब्जेक्ट { type: "image", image_url: { url }, frame_type: "first" | "last" } स्वीकार करता है।

input_references

object[] | string[]

संदर्भ एसेट (reference-to-video): संदर्भ आइटम से जनरेशन निर्देशित करें — ऑब्जेक्ट रूप { type: "image", image_url: { url } } बेहतर है (URL स्ट्रिंग भी स्वीकार्य, चित्र संदर्भ मानी जाती है)। चित्र संदर्भ सबसे व्यापक समर्थित हैं; ऑडियो/वीडियो संदर्भ ऑब्जेक्ट ज्यों-के-त्यों अग्रेषित होते हैं और केवल समर्थक मॉडलों पर प्रभावी होते हैं — अन्य मॉडल केवल चित्र संदर्भ लेते हैं। केवल r2v मोड वाले मॉडल यह फ़ील्ड लेते हैं।

input_video

string | object

स्रोत वीडियो (केवल वीडियो-संपादन मॉडल; BazaarLink विस्तार फ़ील्ड)। URL स्ट्रिंग, { video_url: { url } } या { url } स्वीकार करता है। गैर-संपादन मॉडल अनदेखा करते हैं। संपादन स्रोत सेकंड + आउटपुट सेकंड पर बिल होता है।

generate_audio

boolean

क्या ऑडियो भी जनरेट करना है। केवल ऑडियो-सक्षम मॉडलों पर प्रभावी; ऑडियो वाले सेकंड की दर अधिक होती है।

watermark

boolean

आउटपुट पर वॉटरमार्क लगाना है या नहीं। डिफ़ॉल्ट false — जब तक आप स्पष्ट रूप से true न भेजें, BazaarLink डिफ़ॉल्ट वॉटरमार्क सक्रिय रूप से बंद करता है।

seed

number

सैंपलिंग सीड। पुनरुत्पादन की गारंटी मॉडल पर निर्भर करती है।

callback_url

string

जॉब की अंतिम स्थिति पर कॉल होने वाला webhook URL, ताकि आपको पोल न करना पड़े। केवल HTTPS स्वीकार्य, और क्रेडिट आरक्षित होने से पहले SSRF जाँच होती है (निजी/आंतरिक पते अस्वीकृत)। यह ठीक एक बार ट्रिगर होता है, केवल उस अनुरोध से जो अंतिम-स्थिति निर्धारण जीतता है; विफलता पर डिलीवरी पुनः प्रयास होती है (2 बार, 2s/8s बैकऑफ़), और सभी पुनः प्रयास समाप्त होने पर भी बिलिंग या जॉब की वास्तविक स्थिति प्रभावित नहीं होती। v1 में कोई हस्ताक्षर नहीं — कॉलबैक को संकेत मानें, कार्रवाई से पहले अपनी API कुंजी से GET /v1/videos/{id} कॉल कर स्थिति और राशि की पुष्टि करें। ⚠️ webhook payload में unsigned_urls निरपेक्ष URL हैं, poll एंडपॉइंट के सापेक्ष पथ से भिन्न।

https:// only, ≤2048 chars

गहन गाइड →

POST /v1/videos

1
2
3
4
5
6
7
8
9
10
curl https://api.bazaarlink.ai/v1/videos \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.0",
    "prompt": "a corgi surfing a wave at sunset",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

प्रतिक्रिया उदाहरण

जॉब स्वीकृत (असिंक्रोनस)। स्थिति के लिए लौटाए गए polling_url (GET /v1/videos/{id}) को पोल करें; ≥5 सेकंड अंतराल अनुशंसित।

1
2
3
4
5
{
  "id": "vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk",
  "status": "pending",
  "polling_url": "/v1/videos/vjob_Xk3fJ9aQ2mB7cD1eF5gH6iJk"
}