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-H3 | image_to_video | 4–15, अंतराल 1 | 768p, 2k | adaptive | provider_default | first_frame, last_frame, reference_image, reference_video, reference_audio |
MiniMax-H3 | reference_to_video | 4–15, अंतराल 1 | 768p, 2k | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | provider_default | reference_image, reference_video, reference_audio |
MiniMax-H3 | text_to_video | 4–15, अंतराल 1 | 768p, 2k | 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | provider_default | कोई नहीं |
MiniMax-H3 | video_edit | सोर्स टास्क से ली जाती है | 2k | adaptive (सोर्स से) | provider_default | सोर्स टास्क ID |
provider_default मॉडल की ऑडियो सेटिंग रखता है और on / off स्विच नहीं देता। रीजनरेशन में अनुपात, अवधि और इनपुट सोर्स टास्क से लिए जाते हैं।
नमूना मीडिया
इमेज से वीडियो और इमेज रेफ़रेंस वाले उदाहरण सफ़ेद मेज़ पर नीले सिरेमिक मग का इस्तेमाल करते हैं। आज़माने के लिए नमूना इमेज रखें, या पहले इसे ऐसे सार्वजनिक HTTPS मीडिया से बदलें जिसे इस्तेमाल करने का अधिकार आपके पास हो और जो इस पेज की सीमाएं पूरी करता हो।

टेक्स्ट से वीडियो
MiniMax-H3
केवल टेक्स्ट विवरण होने पर यह ऑपरेशन इस्तेमाल करें।
model को इस उपखंड के Model ID और operation को text_to_video पर सेट करें। केवल नीचे दिए गए जनरेशन फ़ील्ड इस्तेमाल करें। मीडिया को media ऐरे में रखें।
| फ़ील्ड | प्रकार | ज़रूरी | अनुमत मान या सीमा | डिफ़ॉल्ट |
|---|---|---|---|---|
audio.mode | string | नहीं | provider_default | provider_default |
duration.mode | string | नहीं | fixed | fixed |
duration.seconds | integer | नहीं | 4–15, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए | 4 |
output.aspect_ratio | string | हां | 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | कोई नहीं |
output.format | string | नहीं | mp4 | mp4 |
output.resolution | string | नहीं | 768p, 2k | 768p |
prompt | string | हां | स्ट्रिंग | कोई नहीं |
watermark | boolean | नहीं | false, true | false |
मीडिया की ज़रूरतें
यह ऑपरेशन मीडिया स्वीकार नहीं करता।
संयोजन की सीमाएं
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.mode | string | नहीं | provider_default | provider_default |
duration.mode | string | नहीं | fixed | fixed |
duration.seconds | integer | नहीं | 4–15, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए | 4 |
output.aspect_ratio | string | नहीं | adaptive | adaptive |
output.format | string | नहीं | mp4 | mp4 |
output.resolution | string | नहीं | 768p, 2k | 768p |
prompt | string | हां | स्ट्रिंग | कोई नहीं |
watermark | boolean | नहीं | false, true | false |
मीडिया की ज़रूरतें
| मीडिया भूमिका | प्रकार और संख्या | फ़ॉर्मैट | हर फ़ाइल की सीमाएं |
|---|---|---|---|
first_frame | image, वैकल्पिक, अधिकतम 1 | jpg, jpeg, png, webp, heic, heif | अधिकतम आकार 30 MB; चौड़ाई 256–5760 px; ऊंचाई 256–5760 px |
last_frame | image, वैकल्पिक, अधिकतम 1 | jpg, jpeg, png, webp, heic, heif | अधिकतम आकार 30 MB; चौड़ाई 256–5760 px; ऊंचाई 256–5760 px |
reference_image | image, वैकल्पिक, अधिकतम 9 | jpg, jpeg, png, webp, heic, heif | अधिकतम आकार 30 MB; चौड़ाई 256–5760 px; ऊंचाई 256–5760 px |
reference_video | video, वैकल्पिक, अधिकतम 3 | mp4, mov | अधिकतम आकार 50 MB; चौड़ाई 256–5760 px; ऊंचाई 256–5760 px; अवधि 2–15 सेकंड; न्यूनतम फ़्रेम रेट 23.976 fps, और अधिकतम 60 fps; इस भूमिका का कुल अधिकतम 15 सेकंड |
reference_audio | audio, वैकल्पिक, अधिकतम 3 | wav, 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.mode | string | नहीं | provider_default | provider_default |
duration.mode | string | नहीं | fixed | fixed |
duration.seconds | integer | नहीं | 4–15, अंतराल 1 सेकंड; केवल निश्चित अवधि के लिए | 4 |
output.aspect_ratio | string | नहीं | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | adaptive |
output.format | string | नहीं | mp4 | mp4 |
output.resolution | string | नहीं | 768p, 2k | 768p |
prompt | string | हां | स्ट्रिंग | कोई नहीं |
watermark | boolean | नहीं | false, true | false |
मीडिया की ज़रूरतें
| मीडिया भूमिका | प्रकार और संख्या | फ़ॉर्मैट | हर फ़ाइल की सीमाएं |
|---|---|---|---|
reference_image | image, वैकल्पिक, अधिकतम 9 | jpg, jpeg, png, webp, heic, heif | अधिकतम आकार 30 MB; चौड़ाई 256–5760 px; ऊंचाई 256–5760 px |
reference_video | video, वैकल्पिक, अधिकतम 3 | mp4, mov | अधिकतम आकार 50 MB; चौड़ाई 256–5760 px; ऊंचाई 256–5760 px; अवधि 2–15 सेकंड; न्यूनतम फ़्रेम रेट 23.976 fps, और अधिकतम 60 fps; इस भूमिका का कुल अधिकतम 15 सेकंड |
reference_audio | audio, वैकल्पिक, अधिकतम 3 | wav, 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 इस्तेमाल करें; उसकी जगह देने के लिए वीडियो फ़ाइल में खुद बदलाव न करें।
| अनुरोध फ़ील्ड | प्रकार | ज़रूरी | मान |
|---|---|---|---|
model | string | हां | MiniMax-H3 |
operation | string | हां | video_edit |
provider_options.hailuo.source_task_id | string | हां | शर्तें पूरी करने वाले आपके सोर्स टास्क की ID |
watermark | boolean | नहीं | 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 कॉल करते समय इस पेज के फ़ील्ड और वर्तमान मॉडल सूची का संबंधित ऑपरेशन इस्तेमाल करें।

