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-i2v | image_to_video | 2–15, अंतराल 1 | 720p, 1080p | न भेजें | provider_default | first_frame, last_frame, driving_audio |
wan2.7-r2v | reference_to_video | 2–15, अंतराल 1 | 720p, 1080p | 16:9, 9:16, 1:1, 4:3, 3:4 | provider_default | reference_image, reference_video |
wan2.7-t2v | text_to_video | 2–15, अंतराल 1 | 720p, 1080p | 16:9, 9:16, 1:1, 4:3, 3:4 | provider_default | driving_audio |
wan2.7-videoedit | video_edit | 2–15, अंतराल 1; उपलब्ध auto | 720p, 1080p | न भेजें | provider_default | base_video |
wan3.0-video-prime | image_to_video | 2–30, अंतराल 1; उपलब्ध auto | 480p, 720p, 1080p | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | on, off | first_frame, last_frame |
wan3.0-video-prime | reference_to_video | 2–30, अंतराल 1; उपलब्ध auto | 480p, 720p, 1080p | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | on, off | reference_image, reference_video, reference_audio |
wan3.0-video-prime | text_to_video | 2–30, अंतराल 1; उपलब्ध auto | 480p, 720p, 1080p | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | on, off | कोई नहीं |
wan3.0-video | image_to_video | 2–30, अंतराल 1; उपलब्ध auto | 480p, 720p, 1080p | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | on, off | first_frame, last_frame |
wan3.0-video | reference_to_video | 2–30, अंतराल 1; उपलब्ध auto | 480p, 720p, 1080p | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | on, off | reference_image, reference_video, reference_audio |
wan3.0-video | text_to_video | 2–30, अंतराल 1; उपलब्ध auto | 480p, 720p, 1080p | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | on, 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.mode | string | नहीं | provider_default | provider_default |
duration.mode | string | नहीं | fixed | fixed |
duration.seconds | integer | नहीं | 2–15, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए | 5 |
output.aspect_ratio | string | नहीं | 16:9, 9:16, 1:1, 4:3, 3:4 | 16:9 |
output.format | string | नहीं | mp4 | mp4 |
output.resolution | string | नहीं | 720p, 1080p | 1080p |
prompt | string | हां | स्ट्रिंग | कोई नहीं |
provider_options.alibaba.prompt_extend | boolean | नहीं | true / false; प्रॉम्प्ट विस्तार नियंत्रित करता है | true |
seed | integer | नहीं | 0–2147483647, अंतराल 1; रैंडम सीड; 0 हो सकता है | कोई नहीं |
watermark | boolean | नहीं | false, true | false |
मीडिया की ज़रूरतें
| मीडिया भूमिका | प्रकार और संख्या | फ़ॉर्मैट | हर फ़ाइल की सीमाएं |
|---|---|---|---|
driving_audio | audio, वैकल्पिक, अधिकतम 1 | wav, 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.mode | string | नहीं | on, off | on |
duration.mode | string | नहीं | fixed, auto | fixed |
duration.seconds | integer | नहीं | 2–30, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए | 5 |
output.aspect_ratio | string | नहीं | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | adaptive |
output.format | string | नहीं | mp4 | mp4 |
output.resolution | string | नहीं | 480p, 720p, 1080p | 1080p |
prompt | string | हां | स्ट्रिंग | कोई नहीं |
provider_options.alibaba.prompt_extend | boolean | नहीं | true / false; प्रॉम्प्ट विस्तार नियंत्रित करता है | true |
seed | integer | नहीं | 0–2147483647, अंतराल 1; रैंडम सीड; 0 हो सकता है | कोई नहीं |
watermark | boolean | नहीं | false, true | false |
मीडिया की ज़रूरतें
यह ऑपरेशन मीडिया स्वीकार नहीं करता।
संयोजन की सीमाएं
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.mode | string | नहीं | on, off | on |
duration.mode | string | नहीं | fixed, auto | fixed |
duration.seconds | integer | नहीं | 2–30, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए | 5 |
output.aspect_ratio | string | नहीं | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | adaptive |
output.format | string | नहीं | mp4 | mp4 |
output.resolution | string | नहीं | 480p, 720p, 1080p | 1080p |
prompt | string | हां | स्ट्रिंग | कोई नहीं |
provider_options.alibaba.prompt_extend | boolean | नहीं | true / false; प्रॉम्प्ट विस्तार नियंत्रित करता है | true |
seed | integer | नहीं | 0–2147483647, अंतराल 1; रैंडम सीड; 0 हो सकता है | कोई नहीं |
watermark | boolean | नहीं | false, true | false |
मीडिया की ज़रूरतें
यह ऑपरेशन मीडिया स्वीकार नहीं करता।
संयोजन की सीमाएं
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.mode | string | नहीं | provider_default | provider_default |
duration.mode | string | नहीं | fixed | fixed |
duration.seconds | integer | नहीं | 2–15, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए | 5 |
output.format | string | नहीं | mp4 | mp4 |
output.resolution | string | नहीं | 720p, 1080p | 1080p |
prompt | string | हां | स्ट्रिंग | कोई नहीं |
provider_options.alibaba.prompt_extend | boolean | नहीं | true / false; प्रॉम्प्ट विस्तार नियंत्रित करता है | true |
seed | integer | नहीं | 0–2147483647, अंतराल 1; रैंडम सीड; 0 हो सकता है | कोई नहीं |
watermark | boolean | नहीं | false, true | false |
मीडिया की ज़रूरतें
| मीडिया भूमिका | प्रकार और संख्या | फ़ॉर्मैट | हर फ़ाइल की सीमाएं |
|---|---|---|---|
first_frame | image, 1 (ज़रूरी) | jpeg, jpg, png, bmp, webp | अधिकतम आकार 20 MB; चौड़ाई 240–8000 px; ऊंचाई 240–8000 px |
last_frame | image, वैकल्पिक, अधिकतम 1 | jpeg, jpg, png, bmp, webp | अधिकतम आकार 20 MB; चौड़ाई 240–8000 px; ऊंचाई 240–8000 px |
driving_audio | audio, वैकल्पिक, अधिकतम 1 | wav, 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.mode | string | नहीं | on, off | on |
duration.mode | string | नहीं | fixed, auto | fixed |
duration.seconds | integer | नहीं | 2–30, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए | 5 |
output.aspect_ratio | string | नहीं | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | adaptive |
output.format | string | नहीं | mp4 | mp4 |
output.resolution | string | नहीं | 480p, 720p, 1080p | 1080p |
prompt | string | हां | स्ट्रिंग | कोई नहीं |
provider_options.alibaba.prompt_extend | boolean | नहीं | true / false; प्रॉम्प्ट विस्तार नियंत्रित करता है | true |
seed | integer | नहीं | 0–2147483647, अंतराल 1; रैंडम सीड; 0 हो सकता है | कोई नहीं |
watermark | boolean | नहीं | false, true | false |
मीडिया की ज़रूरतें
| मीडिया भूमिका | प्रकार और संख्या | फ़ॉर्मैट | हर फ़ाइल की सीमाएं |
|---|---|---|---|
first_frame | image, 1 (ज़रूरी) | jpeg, jpg, png, bmp, webp | अधिकतम आकार 20 MB; चौड़ाई 240–8000 px; ऊंचाई 240–8000 px |
last_frame | image, वैकल्पिक, अधिकतम 1 | jpeg, 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.mode | string | नहीं | on, off | on |
duration.mode | string | नहीं | fixed, auto | fixed |
duration.seconds | integer | नहीं | 2–30, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए | 5 |
output.aspect_ratio | string | नहीं | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | adaptive |
output.format | string | नहीं | mp4 | mp4 |
output.resolution | string | नहीं | 480p, 720p, 1080p | 1080p |
prompt | string | हां | स्ट्रिंग | कोई नहीं |
provider_options.alibaba.prompt_extend | boolean | नहीं | true / false; प्रॉम्प्ट विस्तार नियंत्रित करता है | true |
seed | integer | नहीं | 0–2147483647, अंतराल 1; रैंडम सीड; 0 हो सकता है | कोई नहीं |
watermark | boolean | नहीं | false, true | false |
मीडिया की ज़रूरतें
| मीडिया भूमिका | प्रकार और संख्या | फ़ॉर्मैट | हर फ़ाइल की सीमाएं |
|---|---|---|---|
first_frame | image, 1 (ज़रूरी) | jpeg, jpg, png, bmp, webp | अधिकतम आकार 20 MB; चौड़ाई 240–8000 px; ऊंचाई 240–8000 px |
last_frame | image, वैकल्पिक, अधिकतम 1 | jpeg, 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.mode | string | नहीं | provider_default | provider_default |
duration.mode | string | नहीं | fixed | fixed |
duration.seconds | integer | नहीं | 2–15, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए | 5 |
output.aspect_ratio | string | नहीं | 16:9, 9:16, 1:1, 4:3, 3:4 | 16:9 |
output.format | string | नहीं | mp4 | mp4 |
output.resolution | string | नहीं | 720p, 1080p | 1080p |
prompt | string | हां | स्ट्रिंग | कोई नहीं |
provider_options.alibaba.prompt_extend | boolean | नहीं | true / false; प्रॉम्प्ट विस्तार नियंत्रित करता है | true |
seed | integer | नहीं | 0–2147483647, अंतराल 1; रैंडम सीड; 0 हो सकता है | कोई नहीं |
watermark | boolean | नहीं | false, true | false |
मीडिया की ज़रूरतें
| मीडिया भूमिका | प्रकार और संख्या | फ़ॉर्मैट | हर फ़ाइल की सीमाएं |
|---|---|---|---|
reference_image | image, वैकल्पिक, अधिकतम 10 | jpeg, jpg, png, bmp, webp | अधिकतम आकार 20 MB; चौड़ाई 240–8000 px; ऊंचाई 240–8000 px |
reference_video | video, वैकल्पिक, अधिकतम 5 | mp4, 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.mode | string | नहीं | on, off | on |
duration.mode | string | नहीं | fixed, auto | fixed |
duration.seconds | integer | नहीं | 2–30, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए | 5 |
output.aspect_ratio | string | नहीं | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | adaptive |
output.format | string | नहीं | mp4 | mp4 |
output.resolution | string | नहीं | 480p, 720p, 1080p | 1080p |
prompt | string | हां | स्ट्रिंग | कोई नहीं |
provider_options.alibaba.prompt_extend | boolean | नहीं | true / false; प्रॉम्प्ट विस्तार नियंत्रित करता है | true |
seed | integer | नहीं | 0–2147483647, अंतराल 1; रैंडम सीड; 0 हो सकता है | कोई नहीं |
watermark | boolean | नहीं | false, true | false |
मीडिया की ज़रूरतें
| मीडिया भूमिका | प्रकार और संख्या | फ़ॉर्मैट | हर फ़ाइल की सीमाएं |
|---|---|---|---|
reference_image | image, वैकल्पिक, अधिकतम 10 | jpeg, jpg, png, bmp, webp | अधिकतम आकार 20 MB; चौड़ाई 240–8000 px; ऊंचाई 240–8000 px |
reference_video | video, वैकल्पिक, अधिकतम 5 | mp4, mov | अधिकतम आकार 100 MB; चौड़ाई 240–4096 px; ऊंचाई 240–4096 px; अवधि 1–15 सेकंड; न्यूनतम फ़्रेम रेट 16 fps; इस भूमिका का कुल अधिकतम 15 सेकंड |
reference_audio | audio, वैकल्पिक, अधिकतम 5 | wav, 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.mode | string | नहीं | on, off | on |
duration.mode | string | नहीं | fixed, auto | fixed |
duration.seconds | integer | नहीं | 2–30, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए | 5 |
output.aspect_ratio | string | नहीं | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | adaptive |
output.format | string | नहीं | mp4 | mp4 |
output.resolution | string | नहीं | 480p, 720p, 1080p | 1080p |
prompt | string | हां | स्ट्रिंग | कोई नहीं |
provider_options.alibaba.prompt_extend | boolean | नहीं | true / false; प्रॉम्प्ट विस्तार नियंत्रित करता है | true |
seed | integer | नहीं | 0–2147483647, अंतराल 1; रैंडम सीड; 0 हो सकता है | कोई नहीं |
watermark | boolean | नहीं | false, true | false |
मीडिया की ज़रूरतें
| मीडिया भूमिका | प्रकार और संख्या | फ़ॉर्मैट | हर फ़ाइल की सीमाएं |
|---|---|---|---|
reference_image | image, वैकल्पिक, अधिकतम 10 | jpeg, jpg, png, bmp, webp | अधिकतम आकार 20 MB; चौड़ाई 240–8000 px; ऊंचाई 240–8000 px |
reference_video | video, वैकल्पिक, अधिकतम 5 | mp4, mov | अधिकतम आकार 100 MB; चौड़ाई 240–4096 px; ऊंचाई 240–4096 px; अवधि 1–15 सेकंड; न्यूनतम फ़्रेम रेट 16 fps; इस भूमिका का कुल अधिकतम 15 सेकंड |
reference_audio | audio, वैकल्पिक, अधिकतम 5 | wav, 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.mode | string | नहीं | provider_default | provider_default |
duration.mode | string | नहीं | fixed, auto | auto |
duration.seconds | integer | नहीं | 2–15, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए | कोई नहीं |
output.format | string | नहीं | mp4 | mp4 |
output.resolution | string | नहीं | 720p, 1080p | 1080p |
prompt | string | हां | स्ट्रिंग | कोई नहीं |
provider_options.alibaba.prompt_extend | boolean | नहीं | true / false; प्रॉम्प्ट विस्तार नियंत्रित करता है | true |
seed | integer | नहीं | 0–2147483647, अंतराल 1; रैंडम सीड; 0 हो सकता है | कोई नहीं |
watermark | boolean | नहीं | false, true | false |
मीडिया की ज़रूरतें
| मीडिया भूमिका | प्रकार और संख्या | फ़ॉर्मैट | हर फ़ाइल की सीमाएं |
|---|---|---|---|
base_video | video, 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 कॉल करते समय इस पेज के फ़ील्ड और वर्तमान मॉडल सूची का संबंधित ऑपरेशन इस्तेमाल करें।

