Seedance वीडियो API: मॉडल, फ़ील्ड और मीडिया की ज़रूरतें
BetterToken API Key से Seedance कनेक्ट करें और Model ID व ऑपरेशन के अनुसार फ़ील्ड, मीडिया और जनरेशन का तरीका चुनें।
टेक्स्ट, पहले फ़्रेम या रेफ़रेंस मीडिया से वीडियो बनाएं। चीन क्षेत्र के चार मॉडल तीन जनरेशन ऑपरेशन का समर्थन करते हैं। दो SR मॉडल टेक्स्ट और एक पहले फ़्रेम से वीडियो बना सकते हैं। ऑपरेशन, अवधि और आउटपुट स्तर के अनुसार 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 | ऑपरेशन | अवधि (सेकंड) | आउटपुट स्तर | अनुपात | ऑडियो | मीडिया भूमिकाएं |
|---|---|---|---|---|---|---|
ByteDance-Seedance-2.0-SR | image_to_video | 5–10, अंतराल 5 | 720p, 1080p, 4k | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | first_frame |
ByteDance-Seedance-2.0-SR | text_to_video | 5–10, अंतराल 5 | 720p, 1080p, 4k | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | कोई नहीं |
ByteDance-Seedance-2.5-SR | image_to_video | 5–10, अंतराल 5 | 720p, 1080p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | first_frame |
ByteDance-Seedance-2.5-SR | text_to_video | 5–10, अंतराल 5 | 720p, 1080p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | कोई नहीं |
doubao-seedance-2-0-260128 | image_to_video | 4–15, अंतराल 1; उपलब्ध auto | 480p, 720p, 1080p, 4k | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | first_frame, last_frame |
doubao-seedance-2-0-260128 | reference_to_video | 4–15, अंतराल 1; उपलब्ध auto | 480p, 720p, 1080p, 4k | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | reference_image, reference_video, reference_audio |
doubao-seedance-2-0-260128 | text_to_video | 4–15, अंतराल 1; उपलब्ध auto | 480p, 720p, 1080p, 4k | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | कोई नहीं |
doubao-seedance-2-0-fast-260128 | image_to_video | 4–15, अंतराल 1; उपलब्ध auto | 480p, 720p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | first_frame, last_frame |
doubao-seedance-2-0-fast-260128 | reference_to_video | 4–15, अंतराल 1; उपलब्ध auto | 480p, 720p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | reference_image, reference_video, reference_audio |
doubao-seedance-2-0-fast-260128 | text_to_video | 4–15, अंतराल 1; उपलब्ध auto | 480p, 720p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | कोई नहीं |
doubao-seedance-2-0-mini-260615 | image_to_video | 4–15, अंतराल 1; उपलब्ध auto | 480p, 720p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | first_frame, last_frame |
doubao-seedance-2-0-mini-260615 | reference_to_video | 4–15, अंतराल 1; उपलब्ध auto | 480p, 720p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | reference_image, reference_video, reference_audio |
doubao-seedance-2-0-mini-260615 | text_to_video | 4–15, अंतराल 1; उपलब्ध auto | 480p, 720p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | कोई नहीं |
doubao-seedance-2-5-260628 | image_to_video | 4–30, अंतराल 1; उपलब्ध auto | 480p, 720p, 1080p | adaptive | on, off | first_frame, last_frame |
doubao-seedance-2-5-260628 | reference_to_video | 4–30, अंतराल 1; उपलब्ध auto | 480p, 720p, 1080p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | reference_image, reference_video, reference_audio |
doubao-seedance-2-5-260628 | text_to_video | 4–30, अंतराल 1; उपलब्ध auto | 480p, 720p, 1080p | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | on, off | कोई नहीं |
दोनों SR मॉडल की निश्चित अवधि केवल 5 या 10 सेकंड हो सकती है। चीन क्षेत्र और SR मॉडल के Model ID अलग हैं। एक मॉडल की फ़ील्ड या मीडिया सीमाएं दूसरे पर लागू न करें।
नमूना मीडिया
इमेज से वीडियो और इमेज रेफ़रेंस वाले उदाहरण सफ़ेद मेज़ पर नीले सिरेमिक मग का इस्तेमाल करते हैं। आज़माने के लिए नमूना इमेज रखें, या पहले इसे ऐसे सार्वजनिक HTTPS मीडिया से बदलें जिसे इस्तेमाल करने का अधिकार आपके पास हो और जो इस पेज की सीमाएं पूरी करता हो।

टेक्स्ट से वीडियो
ByteDance-Seedance-2.0-SR
केवल टेक्स्ट विवरण होने पर यह ऑपरेशन इस्तेमाल करें।
model को इस उपखंड के Model ID और operation को text_to_video पर सेट करें। केवल नीचे दिए गए जनरेशन फ़ील्ड इस्तेमाल करें। मीडिया को media ऐरे में रखें।
| फ़ील्ड | प्रकार | ज़रूरी | अनुमत मान या सीमा | डिफ़ॉल्ट |
|---|---|---|---|---|
audio.mode | string | नहीं | on, off | on |
duration.mode | string | नहीं | fixed | fixed |
duration.seconds | integer | नहीं | 5–10, अंतराल 5 सेकंड; केवल निश्चित अवधि के लिए | 5 |
output.aspect_ratio | string | नहीं | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | 16:9 |
output.format | string | नहीं | mp4 | mp4 |
output.resolution | string | नहीं | 720p, 1080p, 4k | 720p |
prompt | string | हां | स्ट्रिंग | कोई नहीं |
watermark | boolean | नहीं | false | false |
मीडिया की ज़रूरतें
यह ऑपरेशन मीडिया स्वीकार नहीं करता।
संयोजन की सीमाएं
duration.mode="fixed"के साथduration.secondsज़रूरी है।fixedस्पष्ट रूप से सेट करते समय सेकंड भी भरें।
अनुरोध का उदाहरण
नीचे का JSON request.json में सेव करें। फिर साझा प्रक्रिया के अनुसार पहले अनुमान लें और पुष्टि के बाद टास्क बनाएं।
{ "model": "ByteDance-Seedance-2.0-SR", "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 | इस उपखंड की संयोजन सीमाओं के अनुसार सेकंड, अनुपात, ऑडियो सेटिंग या मीडिया जोड़ें। |
ByteDance-Seedance-2.5-SR
केवल टेक्स्ट विवरण होने पर यह ऑपरेशन इस्तेमाल करें।
model को इस उपखंड के Model ID और operation को text_to_video पर सेट करें। केवल नीचे दिए गए जनरेशन फ़ील्ड इस्तेमाल करें। मीडिया को media ऐरे में रखें।
| फ़ील्ड | प्रकार | ज़रूरी | अनुमत मान या सीमा | डिफ़ॉल्ट |
|---|---|---|---|---|
audio.mode | string | नहीं | on, off | on |
duration.mode | string | नहीं | fixed | fixed |
duration.seconds | integer | नहीं | 5–10, अंतराल 5 सेकंड; केवल निश्चित अवधि के लिए | 5 |
output.aspect_ratio | string | नहीं | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | 16:9 |
output.format | string | नहीं | mp4 | mp4 |
output.resolution | string | नहीं | 720p, 1080p | 720p |
prompt | string | हां | स्ट्रिंग | कोई नहीं |
watermark | boolean | नहीं | false | false |
मीडिया की ज़रूरतें
यह ऑपरेशन मीडिया स्वीकार नहीं करता।
संयोजन की सीमाएं
duration.mode="fixed"के साथduration.secondsज़रूरी है।fixedस्पष्ट रूप से सेट करते समय सेकंड भी भरें।
अनुरोध का उदाहरण
नीचे का JSON request.json में सेव करें। फिर साझा प्रक्रिया के अनुसार पहले अनुमान लें और पुष्टि के बाद टास्क बनाएं।
{ "model": "ByteDance-Seedance-2.5-SR", "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 | इस उपखंड की संयोजन सीमाओं के अनुसार सेकंड, अनुपात, ऑडियो सेटिंग या मीडिया जोड़ें। |
doubao-seedance-2-0-260128
केवल टेक्स्ट विवरण होने पर यह ऑपरेशन इस्तेमाल करें।
model को इस उपखंड के Model ID और operation को text_to_video पर सेट करें। केवल नीचे दिए गए जनरेशन फ़ील्ड इस्तेमाल करें। मीडिया को media ऐरे में रखें।
| फ़ील्ड | प्रकार | ज़रूरी | अनुमत मान या सीमा | डिफ़ॉल्ट |
|---|---|---|---|---|
audio.mode | string | नहीं | on, off | on |
duration.mode | string | नहीं | fixed, auto | fixed |
duration.seconds | integer | नहीं | 4–15, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए | कोई नहीं |
output.aspect_ratio | string | नहीं | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | नहीं | mp4 | mp4 |
output.resolution | string | नहीं | 480p, 720p, 1080p, 4k | 720p |
prompt | string | हां | स्ट्रिंग | कोई नहीं |
watermark | boolean | नहीं | false, true | false |
मीडिया की ज़रूरतें
यह ऑपरेशन मीडिया स्वीकार नहीं करता।
संयोजन की सीमाएं
duration.mode="fixed"के साथduration.secondsज़रूरी है।fixedस्पष्ट रूप से सेट करते समय सेकंड भी भरें।duration.mode="auto"इस्तेमाल करते समयduration.secondsन भेजें।
अनुरोध का उदाहरण
नीचे का JSON request.json में सेव करें। फिर साझा प्रक्रिया के अनुसार पहले अनुमान लें और पुष्टि के बाद टास्क बनाएं।
{ "model": "doubao-seedance-2-0-260128", "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 | अपने-आप तय अवधि या अंतिम फ़्रेम से टकराने वाले फ़ील्ड हटाएं। |
doubao-seedance-2-0-fast-260128
केवल टेक्स्ट विवरण होने पर यह ऑपरेशन इस्तेमाल करें।
model को इस उपखंड के Model ID और operation को text_to_video पर सेट करें। केवल नीचे दिए गए जनरेशन फ़ील्ड इस्तेमाल करें। मीडिया को media ऐरे में रखें।
| फ़ील्ड | प्रकार | ज़रूरी | अनुमत मान या सीमा | डिफ़ॉल्ट |
|---|---|---|---|---|
audio.mode | string | नहीं | on, off | on |
duration.mode | string | नहीं | fixed, auto | fixed |
duration.seconds | integer | नहीं | 4–15, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए | कोई नहीं |
output.aspect_ratio | string | नहीं | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | नहीं | mp4 | mp4 |
output.resolution | string | नहीं | 480p, 720p | 720p |
prompt | string | हां | स्ट्रिंग | कोई नहीं |
watermark | boolean | नहीं | false, true | false |
मीडिया की ज़रूरतें
यह ऑपरेशन मीडिया स्वीकार नहीं करता।
संयोजन की सीमाएं
duration.mode="fixed"के साथduration.secondsज़रूरी है।fixedस्पष्ट रूप से सेट करते समय सेकंड भी भरें।duration.mode="auto"इस्तेमाल करते समयduration.secondsन भेजें।
अनुरोध का उदाहरण
नीचे का JSON request.json में सेव करें। फिर साझा प्रक्रिया के अनुसार पहले अनुमान लें और पुष्टि के बाद टास्क बनाएं।
{ "model": "doubao-seedance-2-0-fast-260128", "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 | अपने-आप तय अवधि या अंतिम फ़्रेम से टकराने वाले फ़ील्ड हटाएं। |
doubao-seedance-2-0-mini-260615
केवल टेक्स्ट विवरण होने पर यह ऑपरेशन इस्तेमाल करें।
model को इस उपखंड के Model ID और operation को text_to_video पर सेट करें। केवल नीचे दिए गए जनरेशन फ़ील्ड इस्तेमाल करें। मीडिया को media ऐरे में रखें।
| फ़ील्ड | प्रकार | ज़रूरी | अनुमत मान या सीमा | डिफ़ॉल्ट |
|---|---|---|---|---|
audio.mode | string | नहीं | on, off | on |
duration.mode | string | नहीं | fixed, auto | fixed |
duration.seconds | integer | नहीं | 4–15, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए | कोई नहीं |
output.aspect_ratio | string | नहीं | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | नहीं | mp4 | mp4 |
output.resolution | string | नहीं | 480p, 720p | 720p |
prompt | string | हां | स्ट्रिंग | कोई नहीं |
watermark | boolean | नहीं | false, true | false |
मीडिया की ज़रूरतें
यह ऑपरेशन मीडिया स्वीकार नहीं करता।
संयोजन की सीमाएं
duration.mode="fixed"के साथduration.secondsज़रूरी है।fixedस्पष्ट रूप से सेट करते समय सेकंड भी भरें।duration.mode="auto"इस्तेमाल करते समयduration.secondsन भेजें।
अनुरोध का उदाहरण
नीचे का JSON request.json में सेव करें। फिर साझा प्रक्रिया के अनुसार पहले अनुमान लें और पुष्टि के बाद टास्क बनाएं।
{ "model": "doubao-seedance-2-0-mini-260615", "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 | अपने-आप तय अवधि या अंतिम फ़्रेम से टकराने वाले फ़ील्ड हटाएं। |
doubao-seedance-2-5-260628
केवल टेक्स्ट विवरण होने पर यह ऑपरेशन इस्तेमाल करें।
model को इस उपखंड के Model ID और operation को text_to_video पर सेट करें। केवल नीचे दिए गए जनरेशन फ़ील्ड इस्तेमाल करें। मीडिया को media ऐरे में रखें।
| फ़ील्ड | प्रकार | ज़रूरी | अनुमत मान या सीमा | डिफ़ॉल्ट |
|---|---|---|---|---|
audio.mode | string | नहीं | on, off | on |
duration.mode | string | नहीं | fixed, auto | auto |
duration.seconds | integer | नहीं | 4–30, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए | कोई नहीं |
output.aspect_ratio | string | नहीं | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | नहीं | mp4 | mp4 |
output.resolution | string | नहीं | 480p, 720p, 1080p | 720p |
prompt | string | हां | स्ट्रिंग | कोई नहीं |
watermark | boolean | नहीं | false, true | false |
मीडिया की ज़रूरतें
यह ऑपरेशन मीडिया स्वीकार नहीं करता।
संयोजन की सीमाएं
duration.mode="fixed"के साथduration.secondsज़रूरी है।fixedस्पष्ट रूप से सेट करते समय सेकंड भी भरें।duration.mode="auto"इस्तेमाल करते समयduration.secondsन भेजें।
अनुरोध का उदाहरण
नीचे का JSON request.json में सेव करें। फिर साझा प्रक्रिया के अनुसार पहले अनुमान लें और पुष्टि के बाद टास्क बनाएं।
{ "model": "doubao-seedance-2-5-260628", "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 | अपने-आप तय अवधि या अंतिम फ़्रेम से टकराने वाले फ़ील्ड हटाएं। |
इमेज से वीडियो
ByteDance-Seedance-2.0-SR
इमेज से शुरुआती फ़्रेम या पहले और अंतिम फ़्रेम तय करने के लिए यह ऑपरेशन इस्तेमाल करें।
model को इस उपखंड के Model ID और operation को image_to_video पर सेट करें। केवल नीचे दिए गए जनरेशन फ़ील्ड इस्तेमाल करें। मीडिया को media ऐरे में रखें।
| फ़ील्ड | प्रकार | ज़रूरी | अनुमत मान या सीमा | डिफ़ॉल्ट |
|---|---|---|---|---|
audio.mode | string | नहीं | on, off | on |
duration.mode | string | नहीं | fixed | fixed |
duration.seconds | integer | नहीं | 5–10, अंतराल 5 सेकंड; केवल निश्चित अवधि के लिए | 5 |
output.aspect_ratio | string | नहीं | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | 16:9 |
output.format | string | नहीं | mp4 | mp4 |
output.resolution | string | नहीं | 720p, 1080p, 4k | 720p |
prompt | string | हां | स्ट्रिंग | कोई नहीं |
watermark | boolean | नहीं | false | false |
मीडिया की ज़रूरतें
| मीडिया भूमिका | प्रकार और संख्या | फ़ॉर्मैट | हर फ़ाइल की सीमाएं |
|---|---|---|---|
first_frame | image, 1 (ज़रूरी) | jpeg, png, webp | अधिकतम आकार 10 MB; चौड़ाई 128–4096 px; ऊंचाई 128–4096 px |
मीडिया ज़रूरी है या नहीं, यह नीचे की संयोजन सीमाओं पर भी निर्भर है।
संयोजन की सीमाएं
duration.mode="fixed"के साथduration.secondsज़रूरी है।fixedस्पष्ट रूप से सेट करते समय सेकंड भी भरें।first_frameदेना ज़रूरी है।
अनुरोध का उदाहरण
नीचे का JSON request.json में सेव करें। फिर साझा प्रक्रिया के अनुसार पहले अनुमान लें और पुष्टि के बाद टास्क बनाएं।
{ "model": "ByteDance-Seedance-2.0-SR", "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 | इस उपखंड की संयोजन सीमाओं के अनुसार सेकंड, अनुपात, ऑडियो सेटिंग या मीडिया जोड़ें। |
count / media_role | इस उपखंड की मीडिया तालिका के अनुसार भूमिका और संख्या सुधारें। |
video_input_unsupported | सार्वजनिक HTTPS पता, Content-Type और फ़ाइल फ़ॉर्मैट जांचें, फिर नया अनुमान लें। |
ByteDance-Seedance-2.5-SR
इमेज से शुरुआती फ़्रेम या पहले और अंतिम फ़्रेम तय करने के लिए यह ऑपरेशन इस्तेमाल करें।
model को इस उपखंड के Model ID और operation को image_to_video पर सेट करें। केवल नीचे दिए गए जनरेशन फ़ील्ड इस्तेमाल करें। मीडिया को media ऐरे में रखें।
| फ़ील्ड | प्रकार | ज़रूरी | अनुमत मान या सीमा | डिफ़ॉल्ट |
|---|---|---|---|---|
audio.mode | string | नहीं | on, off | on |
duration.mode | string | नहीं | fixed | fixed |
duration.seconds | integer | नहीं | 5–10, अंतराल 5 सेकंड; केवल निश्चित अवधि के लिए | 5 |
output.aspect_ratio | string | नहीं | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | 16:9 |
output.format | string | नहीं | mp4 | mp4 |
output.resolution | string | नहीं | 720p, 1080p | 720p |
prompt | string | हां | स्ट्रिंग | कोई नहीं |
watermark | boolean | नहीं | false | false |
मीडिया की ज़रूरतें
| मीडिया भूमिका | प्रकार और संख्या | फ़ॉर्मैट | हर फ़ाइल की सीमाएं |
|---|---|---|---|
first_frame | image, 1 (ज़रूरी) | jpeg, png, webp | अधिकतम आकार 10 MB; चौड़ाई 128–4096 px; ऊंचाई 128–4096 px |
मीडिया ज़रूरी है या नहीं, यह नीचे की संयोजन सीमाओं पर भी निर्भर है।
संयोजन की सीमाएं
duration.mode="fixed"के साथduration.secondsज़रूरी है।fixedस्पष्ट रूप से सेट करते समय सेकंड भी भरें।first_frameदेना ज़रूरी है।
अनुरोध का उदाहरण
नीचे का JSON request.json में सेव करें। फिर साझा प्रक्रिया के अनुसार पहले अनुमान लें और पुष्टि के बाद टास्क बनाएं।
{ "model": "ByteDance-Seedance-2.5-SR", "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 | इस उपखंड की संयोजन सीमाओं के अनुसार सेकंड, अनुपात, ऑडियो सेटिंग या मीडिया जोड़ें। |
count / media_role | इस उपखंड की मीडिया तालिका के अनुसार भूमिका और संख्या सुधारें। |
video_input_unsupported | सार्वजनिक HTTPS पता, Content-Type और फ़ाइल फ़ॉर्मैट जांचें, फिर नया अनुमान लें। |
doubao-seedance-2-0-260128
इमेज से शुरुआती फ़्रेम या पहले और अंतिम फ़्रेम तय करने के लिए यह ऑपरेशन इस्तेमाल करें।
model को इस उपखंड के Model ID और operation को image_to_video पर सेट करें। केवल नीचे दिए गए जनरेशन फ़ील्ड इस्तेमाल करें। मीडिया को media ऐरे में रखें।
| फ़ील्ड | प्रकार | ज़रूरी | अनुमत मान या सीमा | डिफ़ॉल्ट |
|---|---|---|---|---|
audio.mode | string | नहीं | on, off | on |
duration.mode | string | नहीं | fixed, auto | fixed |
duration.seconds | integer | नहीं | 4–15, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए | कोई नहीं |
output.aspect_ratio | string | नहीं | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | नहीं | mp4 | mp4 |
output.resolution | string | नहीं | 480p, 720p, 1080p, 4k | 720p |
prompt | string | हां | स्ट्रिंग | कोई नहीं |
watermark | boolean | नहीं | false, true | false |
मीडिया की ज़रूरतें
| मीडिया भूमिका | प्रकार और संख्या | फ़ॉर्मैट | हर फ़ाइल की सीमाएं |
|---|---|---|---|
first_frame | image, 1 (ज़रूरी) | jpeg, png, webp, bmp, tiff, gif, heic, heif | आकार 1–31457279 बाइट; चौड़ाई 300–6000 px; ऊंचाई 300–6000 px |
last_frame | image, वैकल्पिक, अधिकतम 1 | jpeg, png, webp, bmp, tiff, gif, heic, heif | आकार 1–31457279 बाइट; चौड़ाई 300–6000 px; ऊंचाई 300–6000 px |
मीडिया ज़रूरी है या नहीं, यह नीचे की संयोजन सीमाओं पर भी निर्भर है।
संयोजन की सीमाएं
duration.mode="fixed"के साथduration.secondsज़रूरी है।fixedस्पष्ट रूप से सेट करते समय सेकंड भी भरें।duration.mode="auto"इस्तेमाल करते समयduration.secondsन भेजें।first_frameदेना ज़रूरी है।
अनुरोध का उदाहरण
नीचे का JSON request.json में सेव करें। फिर साझा प्रक्रिया के अनुसार पहले अनुमान लें और पुष्टि के बाद टास्क बनाएं।
{ "model": "doubao-seedance-2-0-260128", "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 और फ़ाइल फ़ॉर्मैट जांचें, फिर नया अनुमान लें। |
doubao-seedance-2-0-fast-260128
इमेज से शुरुआती फ़्रेम या पहले और अंतिम फ़्रेम तय करने के लिए यह ऑपरेशन इस्तेमाल करें।
model को इस उपखंड के Model ID और operation को image_to_video पर सेट करें। केवल नीचे दिए गए जनरेशन फ़ील्ड इस्तेमाल करें। मीडिया को media ऐरे में रखें।
| फ़ील्ड | प्रकार | ज़रूरी | अनुमत मान या सीमा | डिफ़ॉल्ट |
|---|---|---|---|---|
audio.mode | string | नहीं | on, off | on |
duration.mode | string | नहीं | fixed, auto | fixed |
duration.seconds | integer | नहीं | 4–15, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए | कोई नहीं |
output.aspect_ratio | string | नहीं | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | नहीं | mp4 | mp4 |
output.resolution | string | नहीं | 480p, 720p | 720p |
prompt | string | हां | स्ट्रिंग | कोई नहीं |
watermark | boolean | नहीं | false, true | false |
मीडिया की ज़रूरतें
| मीडिया भूमिका | प्रकार और संख्या | फ़ॉर्मैट | हर फ़ाइल की सीमाएं |
|---|---|---|---|
first_frame | image, 1 (ज़रूरी) | jpeg, png, webp, bmp, tiff, gif, heic, heif | आकार 1–31457279 बाइट; चौड़ाई 300–6000 px; ऊंचाई 300–6000 px |
last_frame | image, वैकल्पिक, अधिकतम 1 | jpeg, png, webp, bmp, tiff, gif, heic, heif | आकार 1–31457279 बाइट; चौड़ाई 300–6000 px; ऊंचाई 300–6000 px |
मीडिया ज़रूरी है या नहीं, यह नीचे की संयोजन सीमाओं पर भी निर्भर है।
संयोजन की सीमाएं
duration.mode="fixed"के साथduration.secondsज़रूरी है।fixedस्पष्ट रूप से सेट करते समय सेकंड भी भरें।duration.mode="auto"इस्तेमाल करते समयduration.secondsन भेजें।first_frameदेना ज़रूरी है।
अनुरोध का उदाहरण
नीचे का JSON request.json में सेव करें। फिर साझा प्रक्रिया के अनुसार पहले अनुमान लें और पुष्टि के बाद टास्क बनाएं।
{ "model": "doubao-seedance-2-0-fast-260128", "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 और फ़ाइल फ़ॉर्मैट जांचें, फिर नया अनुमान लें। |
doubao-seedance-2-0-mini-260615
इमेज से शुरुआती फ़्रेम या पहले और अंतिम फ़्रेम तय करने के लिए यह ऑपरेशन इस्तेमाल करें।
model को इस उपखंड के Model ID और operation को image_to_video पर सेट करें। केवल नीचे दिए गए जनरेशन फ़ील्ड इस्तेमाल करें। मीडिया को media ऐरे में रखें।
| फ़ील्ड | प्रकार | ज़रूरी | अनुमत मान या सीमा | डिफ़ॉल्ट |
|---|---|---|---|---|
audio.mode | string | नहीं | on, off | on |
duration.mode | string | नहीं | fixed, auto | fixed |
duration.seconds | integer | नहीं | 4–15, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए | कोई नहीं |
output.aspect_ratio | string | नहीं | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | नहीं | mp4 | mp4 |
output.resolution | string | नहीं | 480p, 720p | 720p |
prompt | string | हां | स्ट्रिंग | कोई नहीं |
watermark | boolean | नहीं | false, true | false |
मीडिया की ज़रूरतें
| मीडिया भूमिका | प्रकार और संख्या | फ़ॉर्मैट | हर फ़ाइल की सीमाएं |
|---|---|---|---|
first_frame | image, 1 (ज़रूरी) | jpeg, png, webp, bmp, tiff, gif, heic, heif | आकार 1–31457279 बाइट; चौड़ाई 300–6000 px; ऊंचाई 300–6000 px |
last_frame | image, वैकल्पिक, अधिकतम 1 | jpeg, png, webp, bmp, tiff, gif, heic, heif | आकार 1–31457279 बाइट; चौड़ाई 300–6000 px; ऊंचाई 300–6000 px |
मीडिया ज़रूरी है या नहीं, यह नीचे की संयोजन सीमाओं पर भी निर्भर है।
संयोजन की सीमाएं
duration.mode="fixed"के साथduration.secondsज़रूरी है।fixedस्पष्ट रूप से सेट करते समय सेकंड भी भरें।duration.mode="auto"इस्तेमाल करते समयduration.secondsन भेजें।first_frameदेना ज़रूरी है।
अनुरोध का उदाहरण
नीचे का JSON request.json में सेव करें। फिर साझा प्रक्रिया के अनुसार पहले अनुमान लें और पुष्टि के बाद टास्क बनाएं।
{ "model": "doubao-seedance-2-0-mini-260615", "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 और फ़ाइल फ़ॉर्मैट जांचें, फिर नया अनुमान लें। |
doubao-seedance-2-5-260628
इमेज से शुरुआती फ़्रेम या पहले और अंतिम फ़्रेम तय करने के लिए यह ऑपरेशन इस्तेमाल करें।
model को इस उपखंड के Model ID और operation को image_to_video पर सेट करें। केवल नीचे दिए गए जनरेशन फ़ील्ड इस्तेमाल करें। मीडिया को media ऐरे में रखें।
| फ़ील्ड | प्रकार | ज़रूरी | अनुमत मान या सीमा | डिफ़ॉल्ट |
|---|---|---|---|---|
audio.mode | string | नहीं | on, off | on |
duration.mode | string | नहीं | fixed, auto | auto |
duration.seconds | integer | नहीं | 4–30, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए | कोई नहीं |
output.aspect_ratio | string | नहीं | adaptive | adaptive |
output.format | string | नहीं | mp4 | mp4 |
output.resolution | string | नहीं | 480p, 720p, 1080p | 720p |
prompt | string | हां | स्ट्रिंग | कोई नहीं |
watermark | boolean | नहीं | false, true | false |
मीडिया की ज़रूरतें
| मीडिया भूमिका | प्रकार और संख्या | फ़ॉर्मैट | हर फ़ाइल की सीमाएं |
|---|---|---|---|
first_frame | image, 1 (ज़रूरी) | jpeg, png, webp, bmp, tiff, gif, heic, heif | आकार 1–31457279 बाइट; चौड़ाई 300–6000 px; ऊंचाई 300–6000 px |
last_frame | image, वैकल्पिक, अधिकतम 1 | jpeg, png, webp, bmp, tiff, gif, heic, heif | आकार 1–31457279 बाइट; चौड़ाई 300–6000 px; ऊंचाई 300–6000 px |
मीडिया ज़रूरी है या नहीं, यह नीचे की संयोजन सीमाओं पर भी निर्भर है।
संयोजन की सीमाएं
duration.mode="fixed"के साथduration.secondsज़रूरी है।fixedस्पष्ट रूप से सेट करते समय सेकंड भी भरें।duration.mode="auto"इस्तेमाल करते समयduration.secondsन भेजें।first_frameदेना ज़रूरी है।- इस ऑपरेशन में
output.aspect_ratio="adaptive"ज़रूरी है, चाहे केवल पहला फ़्रेम दें या पहला और अंतिम दोनों फ़्रेम दें।
अनुरोध का उदाहरण
नीचे का JSON request.json में सेव करें। फिर साझा प्रक्रिया के अनुसार पहले अनुमान लें और पुष्टि के बाद टास्क बनाएं।
{ "model": "doubao-seedance-2-5-260628", "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 और फ़ाइल फ़ॉर्मैट जांचें, फिर नया अनुमान लें। |
रेफ़रेंस जनरेशन
doubao-seedance-2-0-260128
रेफ़रेंस मीडिया से विषय या गति की विशेषताएं बनाए रखने के लिए यह ऑपरेशन इस्तेमाल करें।
model को इस उपखंड के Model ID और operation को reference_to_video पर सेट करें। केवल नीचे दिए गए जनरेशन फ़ील्ड इस्तेमाल करें। मीडिया को media ऐरे में रखें।
| फ़ील्ड | प्रकार | ज़रूरी | अनुमत मान या सीमा | डिफ़ॉल्ट |
|---|---|---|---|---|
audio.mode | string | नहीं | on, off | on |
duration.mode | string | नहीं | fixed, auto | fixed |
duration.seconds | integer | नहीं | 4–15, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए | कोई नहीं |
output.aspect_ratio | string | नहीं | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | नहीं | mp4 | mp4 |
output.resolution | string | नहीं | 480p, 720p, 1080p, 4k | 720p |
prompt | string | हां | स्ट्रिंग | कोई नहीं |
watermark | boolean | नहीं | false, true | false |
मीडिया की ज़रूरतें
| मीडिया भूमिका | प्रकार और संख्या | फ़ॉर्मैट | हर फ़ाइल की सीमाएं |
|---|---|---|---|
reference_image | image, वैकल्पिक, अधिकतम 9 | jpeg, png, webp, bmp, tiff, gif, heic, heif | आकार 1–31457279 बाइट; चौड़ाई 300–6000 px; ऊंचाई 300–6000 px |
reference_video | video, वैकल्पिक, अधिकतम 3 | mp4, mov | अधिकतम आकार 200 MB; चौड़ाई 300–6000 px; ऊंचाई 300–6000 px; अवधि 2–15 सेकंड; न्यूनतम फ़्रेम रेट 24 fps, और अधिकतम 60 fps; इस भूमिका का कुल अधिकतम 15 सेकंड |
reference_audio | audio, वैकल्पिक, अधिकतम 3 | wav, mp3 | अधिकतम आकार 15 MB; अवधि 2–15 सेकंड; इस भूमिका का कुल अधिकतम 15 सेकंड |
मीडिया ज़रूरी है या नहीं, यह नीचे की संयोजन सीमाओं पर भी निर्भर है।
संयोजन की सीमाएं
duration.mode="fixed"के साथduration.secondsज़रूरी है।fixedस्पष्ट रूप से सेट करते समय सेकंड भी भरें।duration.mode="auto"इस्तेमाल करते समयduration.secondsन भेजें।- इनमें से कम से कम एक भूमिका दें:
reference_image,reference_video,reference_audio। - रेफ़रेंस ऑडियो अकेले इस्तेमाल नहीं कर सकते। साथ में रेफ़रेंस इमेज या रेफ़रेंस वीडियो भी दें।
अनुरोध का उदाहरण
नीचे का JSON request.json में सेव करें। फिर साझा प्रक्रिया के अनुसार पहले अनुमान लें और पुष्टि के बाद टास्क बनाएं।
{ "model": "doubao-seedance-2-0-260128", "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 | अपने-आप तय अवधि या अंतिम फ़्रेम से टकराने वाले फ़ील्ड हटाएं। |
count / media_role | इस उपखंड की मीडिया तालिका के अनुसार भूमिका और संख्या सुधारें। |
video_input_unsupported | सार्वजनिक HTTPS पता, Content-Type और फ़ाइल फ़ॉर्मैट जांचें, फिर नया अनुमान लें। |
doubao-seedance-2-0-fast-260128
रेफ़रेंस मीडिया से विषय या गति की विशेषताएं बनाए रखने के लिए यह ऑपरेशन इस्तेमाल करें।
model को इस उपखंड के Model ID और operation को reference_to_video पर सेट करें। केवल नीचे दिए गए जनरेशन फ़ील्ड इस्तेमाल करें। मीडिया को media ऐरे में रखें।
| फ़ील्ड | प्रकार | ज़रूरी | अनुमत मान या सीमा | डिफ़ॉल्ट |
|---|---|---|---|---|
audio.mode | string | नहीं | on, off | on |
duration.mode | string | नहीं | fixed, auto | fixed |
duration.seconds | integer | नहीं | 4–15, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए | कोई नहीं |
output.aspect_ratio | string | नहीं | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | नहीं | mp4 | mp4 |
output.resolution | string | नहीं | 480p, 720p | 720p |
prompt | string | हां | स्ट्रिंग | कोई नहीं |
watermark | boolean | नहीं | false, true | false |
मीडिया की ज़रूरतें
| मीडिया भूमिका | प्रकार और संख्या | फ़ॉर्मैट | हर फ़ाइल की सीमाएं |
|---|---|---|---|
reference_image | image, वैकल्पिक, अधिकतम 9 | jpeg, png, webp, bmp, tiff, gif, heic, heif | आकार 1–31457279 बाइट; चौड़ाई 300–6000 px; ऊंचाई 300–6000 px |
reference_video | video, वैकल्पिक, अधिकतम 3 | mp4, mov | अधिकतम आकार 200 MB; चौड़ाई 300–6000 px; ऊंचाई 300–6000 px; अवधि 2–15 सेकंड; न्यूनतम फ़्रेम रेट 24 fps, और अधिकतम 60 fps; इस भूमिका का कुल अधिकतम 15 सेकंड |
reference_audio | audio, वैकल्पिक, अधिकतम 3 | wav, mp3 | अधिकतम आकार 15 MB; अवधि 2–15 सेकंड; इस भूमिका का कुल अधिकतम 15 सेकंड |
मीडिया ज़रूरी है या नहीं, यह नीचे की संयोजन सीमाओं पर भी निर्भर है।
संयोजन की सीमाएं
duration.mode="fixed"के साथduration.secondsज़रूरी है।fixedस्पष्ट रूप से सेट करते समय सेकंड भी भरें।duration.mode="auto"इस्तेमाल करते समयduration.secondsन भेजें।- इनमें से कम से कम एक भूमिका दें:
reference_image,reference_video,reference_audio। - रेफ़रेंस ऑडियो अकेले इस्तेमाल नहीं कर सकते। साथ में रेफ़रेंस इमेज या रेफ़रेंस वीडियो भी दें।
अनुरोध का उदाहरण
नीचे का JSON request.json में सेव करें। फिर साझा प्रक्रिया के अनुसार पहले अनुमान लें और पुष्टि के बाद टास्क बनाएं।
{ "model": "doubao-seedance-2-0-fast-260128", "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 | अपने-आप तय अवधि या अंतिम फ़्रेम से टकराने वाले फ़ील्ड हटाएं। |
count / media_role | इस उपखंड की मीडिया तालिका के अनुसार भूमिका और संख्या सुधारें। |
video_input_unsupported | सार्वजनिक HTTPS पता, Content-Type और फ़ाइल फ़ॉर्मैट जांचें, फिर नया अनुमान लें। |
doubao-seedance-2-0-mini-260615
रेफ़रेंस मीडिया से विषय या गति की विशेषताएं बनाए रखने के लिए यह ऑपरेशन इस्तेमाल करें।
model को इस उपखंड के Model ID और operation को reference_to_video पर सेट करें। केवल नीचे दिए गए जनरेशन फ़ील्ड इस्तेमाल करें। मीडिया को media ऐरे में रखें।
| फ़ील्ड | प्रकार | ज़रूरी | अनुमत मान या सीमा | डिफ़ॉल्ट |
|---|---|---|---|---|
audio.mode | string | नहीं | on, off | on |
duration.mode | string | नहीं | fixed, auto | fixed |
duration.seconds | integer | नहीं | 4–15, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए | कोई नहीं |
output.aspect_ratio | string | नहीं | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | नहीं | mp4 | mp4 |
output.resolution | string | नहीं | 480p, 720p | 720p |
prompt | string | हां | स्ट्रिंग | कोई नहीं |
watermark | boolean | नहीं | false, true | false |
मीडिया की ज़रूरतें
| मीडिया भूमिका | प्रकार और संख्या | फ़ॉर्मैट | हर फ़ाइल की सीमाएं |
|---|---|---|---|
reference_image | image, वैकल्पिक, अधिकतम 9 | jpeg, png, webp, bmp, tiff, gif, heic, heif | आकार 1–31457279 बाइट; चौड़ाई 300–6000 px; ऊंचाई 300–6000 px |
reference_video | video, वैकल्पिक, अधिकतम 3 | mp4, mov | अधिकतम आकार 200 MB; चौड़ाई 300–6000 px; ऊंचाई 300–6000 px; अवधि 2–15 सेकंड; न्यूनतम फ़्रेम रेट 24 fps, और अधिकतम 60 fps; इस भूमिका का कुल अधिकतम 15 सेकंड |
reference_audio | audio, वैकल्पिक, अधिकतम 3 | wav, mp3 | अधिकतम आकार 15 MB; अवधि 2–15 सेकंड; इस भूमिका का कुल अधिकतम 15 सेकंड |
मीडिया ज़रूरी है या नहीं, यह नीचे की संयोजन सीमाओं पर भी निर्भर है।
संयोजन की सीमाएं
duration.mode="fixed"के साथduration.secondsज़रूरी है।fixedस्पष्ट रूप से सेट करते समय सेकंड भी भरें।duration.mode="auto"इस्तेमाल करते समयduration.secondsन भेजें।- इनमें से कम से कम एक भूमिका दें:
reference_image,reference_video,reference_audio। - रेफ़रेंस ऑडियो अकेले इस्तेमाल नहीं कर सकते। साथ में रेफ़रेंस इमेज या रेफ़रेंस वीडियो भी दें।
अनुरोध का उदाहरण
नीचे का JSON request.json में सेव करें। फिर साझा प्रक्रिया के अनुसार पहले अनुमान लें और पुष्टि के बाद टास्क बनाएं।
{ "model": "doubao-seedance-2-0-mini-260615", "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 | अपने-आप तय अवधि या अंतिम फ़्रेम से टकराने वाले फ़ील्ड हटाएं। |
count / media_role | इस उपखंड की मीडिया तालिका के अनुसार भूमिका और संख्या सुधारें। |
video_input_unsupported | सार्वजनिक HTTPS पता, Content-Type और फ़ाइल फ़ॉर्मैट जांचें, फिर नया अनुमान लें। |
doubao-seedance-2-5-260628
रेफ़रेंस मीडिया से विषय या गति की विशेषताएं बनाए रखने के लिए यह ऑपरेशन इस्तेमाल करें।
model को इस उपखंड के Model ID और operation को reference_to_video पर सेट करें। केवल नीचे दिए गए जनरेशन फ़ील्ड इस्तेमाल करें। मीडिया को media ऐरे में रखें।
| फ़ील्ड | प्रकार | ज़रूरी | अनुमत मान या सीमा | डिफ़ॉल्ट |
|---|---|---|---|---|
audio.mode | string | नहीं | on, off | on |
duration.mode | string | नहीं | fixed, auto | auto |
duration.seconds | integer | नहीं | 4–30, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए | कोई नहीं |
output.aspect_ratio | string | नहीं | 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive | adaptive |
output.format | string | नहीं | mp4 | mp4 |
output.resolution | string | नहीं | 480p, 720p, 1080p | 720p |
prompt | string | हां | स्ट्रिंग | कोई नहीं |
watermark | boolean | नहीं | false, true | false |
मीडिया की ज़रूरतें
| मीडिया भूमिका | प्रकार और संख्या | फ़ॉर्मैट | हर फ़ाइल की सीमाएं |
|---|---|---|---|
reference_image | image, वैकल्पिक, अधिकतम 30 | jpeg, png, webp, bmp, tiff, gif, heic, heif | आकार 1–31457279 बाइट; चौड़ाई 300–6000 px; ऊंचाई 300–6000 px |
reference_video | video, वैकल्पिक, अधिकतम 10 | mp4, mov | अधिकतम आकार 200 MB; चौड़ाई 300–6000 px; ऊंचाई 300–6000 px; अवधि 2–30 सेकंड; न्यूनतम फ़्रेम रेट 24 fps, और अधिकतम 60 fps; इस भूमिका का कुल अधिकतम 30 सेकंड |
reference_audio | audio, वैकल्पिक, अधिकतम 10 | wav, mp3 | अधिकतम आकार 15 MB; अवधि 2–30 सेकंड; इस भूमिका का कुल अधिकतम 30 सेकंड |
मीडिया ज़रूरी है या नहीं, यह नीचे की संयोजन सीमाओं पर भी निर्भर है।
संयोजन की सीमाएं
duration.mode="fixed"के साथduration.secondsज़रूरी है।fixedस्पष्ट रूप से सेट करते समय सेकंड भी भरें।duration.mode="auto"इस्तेमाल करते समयduration.secondsन भेजें।- इनमें से कम से कम एक भूमिका दें:
reference_image,reference_video,reference_audio।
अनुरोध का उदाहरण
नीचे का JSON request.json में सेव करें। फिर साझा प्रक्रिया के अनुसार पहले अनुमान लें और पुष्टि के बाद टास्क बनाएं।
{ "model": "doubao-seedance-2-5-260628", "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 | अपने-आप तय अवधि या अंतिम फ़्रेम से टकराने वाले फ़ील्ड हटाएं। |
count / media_role | इस उपखंड की मीडिया तालिका के अनुसार भूमिका और संख्या सुधारें। |
video_input_unsupported | सार्वजनिक HTTPS पता, Content-Type और फ़ाइल फ़ॉर्मैट जांचें, फिर नया अनुमान लें। |
आधिकारिक संसाधन
BetterToken कॉल करते समय इस पेज के फ़ील्ड और वर्तमान मॉडल सूची का संबंधित ऑपरेशन इस्तेमाल करें।

