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

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-SRimage_to_video5–10, अंतराल 5720p, 1080p, 4k16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offfirst_frame
ByteDance-Seedance-2.0-SRtext_to_video5–10, अंतराल 5720p, 1080p, 4k16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offकोई नहीं
ByteDance-Seedance-2.5-SRimage_to_video5–10, अंतराल 5720p, 1080p16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offfirst_frame
ByteDance-Seedance-2.5-SRtext_to_video5–10, अंतराल 5720p, 1080p16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offकोई नहीं
doubao-seedance-2-0-260128image_to_video4–15, अंतराल 1; उपलब्ध auto480p, 720p, 1080p, 4k16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offfirst_frame, last_frame
doubao-seedance-2-0-260128reference_to_video4–15, अंतराल 1; उपलब्ध auto480p, 720p, 1080p, 4k16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offreference_image, reference_video, reference_audio
doubao-seedance-2-0-260128text_to_video4–15, अंतराल 1; उपलब्ध auto480p, 720p, 1080p, 4k16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offकोई नहीं
doubao-seedance-2-0-fast-260128image_to_video4–15, अंतराल 1; उपलब्ध auto480p, 720p16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offfirst_frame, last_frame
doubao-seedance-2-0-fast-260128reference_to_video4–15, अंतराल 1; उपलब्ध auto480p, 720p16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offreference_image, reference_video, reference_audio
doubao-seedance-2-0-fast-260128text_to_video4–15, अंतराल 1; उपलब्ध auto480p, 720p16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offकोई नहीं
doubao-seedance-2-0-mini-260615image_to_video4–15, अंतराल 1; उपलब्ध auto480p, 720p16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offfirst_frame, last_frame
doubao-seedance-2-0-mini-260615reference_to_video4–15, अंतराल 1; उपलब्ध auto480p, 720p16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offreference_image, reference_video, reference_audio
doubao-seedance-2-0-mini-260615text_to_video4–15, अंतराल 1; उपलब्ध auto480p, 720p16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offकोई नहीं
doubao-seedance-2-5-260628image_to_video4–30, अंतराल 1; उपलब्ध auto480p, 720p, 1080padaptiveon, offfirst_frame, last_frame
doubao-seedance-2-5-260628reference_to_video4–30, अंतराल 1; उपलब्ध auto480p, 720p, 1080p16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offreference_image, reference_video, reference_audio
doubao-seedance-2-5-260628text_to_video4–30, अंतराल 1; उपलब्ध auto480p, 720p, 1080p16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveon, offकोई नहीं

दोनों SR मॉडल की निश्चित अवधि केवल 5 या 10 सेकंड हो सकती है। चीन क्षेत्र और SR मॉडल के Model ID अलग हैं। एक मॉडल की फ़ील्ड या मीडिया सीमाएं दूसरे पर लागू न करें।

नमूना मीडिया

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

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

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

ByteDance-Seedance-2.0-SR

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

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

फ़ील्डप्रकारज़रूरीअनुमत मान या सीमाडिफ़ॉल्ट
audio.modestringनहींon, offon
duration.modestringनहींfixedfixed
duration.secondsintegerनहीं5–10, अंतराल 5 सेकंड; केवल निश्चित अवधि के लिए5
output.aspect_ratiostringनहीं16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive16:9
output.formatstringनहींmp4mp4
output.resolutionstringनहीं720p, 1080p, 4k720p
promptstringहांस्ट्रिंगकोई नहीं
watermarkbooleanनहींfalsefalse

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

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

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

  • 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.modestringनहींon, offon
duration.modestringनहींfixedfixed
duration.secondsintegerनहीं5–10, अंतराल 5 सेकंड; केवल निश्चित अवधि के लिए5
output.aspect_ratiostringनहीं16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive16:9
output.formatstringनहींmp4mp4
output.resolutionstringनहीं720p, 1080p720p
promptstringहांस्ट्रिंगकोई नहीं
watermarkbooleanनहींfalsefalse

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

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

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

  • 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.modestringनहींon, offon
duration.modestringनहींfixed, autofixed
duration.secondsintegerनहीं4–15, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिएकोई नहीं
output.aspect_ratiostringनहीं16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringनहींmp4mp4
output.resolutionstringनहीं480p, 720p, 1080p, 4k720p
promptstringहांस्ट्रिंगकोई नहीं
watermarkbooleanनहींfalse, truefalse

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

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

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

  • 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.modestringनहींon, offon
duration.modestringनहींfixed, autofixed
duration.secondsintegerनहीं4–15, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिएकोई नहीं
output.aspect_ratiostringनहीं16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringनहींmp4mp4
output.resolutionstringनहीं480p, 720p720p
promptstringहांस्ट्रिंगकोई नहीं
watermarkbooleanनहींfalse, truefalse

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

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

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

  • 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.modestringनहींon, offon
duration.modestringनहींfixed, autofixed
duration.secondsintegerनहीं4–15, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिएकोई नहीं
output.aspect_ratiostringनहीं16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringनहींmp4mp4
output.resolutionstringनहीं480p, 720p720p
promptstringहांस्ट्रिंगकोई नहीं
watermarkbooleanनहींfalse, truefalse

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

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

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

  • 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.modestringनहींon, offon
duration.modestringनहींfixed, autoauto
duration.secondsintegerनहीं4–30, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिएकोई नहीं
output.aspect_ratiostringनहीं16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringनहींmp4mp4
output.resolutionstringनहीं480p, 720p, 1080p720p
promptstringहांस्ट्रिंगकोई नहीं
watermarkbooleanनहींfalse, truefalse

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

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

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

  • 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.modestringनहींon, offon
duration.modestringनहींfixedfixed
duration.secondsintegerनहीं5–10, अंतराल 5 सेकंड; केवल निश्चित अवधि के लिए5
output.aspect_ratiostringनहीं16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive16:9
output.formatstringनहींmp4mp4
output.resolutionstringनहीं720p, 1080p, 4k720p
promptstringहांस्ट्रिंगकोई नहीं
watermarkbooleanनहींfalsefalse

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

मीडिया भूमिकाप्रकार और संख्याफ़ॉर्मैटहर फ़ाइल की सीमाएं
first_frameimage, 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.modestringनहींon, offon
duration.modestringनहींfixedfixed
duration.secondsintegerनहीं5–10, अंतराल 5 सेकंड; केवल निश्चित अवधि के लिए5
output.aspect_ratiostringनहीं16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive16:9
output.formatstringनहींmp4mp4
output.resolutionstringनहीं720p, 1080p720p
promptstringहांस्ट्रिंगकोई नहीं
watermarkbooleanनहींfalsefalse

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

मीडिया भूमिकाप्रकार और संख्याफ़ॉर्मैटहर फ़ाइल की सीमाएं
first_frameimage, 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.modestringनहींon, offon
duration.modestringनहींfixed, autofixed
duration.secondsintegerनहीं4–15, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिएकोई नहीं
output.aspect_ratiostringनहीं16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringनहींmp4mp4
output.resolutionstringनहीं480p, 720p, 1080p, 4k720p
promptstringहांस्ट्रिंगकोई नहीं
watermarkbooleanनहींfalse, truefalse

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

मीडिया भूमिकाप्रकार और संख्याफ़ॉर्मैटहर फ़ाइल की सीमाएं
first_frameimage, 1 (ज़रूरी)jpeg, png, webp, bmp, tiff, gif, heic, heifआकार 1–31457279 बाइट; चौड़ाई 300–6000 px; ऊंचाई 300–6000 px
last_frameimage, वैकल्पिक, अधिकतम 1jpeg, 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.modestringनहींon, offon
duration.modestringनहींfixed, autofixed
duration.secondsintegerनहीं4–15, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिएकोई नहीं
output.aspect_ratiostringनहीं16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringनहींmp4mp4
output.resolutionstringनहीं480p, 720p720p
promptstringहांस्ट्रिंगकोई नहीं
watermarkbooleanनहींfalse, truefalse

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

मीडिया भूमिकाप्रकार और संख्याफ़ॉर्मैटहर फ़ाइल की सीमाएं
first_frameimage, 1 (ज़रूरी)jpeg, png, webp, bmp, tiff, gif, heic, heifआकार 1–31457279 बाइट; चौड़ाई 300–6000 px; ऊंचाई 300–6000 px
last_frameimage, वैकल्पिक, अधिकतम 1jpeg, 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.modestringनहींon, offon
duration.modestringनहींfixed, autofixed
duration.secondsintegerनहीं4–15, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिएकोई नहीं
output.aspect_ratiostringनहीं16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringनहींmp4mp4
output.resolutionstringनहीं480p, 720p720p
promptstringहांस्ट्रिंगकोई नहीं
watermarkbooleanनहींfalse, truefalse

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

मीडिया भूमिकाप्रकार और संख्याफ़ॉर्मैटहर फ़ाइल की सीमाएं
first_frameimage, 1 (ज़रूरी)jpeg, png, webp, bmp, tiff, gif, heic, heifआकार 1–31457279 बाइट; चौड़ाई 300–6000 px; ऊंचाई 300–6000 px
last_frameimage, वैकल्पिक, अधिकतम 1jpeg, 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.modestringनहींon, offon
duration.modestringनहींfixed, autoauto
duration.secondsintegerनहीं4–30, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिएकोई नहीं
output.aspect_ratiostringनहींadaptiveadaptive
output.formatstringनहींmp4mp4
output.resolutionstringनहीं480p, 720p, 1080p720p
promptstringहांस्ट्रिंगकोई नहीं
watermarkbooleanनहींfalse, truefalse

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

मीडिया भूमिकाप्रकार और संख्याफ़ॉर्मैटहर फ़ाइल की सीमाएं
first_frameimage, 1 (ज़रूरी)jpeg, png, webp, bmp, tiff, gif, heic, heifआकार 1–31457279 बाइट; चौड़ाई 300–6000 px; ऊंचाई 300–6000 px
last_frameimage, वैकल्पिक, अधिकतम 1jpeg, 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.modestringनहींon, offon
duration.modestringनहींfixed, autofixed
duration.secondsintegerनहीं4–15, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिएकोई नहीं
output.aspect_ratiostringनहीं16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringनहींmp4mp4
output.resolutionstringनहीं480p, 720p, 1080p, 4k720p
promptstringहांस्ट्रिंगकोई नहीं
watermarkbooleanनहींfalse, truefalse

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

मीडिया भूमिकाप्रकार और संख्याफ़ॉर्मैटहर फ़ाइल की सीमाएं
reference_imageimage, वैकल्पिक, अधिकतम 9jpeg, png, webp, bmp, tiff, gif, heic, heifआकार 1–31457279 बाइट; चौड़ाई 300–6000 px; ऊंचाई 300–6000 px
reference_videovideo, वैकल्पिक, अधिकतम 3mp4, movअधिकतम आकार 200 MB; चौड़ाई 300–6000 px; ऊंचाई 300–6000 px; अवधि 2–15 सेकंड; न्यूनतम फ़्रेम रेट 24 fps, और अधिकतम 60 fps; इस भूमिका का कुल अधिकतम 15 सेकंड
reference_audioaudio, वैकल्पिक, अधिकतम 3wav, 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.modestringनहींon, offon
duration.modestringनहींfixed, autofixed
duration.secondsintegerनहीं4–15, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिएकोई नहीं
output.aspect_ratiostringनहीं16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringनहींmp4mp4
output.resolutionstringनहीं480p, 720p720p
promptstringहांस्ट्रिंगकोई नहीं
watermarkbooleanनहींfalse, truefalse

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

मीडिया भूमिकाप्रकार और संख्याफ़ॉर्मैटहर फ़ाइल की सीमाएं
reference_imageimage, वैकल्पिक, अधिकतम 9jpeg, png, webp, bmp, tiff, gif, heic, heifआकार 1–31457279 बाइट; चौड़ाई 300–6000 px; ऊंचाई 300–6000 px
reference_videovideo, वैकल्पिक, अधिकतम 3mp4, movअधिकतम आकार 200 MB; चौड़ाई 300–6000 px; ऊंचाई 300–6000 px; अवधि 2–15 सेकंड; न्यूनतम फ़्रेम रेट 24 fps, और अधिकतम 60 fps; इस भूमिका का कुल अधिकतम 15 सेकंड
reference_audioaudio, वैकल्पिक, अधिकतम 3wav, 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.modestringनहींon, offon
duration.modestringनहींfixed, autofixed
duration.secondsintegerनहीं4–15, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिएकोई नहीं
output.aspect_ratiostringनहीं16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringनहींmp4mp4
output.resolutionstringनहीं480p, 720p720p
promptstringहांस्ट्रिंगकोई नहीं
watermarkbooleanनहींfalse, truefalse

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

मीडिया भूमिकाप्रकार और संख्याफ़ॉर्मैटहर फ़ाइल की सीमाएं
reference_imageimage, वैकल्पिक, अधिकतम 9jpeg, png, webp, bmp, tiff, gif, heic, heifआकार 1–31457279 बाइट; चौड़ाई 300–6000 px; ऊंचाई 300–6000 px
reference_videovideo, वैकल्पिक, अधिकतम 3mp4, movअधिकतम आकार 200 MB; चौड़ाई 300–6000 px; ऊंचाई 300–6000 px; अवधि 2–15 सेकंड; न्यूनतम फ़्रेम रेट 24 fps, और अधिकतम 60 fps; इस भूमिका का कुल अधिकतम 15 सेकंड
reference_audioaudio, वैकल्पिक, अधिकतम 3wav, 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.modestringनहींon, offon
duration.modestringनहींfixed, autoauto
duration.secondsintegerनहीं4–30, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिएकोई नहीं
output.aspect_ratiostringनहीं16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptiveadaptive
output.formatstringनहींmp4mp4
output.resolutionstringनहीं480p, 720p, 1080p720p
promptstringहांस्ट्रिंगकोई नहीं
watermarkbooleanनहींfalse, truefalse

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

मीडिया भूमिकाप्रकार और संख्याफ़ॉर्मैटहर फ़ाइल की सीमाएं
reference_imageimage, वैकल्पिक, अधिकतम 30jpeg, png, webp, bmp, tiff, gif, heic, heifआकार 1–31457279 बाइट; चौड़ाई 300–6000 px; ऊंचाई 300–6000 px
reference_videovideo, वैकल्पिक, अधिकतम 10mp4, movअधिकतम आकार 200 MB; चौड़ाई 300–6000 px; ऊंचाई 300–6000 px; अवधि 2–30 सेकंड; न्यूनतम फ़्रेम रेट 24 fps, और अधिकतम 60 fps; इस भूमिका का कुल अधिकतम 30 सेकंड
reference_audioaudio, वैकल्पिक, अधिकतम 10wav, 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 कॉल करते समय इस पेज के फ़ील्ड और वर्तमान मॉडल सूची का संबंधित ऑपरेशन इस्तेमाल करें।