इसे छोड़कर कंटेंट पर जाएं
मुफ़्त साइन अप करें
Wan

Wan वीडियो API: टेक्स्ट, इमेज, रेफ़रेंस और एडिटिंग

BetterToken API Key से Wan कनेक्ट करें और Model ID व ऑपरेशन के अनुसार फ़ील्ड, मीडिया और जनरेशन का तरीका चुनें।

टेक्स्ट, पहले फ़्रेम या रेफ़रेंस मीडिया से वीडियो बनाएं, या मौजूदा वीडियो एडिट करें। 3.0 और Prime तीन जनरेशन ऑपरेशन का समर्थन करते हैं। 2.7 में टेक्स्ट, इमेज, रेफ़रेंस जनरेशन और एडिटिंग के लिए अलग Model ID चुनें।

अपनी BetterToken API Key तैयार करें। Base URL https://bettertoken.ai/v1 है और प्रमाणीकरण के लिए Authorization: Bearer YOUR_API_KEY इस्तेमाल करें। Model ID को अक्षरों के केस सहित हूबहू कॉपी करें।

नीचे हर request.json एक ही प्रक्रिया अपनाता है: अनुमान लें, निर्माण की पुष्टि करें, स्थिति देखें और डाउनलोड करें। अनुमान लेने से जनरेशन शुरू नहीं होता; टास्क बनाने से भुगतान वाला अनुरोध भेजा जाता है। मौजूदा लागत model plaza में देखें।

मॉडल और ऑपरेशन

नीचे की तालिका में हर ऑपरेशन के लिए उपलब्ध मान हैं। फ़ील्ड के डिफ़ॉल्ट मान, मीडिया की संख्या और संयोजन की सीमाएं संबंधित उपखंड में देखें। मीडिया आकार के लिए 1 MB = 1048576 बाइट है।

Model IDऑपरेशनअवधि (सेकंड)आउटपुट स्तरअनुपातऑडियोमीडिया भूमिकाएं
wan2.7-i2vimage_to_video2–15, अंतराल 1720p, 1080pन भेजेंprovider_defaultfirst_frame, last_frame, driving_audio
wan2.7-r2vreference_to_video2–15, अंतराल 1720p, 1080p16:9, 9:16, 1:1, 4:3, 3:4provider_defaultreference_image, reference_video
wan2.7-t2vtext_to_video2–15, अंतराल 1720p, 1080p16:9, 9:16, 1:1, 4:3, 3:4provider_defaultdriving_audio
wan2.7-videoeditvideo_edit2–15, अंतराल 1; उपलब्ध auto720p, 1080pन भेजेंprovider_defaultbase_video
wan3.0-video-primeimage_to_video2–30, अंतराल 1; उपलब्ध auto480p, 720p, 1080padaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16on, offfirst_frame, last_frame
wan3.0-video-primereference_to_video2–30, अंतराल 1; उपलब्ध auto480p, 720p, 1080padaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16on, offreference_image, reference_video, reference_audio
wan3.0-video-primetext_to_video2–30, अंतराल 1; उपलब्ध auto480p, 720p, 1080padaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16on, offकोई नहीं
wan3.0-videoimage_to_video2–30, अंतराल 1; उपलब्ध auto480p, 720p, 1080padaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16on, offfirst_frame, last_frame
wan3.0-videoreference_to_video2–30, अंतराल 1; उपलब्ध auto480p, 720p, 1080padaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16on, offreference_image, reference_video, reference_audio
wan3.0-videotext_to_video2–30, अंतराल 1; उपलब्ध auto480p, 720p, 1080padaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16on, offकोई नहीं

इमेज-टू-वीडियो (wan2.7-i2v, और adaptive के साथ wan3.0-video / wan3.0-video-prime) तथा adaptive वाले रेफ़रेंस-टू-वीडियो में आउटपुट इनपुट इमेज के अनुपात का पालन करता है; आउटपुट स्तर कुल पिक्सेल संख्या तय करता है, निश्चित आकार नहीं। इस पेज की 1:1 सैंपल इमेज के साथ हमारे परीक्षण में 720p ने 960×960 और 480p ने 640×640 दिया। निश्चित लैंडस्केप या पोर्ट्रेट फ़्रेम के लिए output.aspect_ratio स्पष्ट रूप से भेजें (wan2.7-i2v यह फ़ील्ड स्वीकार नहीं करता; ज़रूरी अनुपात वाली इनपुट इमेज इस्तेमाल करें)।

नमूना मीडिया

इमेज से वीडियो और इमेज रेफ़रेंस वाले उदाहरण सफ़ेद मेज़ पर नीले सिरेमिक मग का इस्तेमाल करते हैं। आज़माने के लिए नमूना इमेज रखें, या पहले इसे ऐसे सार्वजनिक HTTPS मीडिया से बदलें जिसे इस्तेमाल करने का अधिकार आपके पास हो और जो इस पेज की सीमाएं पूरी करता हो।

वीडियो जनरेशन रेफ़रेंस: सफ़ेद मेज़ पर नीला सिरेमिक मग

एडिटिंग का उदाहरण शहर के चौक में लड़के का वीडियो इस्तेमाल करता है। यह लगभग 5.04 सेकंड, 1280 × 720 और 24 fps है। इसे base_video के रूप में दिया जाता है, रेफ़रेंस इमेज के रूप में नहीं।

टेक्स्ट से वीडियो

wan2.7-t2v

केवल टेक्स्ट विवरण होने पर यह ऑपरेशन इस्तेमाल करें।

model को इस उपखंड के Model ID और operation को text_to_video पर सेट करें। केवल नीचे दिए गए जनरेशन फ़ील्ड इस्तेमाल करें। मीडिया को media ऐरे में रखें।

फ़ील्डप्रकारज़रूरीअनुमत मान या सीमाडिफ़ॉल्ट
audio.modestringनहींprovider_defaultprovider_default
duration.modestringनहींfixedfixed
duration.secondsintegerनहीं2–15, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए5
output.aspect_ratiostringनहीं16:9, 9:16, 1:1, 4:3, 3:416:9
output.formatstringनहींmp4mp4
output.resolutionstringनहीं720p, 1080p1080p
promptstringहांस्ट्रिंगकोई नहीं
provider_options.alibaba.prompt_extendbooleanनहींtrue / false; प्रॉम्प्ट विस्तार नियंत्रित करता हैtrue
seedintegerनहीं0–2147483647, अंतराल 1; रैंडम सीड; 0 हो सकता हैकोई नहीं
watermarkbooleanनहींfalse, truefalse

मीडिया की ज़रूरतें

मीडिया भूमिकाप्रकार और संख्याफ़ॉर्मैटहर फ़ाइल की सीमाएं
driving_audioaudio, वैकल्पिक, अधिकतम 1wav, mp3अधिकतम आकार 15 MB; अवधि 2–30 सेकंड

मीडिया ज़रूरी है या नहीं, यह नीचे की संयोजन सीमाओं पर भी निर्भर है।

वैकल्पिक driving_audio ड्राइविंग ऑडियो देता है और type="audio" इस्तेमाल करता है। यह रेफ़रेंस जनरेशन के reference_audio से अलग मीडिया भूमिका है।

संयोजन की सीमाएं

  • duration.mode="fixed" के साथ duration.seconds ज़रूरी है। fixed स्पष्ट रूप से सेट करते समय सेकंड भी भरें।

अनुरोध का उदाहरण

नीचे का JSON request.json में सेव करें। फिर साझा प्रक्रिया के अनुसार पहले अनुमान लें और पुष्टि के बाद टास्क बनाएं।

{
"model": "wan2.7-t2v",
"operation": "text_to_video",
"prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"output": {
"resolution": "720p",
"aspect_ratio": "16:9"
}
}

आम 422 त्रुटियां

422 त्रुटि कोडसमाधान
enum / range / stepइस उपखंड की फ़ील्ड तालिका के अनुसार मान और अंतराल सुधारें।
unsupported_fieldइस ऑपरेशन की फ़ील्ड तालिका में मौजूद न होने वाले फ़ील्ड हटाएं।
requiresइस उपखंड की संयोजन सीमाओं के अनुसार सेकंड, अनुपात, ऑडियो सेटिंग या मीडिया जोड़ें।
count / media_roleइस उपखंड की मीडिया तालिका के अनुसार भूमिका और संख्या सुधारें।
video_input_unsupportedसार्वजनिक HTTPS पता, Content-Type और फ़ाइल फ़ॉर्मैट जांचें, फिर नया अनुमान लें।

wan3.0-video-prime

केवल टेक्स्ट विवरण होने पर यह ऑपरेशन इस्तेमाल करें।

model को इस उपखंड के Model ID और operation को text_to_video पर सेट करें। केवल नीचे दिए गए जनरेशन फ़ील्ड इस्तेमाल करें। मीडिया को media ऐरे में रखें।

फ़ील्डप्रकारज़रूरीअनुमत मान या सीमाडिफ़ॉल्ट
audio.modestringनहींon, offon
duration.modestringनहींfixed, autofixed
duration.secondsintegerनहीं2–30, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए5
output.aspect_ratiostringनहींadaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16adaptive
output.formatstringनहींmp4mp4
output.resolutionstringनहीं480p, 720p, 1080p1080p
promptstringहांस्ट्रिंगकोई नहीं
provider_options.alibaba.prompt_extendbooleanनहींtrue / false; प्रॉम्प्ट विस्तार नियंत्रित करता हैtrue
seedintegerनहीं0–2147483647, अंतराल 1; रैंडम सीड; 0 हो सकता हैकोई नहीं
watermarkbooleanनहींfalse, truefalse

मीडिया की ज़रूरतें

यह ऑपरेशन मीडिया स्वीकार नहीं करता।

संयोजन की सीमाएं

  • duration.mode="fixed" के साथ duration.seconds ज़रूरी है। fixed स्पष्ट रूप से सेट करते समय सेकंड भी भरें।
  • duration.mode="auto" इस्तेमाल करते समय duration.seconds न भेजें।

अनुरोध का उदाहरण

नीचे का JSON request.json में सेव करें। फिर साझा प्रक्रिया के अनुसार पहले अनुमान लें और पुष्टि के बाद टास्क बनाएं।

{
"model": "wan3.0-video-prime",
"operation": "text_to_video",
"prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"output": {
"resolution": "720p",
"aspect_ratio": "16:9"
}
}

आम 422 त्रुटियां

422 त्रुटि कोडसमाधान
enum / range / stepइस उपखंड की फ़ील्ड तालिका के अनुसार मान और अंतराल सुधारें।
unsupported_fieldइस ऑपरेशन की फ़ील्ड तालिका में मौजूद न होने वाले फ़ील्ड हटाएं।
requiresइस उपखंड की संयोजन सीमाओं के अनुसार सेकंड, अनुपात, ऑडियो सेटिंग या मीडिया जोड़ें।
excludesअपने-आप तय अवधि या अंतिम फ़्रेम से टकराने वाले फ़ील्ड हटाएं।

wan3.0-video

केवल टेक्स्ट विवरण होने पर यह ऑपरेशन इस्तेमाल करें।

model को इस उपखंड के Model ID और operation को text_to_video पर सेट करें। केवल नीचे दिए गए जनरेशन फ़ील्ड इस्तेमाल करें। मीडिया को media ऐरे में रखें।

फ़ील्डप्रकारज़रूरीअनुमत मान या सीमाडिफ़ॉल्ट
audio.modestringनहींon, offon
duration.modestringनहींfixed, autofixed
duration.secondsintegerनहीं2–30, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए5
output.aspect_ratiostringनहींadaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16adaptive
output.formatstringनहींmp4mp4
output.resolutionstringनहीं480p, 720p, 1080p1080p
promptstringहांस्ट्रिंगकोई नहीं
provider_options.alibaba.prompt_extendbooleanनहींtrue / false; प्रॉम्प्ट विस्तार नियंत्रित करता हैtrue
seedintegerनहीं0–2147483647, अंतराल 1; रैंडम सीड; 0 हो सकता हैकोई नहीं
watermarkbooleanनहींfalse, truefalse

मीडिया की ज़रूरतें

यह ऑपरेशन मीडिया स्वीकार नहीं करता।

संयोजन की सीमाएं

  • duration.mode="fixed" के साथ duration.seconds ज़रूरी है। fixed स्पष्ट रूप से सेट करते समय सेकंड भी भरें।
  • duration.mode="auto" इस्तेमाल करते समय duration.seconds न भेजें।

अनुरोध का उदाहरण

नीचे का JSON request.json में सेव करें। फिर साझा प्रक्रिया के अनुसार पहले अनुमान लें और पुष्टि के बाद टास्क बनाएं।

{
"model": "wan3.0-video",
"operation": "text_to_video",
"prompt": "A blue ceramic mug on a white table. Slowly move the camera closer in soft daylight.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"output": {
"resolution": "720p",
"aspect_ratio": "16:9"
}
}

आम 422 त्रुटियां

422 त्रुटि कोडसमाधान
enum / range / stepइस उपखंड की फ़ील्ड तालिका के अनुसार मान और अंतराल सुधारें।
unsupported_fieldइस ऑपरेशन की फ़ील्ड तालिका में मौजूद न होने वाले फ़ील्ड हटाएं।
requiresइस उपखंड की संयोजन सीमाओं के अनुसार सेकंड, अनुपात, ऑडियो सेटिंग या मीडिया जोड़ें।
excludesअपने-आप तय अवधि या अंतिम फ़्रेम से टकराने वाले फ़ील्ड हटाएं।

इमेज से वीडियो

wan2.7-i2v

इमेज से शुरुआती फ़्रेम या पहले और अंतिम फ़्रेम तय करने के लिए यह ऑपरेशन इस्तेमाल करें।

model को इस उपखंड के Model ID और operation को image_to_video पर सेट करें। केवल नीचे दिए गए जनरेशन फ़ील्ड इस्तेमाल करें। मीडिया को media ऐरे में रखें।

फ़ील्डप्रकारज़रूरीअनुमत मान या सीमाडिफ़ॉल्ट
audio.modestringनहींprovider_defaultprovider_default
duration.modestringनहींfixedfixed
duration.secondsintegerनहीं2–15, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए5
output.formatstringनहींmp4mp4
output.resolutionstringनहीं720p, 1080p1080p
promptstringहांस्ट्रिंगकोई नहीं
provider_options.alibaba.prompt_extendbooleanनहींtrue / false; प्रॉम्प्ट विस्तार नियंत्रित करता हैtrue
seedintegerनहीं0–2147483647, अंतराल 1; रैंडम सीड; 0 हो सकता हैकोई नहीं
watermarkbooleanनहींfalse, truefalse

मीडिया की ज़रूरतें

मीडिया भूमिकाप्रकार और संख्याफ़ॉर्मैटहर फ़ाइल की सीमाएं
first_frameimage, 1 (ज़रूरी)jpeg, jpg, png, bmp, webpअधिकतम आकार 20 MB; चौड़ाई 240–8000 px; ऊंचाई 240–8000 px
last_frameimage, वैकल्पिक, अधिकतम 1jpeg, jpg, png, bmp, webpअधिकतम आकार 20 MB; चौड़ाई 240–8000 px; ऊंचाई 240–8000 px
driving_audioaudio, वैकल्पिक, अधिकतम 1wav, mp3अधिकतम आकार 15 MB; अवधि 2–30 सेकंड

मीडिया ज़रूरी है या नहीं, यह नीचे की संयोजन सीमाओं पर भी निर्भर है।

वैकल्पिक driving_audio ड्राइविंग ऑडियो देता है और type="audio" इस्तेमाल करता है। यह रेफ़रेंस जनरेशन के reference_audio से अलग मीडिया भूमिका है।

संयोजन की सीमाएं

  • duration.mode="fixed" के साथ duration.seconds ज़रूरी है। fixed स्पष्ट रूप से सेट करते समय सेकंड भी भरें।
  • first_frame देना ज़रूरी है।

अनुरोध का उदाहरण

नीचे का JSON request.json में सेव करें। फिर साझा प्रक्रिया के अनुसार पहले अनुमान लें और पुष्टि के बाद टास्क बनाएं।

{
"model": "wan2.7-i2v",
"operation": "image_to_video",
"prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"output": {
"resolution": "720p"
},
"media": [
{
"id": "first",
"type": "image",
"role": "first_frame",
"source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png"
}
]
}

आम 422 त्रुटियां

422 त्रुटि कोडसमाधान
enum / range / stepइस उपखंड की फ़ील्ड तालिका के अनुसार मान और अंतराल सुधारें।
unsupported_fieldइस ऑपरेशन की फ़ील्ड तालिका में मौजूद न होने वाले फ़ील्ड हटाएं।
requiresइस उपखंड की संयोजन सीमाओं के अनुसार सेकंड, अनुपात, ऑडियो सेटिंग या मीडिया जोड़ें।
count / media_roleइस उपखंड की मीडिया तालिका के अनुसार भूमिका और संख्या सुधारें।
video_input_unsupportedसार्वजनिक HTTPS पता, Content-Type और फ़ाइल फ़ॉर्मैट जांचें, फिर नया अनुमान लें।

wan3.0-video-prime

इमेज से शुरुआती फ़्रेम या पहले और अंतिम फ़्रेम तय करने के लिए यह ऑपरेशन इस्तेमाल करें।

model को इस उपखंड के Model ID और operation को image_to_video पर सेट करें। केवल नीचे दिए गए जनरेशन फ़ील्ड इस्तेमाल करें। मीडिया को media ऐरे में रखें।

फ़ील्डप्रकारज़रूरीअनुमत मान या सीमाडिफ़ॉल्ट
audio.modestringनहींon, offon
duration.modestringनहींfixed, autofixed
duration.secondsintegerनहीं2–30, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए5
output.aspect_ratiostringनहींadaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16adaptive
output.formatstringनहींmp4mp4
output.resolutionstringनहीं480p, 720p, 1080p1080p
promptstringहांस्ट्रिंगकोई नहीं
provider_options.alibaba.prompt_extendbooleanनहींtrue / false; प्रॉम्प्ट विस्तार नियंत्रित करता हैtrue
seedintegerनहीं0–2147483647, अंतराल 1; रैंडम सीड; 0 हो सकता हैकोई नहीं
watermarkbooleanनहींfalse, truefalse

मीडिया की ज़रूरतें

मीडिया भूमिकाप्रकार और संख्याफ़ॉर्मैटहर फ़ाइल की सीमाएं
first_frameimage, 1 (ज़रूरी)jpeg, jpg, png, bmp, webpअधिकतम आकार 20 MB; चौड़ाई 240–8000 px; ऊंचाई 240–8000 px
last_frameimage, वैकल्पिक, अधिकतम 1jpeg, jpg, png, bmp, webpअधिकतम आकार 20 MB; चौड़ाई 240–8000 px; ऊंचाई 240–8000 px

मीडिया ज़रूरी है या नहीं, यह नीचे की संयोजन सीमाओं पर भी निर्भर है।

संयोजन की सीमाएं

  • duration.mode="fixed" के साथ duration.seconds ज़रूरी है। fixed स्पष्ट रूप से सेट करते समय सेकंड भी भरें।
  • duration.mode="auto" इस्तेमाल करते समय duration.seconds न भेजें।
  • इनमें से कम से कम एक भूमिका दें: first_frame, last_frame।

अनुरोध का उदाहरण

नीचे का JSON request.json में सेव करें। फिर साझा प्रक्रिया के अनुसार पहले अनुमान लें और पुष्टि के बाद टास्क बनाएं।

{
"model": "wan3.0-video-prime",
"operation": "image_to_video",
"prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"output": {
"resolution": "720p",
"aspect_ratio": "adaptive"
},
"media": [
{
"id": "first",
"type": "image",
"role": "first_frame",
"source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png"
}
]
}

आम 422 त्रुटियां

422 त्रुटि कोडसमाधान
enum / range / stepइस उपखंड की फ़ील्ड तालिका के अनुसार मान और अंतराल सुधारें।
unsupported_fieldइस ऑपरेशन की फ़ील्ड तालिका में मौजूद न होने वाले फ़ील्ड हटाएं।
requiresइस उपखंड की संयोजन सीमाओं के अनुसार सेकंड, अनुपात, ऑडियो सेटिंग या मीडिया जोड़ें।
excludesअपने-आप तय अवधि या अंतिम फ़्रेम से टकराने वाले फ़ील्ड हटाएं।
count / media_roleइस उपखंड की मीडिया तालिका के अनुसार भूमिका और संख्या सुधारें।
video_input_unsupportedसार्वजनिक HTTPS पता, Content-Type और फ़ाइल फ़ॉर्मैट जांचें, फिर नया अनुमान लें।

wan3.0-video

इमेज से शुरुआती फ़्रेम या पहले और अंतिम फ़्रेम तय करने के लिए यह ऑपरेशन इस्तेमाल करें।

model को इस उपखंड के Model ID और operation को image_to_video पर सेट करें। केवल नीचे दिए गए जनरेशन फ़ील्ड इस्तेमाल करें। मीडिया को media ऐरे में रखें।

फ़ील्डप्रकारज़रूरीअनुमत मान या सीमाडिफ़ॉल्ट
audio.modestringनहींon, offon
duration.modestringनहींfixed, autofixed
duration.secondsintegerनहीं2–30, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए5
output.aspect_ratiostringनहींadaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16adaptive
output.formatstringनहींmp4mp4
output.resolutionstringनहीं480p, 720p, 1080p1080p
promptstringहांस्ट्रिंगकोई नहीं
provider_options.alibaba.prompt_extendbooleanनहींtrue / false; प्रॉम्प्ट विस्तार नियंत्रित करता हैtrue
seedintegerनहीं0–2147483647, अंतराल 1; रैंडम सीड; 0 हो सकता हैकोई नहीं
watermarkbooleanनहींfalse, truefalse

मीडिया की ज़रूरतें

मीडिया भूमिकाप्रकार और संख्याफ़ॉर्मैटहर फ़ाइल की सीमाएं
first_frameimage, 1 (ज़रूरी)jpeg, jpg, png, bmp, webpअधिकतम आकार 20 MB; चौड़ाई 240–8000 px; ऊंचाई 240–8000 px
last_frameimage, वैकल्पिक, अधिकतम 1jpeg, jpg, png, bmp, webpअधिकतम आकार 20 MB; चौड़ाई 240–8000 px; ऊंचाई 240–8000 px

मीडिया ज़रूरी है या नहीं, यह नीचे की संयोजन सीमाओं पर भी निर्भर है।

संयोजन की सीमाएं

  • duration.mode="fixed" के साथ duration.seconds ज़रूरी है। fixed स्पष्ट रूप से सेट करते समय सेकंड भी भरें।
  • duration.mode="auto" इस्तेमाल करते समय duration.seconds न भेजें।
  • इनमें से कम से कम एक भूमिका दें: first_frame, last_frame।

अनुरोध का उदाहरण

नीचे का JSON request.json में सेव करें। फिर साझा प्रक्रिया के अनुसार पहले अनुमान लें और पुष्टि के बाद टास्क बनाएं।

{
"model": "wan3.0-video",
"operation": "image_to_video",
"prompt": "Slowly move the camera closer to the blue ceramic mug. Preserve its shape and the white table.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"output": {
"resolution": "720p",
"aspect_ratio": "adaptive"
},
"media": [
{
"id": "first",
"type": "image",
"role": "first_frame",
"source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png"
}
]
}

आम 422 त्रुटियां

422 त्रुटि कोडसमाधान
enum / range / stepइस उपखंड की फ़ील्ड तालिका के अनुसार मान और अंतराल सुधारें।
unsupported_fieldइस ऑपरेशन की फ़ील्ड तालिका में मौजूद न होने वाले फ़ील्ड हटाएं।
requiresइस उपखंड की संयोजन सीमाओं के अनुसार सेकंड, अनुपात, ऑडियो सेटिंग या मीडिया जोड़ें।
excludesअपने-आप तय अवधि या अंतिम फ़्रेम से टकराने वाले फ़ील्ड हटाएं।
count / media_roleइस उपखंड की मीडिया तालिका के अनुसार भूमिका और संख्या सुधारें।
video_input_unsupportedसार्वजनिक HTTPS पता, Content-Type और फ़ाइल फ़ॉर्मैट जांचें, फिर नया अनुमान लें।

रेफ़रेंस जनरेशन

wan2.7-r2v

रेफ़रेंस मीडिया से विषय या गति की विशेषताएं बनाए रखने के लिए यह ऑपरेशन इस्तेमाल करें।

model को इस उपखंड के Model ID और operation को reference_to_video पर सेट करें। केवल नीचे दिए गए जनरेशन फ़ील्ड इस्तेमाल करें। मीडिया को media ऐरे में रखें।

फ़ील्डप्रकारज़रूरीअनुमत मान या सीमाडिफ़ॉल्ट
audio.modestringनहींprovider_defaultprovider_default
duration.modestringनहींfixedfixed
duration.secondsintegerनहीं2–15, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए5
output.aspect_ratiostringनहीं16:9, 9:16, 1:1, 4:3, 3:416:9
output.formatstringनहींmp4mp4
output.resolutionstringनहीं720p, 1080p1080p
promptstringहांस्ट्रिंगकोई नहीं
provider_options.alibaba.prompt_extendbooleanनहींtrue / false; प्रॉम्प्ट विस्तार नियंत्रित करता हैtrue
seedintegerनहीं0–2147483647, अंतराल 1; रैंडम सीड; 0 हो सकता हैकोई नहीं
watermarkbooleanनहींfalse, truefalse

मीडिया की ज़रूरतें

मीडिया भूमिकाप्रकार और संख्याफ़ॉर्मैटहर फ़ाइल की सीमाएं
reference_imageimage, वैकल्पिक, अधिकतम 10jpeg, jpg, png, bmp, webpअधिकतम आकार 20 MB; चौड़ाई 240–8000 px; ऊंचाई 240–8000 px
reference_videovideo, वैकल्पिक, अधिकतम 5mp4, movअधिकतम आकार 100 MB; चौड़ाई 240–4096 px; ऊंचाई 240–4096 px; अवधि 1–15 सेकंड; न्यूनतम फ़्रेम रेट 16 fps; इस भूमिका का कुल अधिकतम 15 सेकंड

मीडिया ज़रूरी है या नहीं, यह नीचे की संयोजन सीमाओं पर भी निर्भर है।

संयोजन की सीमाएं

  • duration.mode="fixed" के साथ duration.seconds ज़रूरी है। fixed स्पष्ट रूप से सेट करते समय सेकंड भी भरें।
  • इनमें से कम से कम एक भूमिका दें: reference_image, reference_video।

अनुरोध का उदाहरण

नीचे का JSON request.json में सेव करें। फिर साझा प्रक्रिया के अनुसार पहले अनुमान लें और पुष्टि के बाद टास्क बनाएं।

{
"model": "wan2.7-r2v",
"operation": "reference_to_video",
"prompt": "Create a product video of the blue ceramic mug in the reference image. Keep its shape and color.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"output": {
"resolution": "720p",
"aspect_ratio": "16:9"
},
"media": [
{
"id": "reference",
"type": "image",
"role": "reference_image",
"source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png"
}
]
}

आम 422 त्रुटियां

422 त्रुटि कोडसमाधान
enum / range / stepइस उपखंड की फ़ील्ड तालिका के अनुसार मान और अंतराल सुधारें।
unsupported_fieldइस ऑपरेशन की फ़ील्ड तालिका में मौजूद न होने वाले फ़ील्ड हटाएं।
requiresइस उपखंड की संयोजन सीमाओं के अनुसार सेकंड, अनुपात, ऑडियो सेटिंग या मीडिया जोड़ें।
count / media_roleइस उपखंड की मीडिया तालिका के अनुसार भूमिका और संख्या सुधारें।
video_input_unsupportedसार्वजनिक HTTPS पता, Content-Type और फ़ाइल फ़ॉर्मैट जांचें, फिर नया अनुमान लें।

wan3.0-video-prime

रेफ़रेंस मीडिया से विषय या गति की विशेषताएं बनाए रखने के लिए यह ऑपरेशन इस्तेमाल करें।

model को इस उपखंड के Model ID और operation को reference_to_video पर सेट करें। केवल नीचे दिए गए जनरेशन फ़ील्ड इस्तेमाल करें। मीडिया को media ऐरे में रखें।

फ़ील्डप्रकारज़रूरीअनुमत मान या सीमाडिफ़ॉल्ट
audio.modestringनहींon, offon
duration.modestringनहींfixed, autofixed
duration.secondsintegerनहीं2–30, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए5
output.aspect_ratiostringनहींadaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16adaptive
output.formatstringनहींmp4mp4
output.resolutionstringनहीं480p, 720p, 1080p1080p
promptstringहांस्ट्रिंगकोई नहीं
provider_options.alibaba.prompt_extendbooleanनहींtrue / false; प्रॉम्प्ट विस्तार नियंत्रित करता हैtrue
seedintegerनहीं0–2147483647, अंतराल 1; रैंडम सीड; 0 हो सकता हैकोई नहीं
watermarkbooleanनहींfalse, truefalse

मीडिया की ज़रूरतें

मीडिया भूमिकाप्रकार और संख्याफ़ॉर्मैटहर फ़ाइल की सीमाएं
reference_imageimage, वैकल्पिक, अधिकतम 10jpeg, jpg, png, bmp, webpअधिकतम आकार 20 MB; चौड़ाई 240–8000 px; ऊंचाई 240–8000 px
reference_videovideo, वैकल्पिक, अधिकतम 5mp4, movअधिकतम आकार 100 MB; चौड़ाई 240–4096 px; ऊंचाई 240–4096 px; अवधि 1–15 सेकंड; न्यूनतम फ़्रेम रेट 16 fps; इस भूमिका का कुल अधिकतम 15 सेकंड
reference_audioaudio, वैकल्पिक, अधिकतम 5wav, mp3अधिकतम आकार 15 MB; अवधि 1–15 सेकंड; इस भूमिका का कुल अधिकतम 15 सेकंड

मीडिया ज़रूरी है या नहीं, यह नीचे की संयोजन सीमाओं पर भी निर्भर है।

संयोजन की सीमाएं

  • duration.mode="fixed" के साथ duration.seconds ज़रूरी है। fixed स्पष्ट रूप से सेट करते समय सेकंड भी भरें।
  • duration.mode="auto" इस्तेमाल करते समय duration.seconds न भेजें।
  • इनमें से कम से कम एक भूमिका दें: reference_image, reference_video, reference_audio।
  • रेफ़रेंस वीडियो होने पर सभी इनपुट वीडियो की कुल अवधि और आउटपुट अवधि का योग 30 सेकंड से अधिक नहीं होना चाहिए। अपने-आप तय होने वाली आउटपुट अवधि भी बची हुई सीमा के भीतर रहती है।

अनुरोध का उदाहरण

नीचे का JSON request.json में सेव करें। फिर साझा प्रक्रिया के अनुसार पहले अनुमान लें और पुष्टि के बाद टास्क बनाएं।

{
"model": "wan3.0-video-prime",
"operation": "reference_to_video",
"prompt": "Create a product video of the blue ceramic mug in the reference image. Keep its shape and color.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"output": {
"resolution": "720p",
"aspect_ratio": "adaptive"
},
"media": [
{
"id": "reference",
"type": "image",
"role": "reference_image",
"source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png"
}
]
}

आम 422 त्रुटियां

422 त्रुटि कोडसमाधान
enum / range / stepइस उपखंड की फ़ील्ड तालिका के अनुसार मान और अंतराल सुधारें।
unsupported_fieldइस ऑपरेशन की फ़ील्ड तालिका में मौजूद न होने वाले फ़ील्ड हटाएं।
requiresइस उपखंड की संयोजन सीमाओं के अनुसार सेकंड, अनुपात, ऑडियो सेटिंग या मीडिया जोड़ें।
excludesअपने-आप तय अवधि या अंतिम फ़्रेम से टकराने वाले फ़ील्ड हटाएं।
sum_lteरेफ़रेंस वीडियो की कुल अवधि या आउटपुट अवधि घटाएं, ताकि योग 30 सेकंड से अधिक न हो।
count / media_roleइस उपखंड की मीडिया तालिका के अनुसार भूमिका और संख्या सुधारें।
video_input_unsupportedसार्वजनिक HTTPS पता, Content-Type और फ़ाइल फ़ॉर्मैट जांचें, फिर नया अनुमान लें।

wan3.0-video

रेफ़रेंस मीडिया से विषय या गति की विशेषताएं बनाए रखने के लिए यह ऑपरेशन इस्तेमाल करें।

model को इस उपखंड के Model ID और operation को reference_to_video पर सेट करें। केवल नीचे दिए गए जनरेशन फ़ील्ड इस्तेमाल करें। मीडिया को media ऐरे में रखें।

फ़ील्डप्रकारज़रूरीअनुमत मान या सीमाडिफ़ॉल्ट
audio.modestringनहींon, offon
duration.modestringनहींfixed, autofixed
duration.secondsintegerनहीं2–30, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए5
output.aspect_ratiostringनहींadaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16adaptive
output.formatstringनहींmp4mp4
output.resolutionstringनहीं480p, 720p, 1080p1080p
promptstringहांस्ट्रिंगकोई नहीं
provider_options.alibaba.prompt_extendbooleanनहींtrue / false; प्रॉम्प्ट विस्तार नियंत्रित करता हैtrue
seedintegerनहीं0–2147483647, अंतराल 1; रैंडम सीड; 0 हो सकता हैकोई नहीं
watermarkbooleanनहींfalse, truefalse

मीडिया की ज़रूरतें

मीडिया भूमिकाप्रकार और संख्याफ़ॉर्मैटहर फ़ाइल की सीमाएं
reference_imageimage, वैकल्पिक, अधिकतम 10jpeg, jpg, png, bmp, webpअधिकतम आकार 20 MB; चौड़ाई 240–8000 px; ऊंचाई 240–8000 px
reference_videovideo, वैकल्पिक, अधिकतम 5mp4, movअधिकतम आकार 100 MB; चौड़ाई 240–4096 px; ऊंचाई 240–4096 px; अवधि 1–15 सेकंड; न्यूनतम फ़्रेम रेट 16 fps; इस भूमिका का कुल अधिकतम 15 सेकंड
reference_audioaudio, वैकल्पिक, अधिकतम 5wav, mp3अधिकतम आकार 15 MB; अवधि 1–15 सेकंड; इस भूमिका का कुल अधिकतम 15 सेकंड

मीडिया ज़रूरी है या नहीं, यह नीचे की संयोजन सीमाओं पर भी निर्भर है।

संयोजन की सीमाएं

  • duration.mode="fixed" के साथ duration.seconds ज़रूरी है। fixed स्पष्ट रूप से सेट करते समय सेकंड भी भरें।
  • duration.mode="auto" इस्तेमाल करते समय duration.seconds न भेजें।
  • इनमें से कम से कम एक भूमिका दें: reference_image, reference_video, reference_audio।
  • रेफ़रेंस वीडियो होने पर सभी इनपुट वीडियो की कुल अवधि और आउटपुट अवधि का योग 30 सेकंड से अधिक नहीं होना चाहिए। अपने-आप तय होने वाली आउटपुट अवधि भी बची हुई सीमा के भीतर रहती है।

अनुरोध का उदाहरण

नीचे का JSON request.json में सेव करें। फिर साझा प्रक्रिया के अनुसार पहले अनुमान लें और पुष्टि के बाद टास्क बनाएं।

{
"model": "wan3.0-video",
"operation": "reference_to_video",
"prompt": "Create a product video of the blue ceramic mug in the reference image. Keep its shape and color.",
"duration": {
"mode": "fixed",
"seconds": 5
},
"output": {
"resolution": "720p",
"aspect_ratio": "adaptive"
},
"media": [
{
"id": "reference",
"type": "image",
"role": "reference_image",
"source": "https://docs.bettertoken.ai/images/nano-banana-guide/sample-07.png"
}
]
}

आम 422 त्रुटियां

422 त्रुटि कोडसमाधान
enum / range / stepइस उपखंड की फ़ील्ड तालिका के अनुसार मान और अंतराल सुधारें।
unsupported_fieldइस ऑपरेशन की फ़ील्ड तालिका में मौजूद न होने वाले फ़ील्ड हटाएं।
requiresइस उपखंड की संयोजन सीमाओं के अनुसार सेकंड, अनुपात, ऑडियो सेटिंग या मीडिया जोड़ें।
excludesअपने-आप तय अवधि या अंतिम फ़्रेम से टकराने वाले फ़ील्ड हटाएं।
sum_lteरेफ़रेंस वीडियो की कुल अवधि या आउटपुट अवधि घटाएं, ताकि योग 30 सेकंड से अधिक न हो।
count / media_roleइस उपखंड की मीडिया तालिका के अनुसार भूमिका और संख्या सुधारें।
video_input_unsupportedसार्वजनिक HTTPS पता, Content-Type और फ़ाइल फ़ॉर्मैट जांचें, फिर नया अनुमान लें।

वीडियो एडिटिंग

wan2.7-videoedit

मौजूदा वीडियो के दृश्य बदलने के लिए यह ऑपरेशन इस्तेमाल करें। पहले सीमाएं पूरी करने वाला सोर्स वीडियो तैयार करें।

model को इस उपखंड के Model ID और operation को video_edit पर सेट करें। केवल नीचे दिए गए जनरेशन फ़ील्ड इस्तेमाल करें। मीडिया को media ऐरे में रखें।

फ़ील्डप्रकारज़रूरीअनुमत मान या सीमाडिफ़ॉल्ट
audio.modestringनहींprovider_defaultprovider_default
duration.modestringनहींfixed, autoauto
duration.secondsintegerनहीं2–15, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिएकोई नहीं
output.formatstringनहींmp4mp4
output.resolutionstringनहीं720p, 1080p1080p
promptstringहांस्ट्रिंगकोई नहीं
provider_options.alibaba.prompt_extendbooleanनहींtrue / false; प्रॉम्प्ट विस्तार नियंत्रित करता हैtrue
seedintegerनहीं0–2147483647, अंतराल 1; रैंडम सीड; 0 हो सकता हैकोई नहीं
watermarkbooleanनहींfalse, truefalse

मीडिया की ज़रूरतें

मीडिया भूमिकाप्रकार और संख्याफ़ॉर्मैटहर फ़ाइल की सीमाएं
base_videovideo, 1 (ज़रूरी)mp4, movअधिकतम आकार 100 MB; चौड़ाई 240–4096 px; ऊंचाई 240–4096 px; अवधि 1–15 सेकंड; न्यूनतम फ़्रेम रेट 16 fps; इस भूमिका का कुल अधिकतम 15 सेकंड

मीडिया ज़रूरी है या नहीं, यह नीचे की संयोजन सीमाओं पर भी निर्भर है।

संयोजन की सीमाएं

  • duration.mode="fixed" के साथ duration.seconds ज़रूरी है। fixed स्पष्ट रूप से सेट करते समय सेकंड भी भरें।
  • base_video देना ज़रूरी है।
  • duration.mode="auto" इस्तेमाल करते समय duration.seconds न भेजें।

अनुरोध का उदाहरण

नीचे का JSON request.json में सेव करें। फिर साझा प्रक्रिया के अनुसार पहले अनुमान लें और पुष्टि के बाद टास्क बनाएं।

{
"model": "wan2.7-videoedit",
"operation": "video_edit",
"prompt": "Keep the boy and his motion in the source video. Give the city plaza warmer evening lighting.",
"duration": {
"mode": "auto"
},
"output": {
"resolution": "720p"
},
"media": [
{
"id": "base",
"type": "video",
"role": "base_video",
"source": "https://bettertoken.ai/video-api/shared/kling-hero-3.0.mp4"
}
]
}

आम 422 त्रुटियां

422 त्रुटि कोडसमाधान
enum / range / stepइस उपखंड की फ़ील्ड तालिका के अनुसार मान और अंतराल सुधारें।
unsupported_fieldइस ऑपरेशन की फ़ील्ड तालिका में मौजूद न होने वाले फ़ील्ड हटाएं।
requiresइस उपखंड की संयोजन सीमाओं के अनुसार सेकंड, अनुपात, ऑडियो सेटिंग या मीडिया जोड़ें।
excludesअपने-आप तय अवधि या अंतिम फ़्रेम से टकराने वाले फ़ील्ड हटाएं।
count / media_roleइस उपखंड की मीडिया तालिका के अनुसार भूमिका और संख्या सुधारें।
video_input_unsupportedसार्वजनिक HTTPS पता, Content-Type और फ़ाइल फ़ॉर्मैट जांचें, फिर नया अनुमान लें।

आधिकारिक संसाधन

BetterToken कॉल करते समय इस पेज के फ़ील्ड और वर्तमान मॉडल सूची का संबंधित ऑपरेशन इस्तेमाल करें।