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

MiniMax H3 वीडियो API: जनरेशन और रीजनरेशन

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

टेक्स्ट, पहले और अंतिम फ़्रेम या रेफ़रेंस मीडिया से वीडियो बनाएं। शर्तें पूरी करने वाले अपने 768p H3 वीडियो को 2k में दोबारा भी बना सकते हैं। रीजनरेशन केवल सोर्स टास्क ID स्वीकार करता है, नए मीडिया URL नहीं।

अपनी 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ऑपरेशनअवधि (सेकंड)आउटपुट स्तरअनुपातऑडियोमीडिया भूमिकाएं
MiniMax-H3image_to_video4–15, अंतराल 1768p, 2kadaptiveprovider_defaultfirst_frame, last_frame, reference_image, reference_video, reference_audio
MiniMax-H3reference_to_video4–15, अंतराल 1768p, 2kadaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16provider_defaultreference_image, reference_video, reference_audio
MiniMax-H3text_to_video4–15, अंतराल 1768p, 2k21:9, 16:9, 4:3, 1:1, 3:4, 9:16provider_defaultकोई नहीं
MiniMax-H3video_editसोर्स टास्क से ली जाती है2kadaptive (सोर्स से)provider_defaultसोर्स टास्क ID

provider_default मॉडल की ऑडियो सेटिंग रखता है और on / off स्विच नहीं देता। रीजनरेशन में अनुपात, अवधि और इनपुट सोर्स टास्क से लिए जाते हैं।

नमूना मीडिया

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

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

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

MiniMax-H3

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

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

फ़ील्डप्रकारज़रूरीअनुमत मान या सीमाडिफ़ॉल्ट
audio.modestringनहींprovider_defaultprovider_default
duration.modestringनहींfixedfixed
duration.secondsintegerनहीं4–15, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए4
output.aspect_ratiostringहां21:9, 16:9, 4:3, 1:1, 3:4, 9:16कोई नहीं
output.formatstringनहींmp4mp4
output.resolutionstringनहीं768p, 2k768p
promptstringहांस्ट्रिंगकोई नहीं
watermarkbooleanनहींfalse, truefalse

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

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

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

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

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

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

{
"model": "MiniMax-H3",
"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": "768p",
"aspect_ratio": "16:9"
}
}

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

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

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

MiniMax-H3

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

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

फ़ील्डप्रकारज़रूरीअनुमत मान या सीमाडिफ़ॉल्ट
audio.modestringनहींprovider_defaultprovider_default
duration.modestringनहींfixedfixed
duration.secondsintegerनहीं4–15, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए4
output.aspect_ratiostringनहींadaptiveadaptive
output.formatstringनहींmp4mp4
output.resolutionstringनहीं768p, 2k768p
promptstringहांस्ट्रिंगकोई नहीं
watermarkbooleanनहींfalse, truefalse

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

मीडिया भूमिकाप्रकार और संख्याफ़ॉर्मैटहर फ़ाइल की सीमाएं
first_frameimage, वैकल्पिक, अधिकतम 1jpg, jpeg, png, webp, heic, heifअधिकतम आकार 30 MB; चौड़ाई 256–5760 px; ऊंचाई 256–5760 px
last_frameimage, वैकल्पिक, अधिकतम 1jpg, jpeg, png, webp, heic, heifअधिकतम आकार 30 MB; चौड़ाई 256–5760 px; ऊंचाई 256–5760 px
reference_imageimage, वैकल्पिक, अधिकतम 9jpg, jpeg, png, webp, heic, heifअधिकतम आकार 30 MB; चौड़ाई 256–5760 px; ऊंचाई 256–5760 px
reference_videovideo, वैकल्पिक, अधिकतम 3mp4, movअधिकतम आकार 50 MB; चौड़ाई 256–5760 px; ऊंचाई 256–5760 px; अवधि 2–15 सेकंड; न्यूनतम फ़्रेम रेट 23.976 fps, और अधिकतम 60 fps; इस भूमिका का कुल अधिकतम 15 सेकंड
reference_audioaudio, वैकल्पिक, अधिकतम 3wav, mp3अधिकतम आकार 15 MB; अवधि 2–15 सेकंड; इस भूमिका का कुल अधिकतम 15 सेकंड

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

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

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

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

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

{
"model": "MiniMax-H3",
"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": "768p",
"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इस उपखंड की संयोजन सीमाओं के अनुसार सेकंड, अनुपात, ऑडियो सेटिंग या मीडिया जोड़ें।
mutually_exclusive_rolesपहले/अंतिम फ़्रेम और रेफ़रेंस मीडिया अलग-अलग इस्तेमाल करें।
count / media_roleइस उपखंड की मीडिया तालिका के अनुसार भूमिका और संख्या सुधारें।
video_input_unsupportedसार्वजनिक HTTPS पता, Content-Type और फ़ाइल फ़ॉर्मैट जांचें, फिर नया अनुमान लें।

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

MiniMax-H3

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

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

फ़ील्डप्रकारज़रूरीअनुमत मान या सीमाडिफ़ॉल्ट
audio.modestringनहींprovider_defaultprovider_default
duration.modestringनहींfixedfixed
duration.secondsintegerनहीं4–15, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए4
output.aspect_ratiostringनहींadaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16adaptive
output.formatstringनहींmp4mp4
output.resolutionstringनहीं768p, 2k768p
promptstringहांस्ट्रिंगकोई नहीं
watermarkbooleanनहींfalse, truefalse

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

मीडिया भूमिकाप्रकार और संख्याफ़ॉर्मैटहर फ़ाइल की सीमाएं
reference_imageimage, वैकल्पिक, अधिकतम 9jpg, jpeg, png, webp, heic, heifअधिकतम आकार 30 MB; चौड़ाई 256–5760 px; ऊंचाई 256–5760 px
reference_videovideo, वैकल्पिक, अधिकतम 3mp4, movअधिकतम आकार 50 MB; चौड़ाई 256–5760 px; ऊंचाई 256–5760 px; अवधि 2–15 सेकंड; न्यूनतम फ़्रेम रेट 23.976 fps, और अधिकतम 60 fps; इस भूमिका का कुल अधिकतम 15 सेकंड
reference_audioaudio, वैकल्पिक, अधिकतम 3wav, mp3अधिकतम आकार 15 MB; अवधि 2–15 सेकंड; इस भूमिका का कुल अधिकतम 15 सेकंड

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

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

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

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

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

{
"model": "MiniMax-H3",
"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": "768p",
"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इस उपखंड की संयोजन सीमाओं के अनुसार सेकंड, अनुपात, ऑडियो सेटिंग या मीडिया जोड़ें।
mutually_exclusive_rolesपहले/अंतिम फ़्रेम और रेफ़रेंस मीडिया अलग-अलग इस्तेमाल करें।
count / media_roleइस उपखंड की मीडिया तालिका के अनुसार भूमिका और संख्या सुधारें।
video_input_unsupportedसार्वजनिक HTTPS पता, Content-Type और फ़ाइल फ़ॉर्मैट जांचें, फिर नया अनुमान लें।

वीडियो रीजनरेशन

MiniMax-H3

अपने 768p H3 वीडियो को उसी सामग्री के साथ 2k में दोबारा बनाने के लिए यह ऑपरेशन इस्तेमाल करें। यह किसी भी मनमानी वीडियो फ़ाइल को स्वीकार नहीं करता।

सोर्स टास्क को सभी शर्तें पूरी करनी चाहिए:

  • वह आपके खाते का हो और उसका Model ID MiniMax-H3 हो।
  • जनरेशन सफल हो चुका हो और वीडियो अभी भी डाउनलोड किया जा सकता हो।
  • उसका आउटपुट 768p पर सेट हो।
  • उसे बने हुए 7 दिन से अधिक न हुए हों।

सर्वर सोर्स वीडियो का फ़ॉर्मैट भी जांचता है। शर्तें पूरी न होने पर 422 video_regeneration_source_invalid मिलता है। अनुमान के लिए सोर्स टास्क ID इस्तेमाल करें; उसकी जगह देने के लिए वीडियो फ़ाइल में खुद बदलाव न करें।

अनुरोध फ़ील्डप्रकारज़रूरीमान
modelstringहांMiniMax-H3
operationstringहांvideo_edit
provider_options.hailuo.source_task_idstringहांशर्तें पूरी करने वाले आपके सोर्स टास्क की ID
watermarkbooleanनहींfalse / true, डिफ़ॉल्ट false

prompt, duration, output, audio या media न भेजें। रीजनरेशन सोर्स टास्क की सामग्री और इनपुट लेता है और 2k, adaptive, MP4 आउटपुट देता है।

अनुमान लेने और टास्क बनाने से पहले REPLACE_WITH_YOUR_H3_TASK_ID को अपनी सोर्स टास्क ID से बदलें। इससे नया भुगतान वाला टास्क बनता है, इसलिए नई स्टेट फ़ाइल इस्तेमाल करें।

{
"model": "MiniMax-H3",
"operation": "video_edit",
"provider_options": {
"hailuo": {
"source_task_id": "REPLACE_WITH_YOUR_H3_TASK_ID"
}
}
}

सोर्स टास्क शर्तें पूरी न करे या मौजूद न हो तो अनुमान में 422 video_regeneration_source_invalid और field_path में provider_options.hailuo.source_task_id मिलता है। नीचे का उदाहरण यह त्रुटि पहचानने के लिए है; इससे जनरेशन नहीं कर सकते:

{
"model": "MiniMax-H3",
"operation": "video_edit",
"provider_options": {
"hailuo": {
"source_task_id": "video_DOES_NOT_EXIST"
}
}
}

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

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