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

वीडियो

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

एक असिंक्रोनस वीडियो जनरेशन जॉब सबमिट करता है। तुरंत 202 और जॉब id (vjob_ उपसर्ग) लौटाता है; GET /api/v1/videos/{id} से तब तक पोल करें जब तक status completed न हो, फिर unsigned_urls से डाउनलोड करें। बिलिंग: सबमिट पर duration × resolution से क्रेडिट आरक्षित होता है और वास्तविक डिलीवर सेकंड पर सेटल होता है (पोल प्रतिक्रिया का usage.cost)।

POST/api/v1/videos

प्राधिकरण

Authorizationआवश्यक

string · header

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

Body

modelआवश्यक

string

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

Example: "alibaba/wan2.7-t2v"

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 /api/v1/videos

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

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

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

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