API vidéo MiniMax H3 : génération et régénération
Connectez MiniMax H3 avec votre BetterToken API Key et choisissez les champs, médias et modes de génération selon le Model ID et l’opération.
Vous pouvez générer des vidéos à partir de texte, d’images de début et de fin ou de médias de référence. Vous pouvez aussi régénérer vos propres vidéos H3 de 768p admissibles en 2k. La régénération accepte uniquement l’ID de la tâche source, sans nouvelle URL de média.
Préparez votre BetterToken API Key. La Base URL est https://bettertoken.ai/v1 et l’authentification utilise Authorization: Bearer YOUR_API_KEY. Copiez le Model ID à l’identique, en respectant la casse.
Chaque request.json de cette page suit le même processus : demandez un devis, confirmez la création, suivez la tâche et téléchargez le résultat. Le devis ne lance pas la génération ; la création soumet une tâche payante. Consultez les tarifs actuels dans la model plaza.
Modèles et opérations
Le tableau présente les options par opération. Consultez les valeurs par défaut, les quantités de médias et les contraintes de combinaison dans chaque section. Les tailles utilisent 1 MB = 1048576 octets.
| Model ID | Opération | Durée (secondes) | Niveau de sortie | Rapport d’aspect | Audio | Rôles des médias |
|---|---|---|---|---|---|---|
MiniMax-H3 | image_to_video | 4–15, pas 1 | 768p, 2k | adaptive | provider_default | first_frame, last_frame, reference_image, reference_video, reference_audio |
MiniMax-H3 | reference_to_video | 4–15, pas 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, pas 1 | 768p, 2k | 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | provider_default | Aucun |
MiniMax-H3 | video_edit | Héritée de la tâche source | 2k | adaptive (hérité) | provider_default | ID de tâche source |
provider_default conserve les réglages audio du modèle, sans option on / off. Le rapport d’aspect, la durée et les entrées de la régénération dépendent de la tâche source.
Médias d’exemple
Les exemples de génération à partir d’images et de références utilisent une tasse en céramique bleue sur une table blanche. Vous pouvez essayer l’image fournie ou la remplacer d’abord par des médias HTTPS publics que vous avez le droit d’utiliser et qui respectent les limites de cette page.

Du texte à la vidéo
MiniMax-H3
Utilisez cette opération pour générer une vidéo à partir d’une description textuelle seule.
Définissez model sur le Model ID de cette section et operation sur text_to_video. Utilisez uniquement les champs de génération du tableau ci-dessous ; placez les médias dans le tableau media.
| Champ | Type | Obligatoire | Valeurs ou plage | Valeur par défaut |
|---|---|---|---|---|
audio.mode | string | Non | provider_default | provider_default |
duration.mode | string | Non | fixed | fixed |
duration.seconds | integer | Non | 4–15, pas 1 s; uniquement en durée fixe | 4 |
output.aspect_ratio | string | Oui | 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Aucun |
output.format | string | Non | mp4 | mp4 |
output.resolution | string | Non | 768p, 2k | 768p |
prompt | string | Oui | Chaîne | Aucun |
watermark | boolean | Non | false, true | false |
Exigences des médias
Cette opération n’accepte aucun média.
Contraintes de combinaison
duration.mode="fixed"exigeduration.seconds. Si vous indiquez explicitementfixed, précisez aussi le nombre de secondes.
Exemple de requête
Enregistrez le JSON ci-dessous dans request.json, puis suivez le processus général : demandez un devis et confirmez avant de créer la tâche.
{ "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" }}Erreurs 422 courantes
| Code d’erreur 422 | Solution |
|---|---|
enum / range / step | Ajustez les valeurs et le pas selon le tableau des champs de cette section. |
unsupported_field | Supprimez les champs absents du tableau de cette opération. |
requires | Ajoutez les secondes, le rapport d’aspect, les réglages audio ou les médias selon les contraintes de cette section. |
De l’image à la vidéo
MiniMax-H3
Utilisez cette opération pour définir l’image de début ou les images de début et de fin à partir d’images.
Définissez model sur le Model ID de cette section et operation sur image_to_video. Utilisez uniquement les champs de génération du tableau ci-dessous ; placez les médias dans le tableau media.
| Champ | Type | Obligatoire | Valeurs ou plage | Valeur par défaut |
|---|---|---|---|---|
audio.mode | string | Non | provider_default | provider_default |
duration.mode | string | Non | fixed | fixed |
duration.seconds | integer | Non | 4–15, pas 1 s; uniquement en durée fixe | 4 |
output.aspect_ratio | string | Non | adaptive | adaptive |
output.format | string | Non | mp4 | mp4 |
output.resolution | string | Non | 768p, 2k | 768p |
prompt | string | Oui | Chaîne | Aucun |
watermark | boolean | Non | false, true | false |
Exigences des médias
| Rôle du média | Type et quantité | Formats | Limites par fichier |
|---|---|---|---|
first_frame | image, facultatif, au maximum 1 | jpg, jpeg, png, webp, heic, heif | Taille maximale : 30 MB; largeur : 256–5760 px; hauteur : 256–5760 px |
last_frame | image, facultatif, au maximum 1 | jpg, jpeg, png, webp, heic, heif | Taille maximale : 30 MB; largeur : 256–5760 px; hauteur : 256–5760 px |
reference_image | image, facultatif, au maximum 9 | jpg, jpeg, png, webp, heic, heif | Taille maximale : 30 MB; largeur : 256–5760 px; hauteur : 256–5760 px |
reference_video | video, facultatif, au maximum 3 | mp4, mov | Taille maximale : 50 MB; largeur : 256–5760 px; hauteur : 256–5760 px; durée : 2–15 s; fréquence d’images minimale : 23.976 fps ; maximale : 60 fps; durée totale maximale de ce rôle : 15 s |
reference_audio | audio, facultatif, au maximum 3 | wav, mp3 | Taille maximale : 15 MB; durée : 2–15 s; durée totale maximale de ce rôle : 15 s |
Les médias requis dépendent aussi des contraintes de combinaison ci-dessous.
Contraintes de combinaison
duration.mode="fixed"exigeduration.seconds. Si vous indiquez explicitementfixed, précisez aussi le nombre de secondes.- Fournissez au moins un de ces rôles :
first_frame,last_frame. - Ne combinez pas les images de début ou de fin avec des images, vidéos ou fichiers audio de référence. Utilisez l’opération image vers vidéo pour les images de début et de fin, et la génération avec références pour les médias de référence.
Exemple de requête
Enregistrez le JSON ci-dessous dans request.json, puis suivez le processus général : demandez un devis et confirmez avant de créer la tâche.
{ "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" } ]}Erreurs 422 courantes
| Code d’erreur 422 | Solution |
|---|---|
enum / range / step | Ajustez les valeurs et le pas selon le tableau des champs de cette section. |
unsupported_field | Supprimez les champs absents du tableau de cette opération. |
requires | Ajoutez les secondes, le rapport d’aspect, les réglages audio ou les médias selon les contraintes de cette section. |
mutually_exclusive_roles | Utilisez les images de début et de fin séparément des médias de référence. |
count / media_role | Ajustez les rôles et les quantités selon le tableau des médias de cette section. |
video_input_unsupported | Vérifiez l’URL HTTPS publique, le Content-Type et le format du fichier, puis demandez un nouveau devis. |
Génération avec références
MiniMax-H3
Utilisez cette opération pour conserver les caractéristiques du sujet ou du mouvement à l’aide de médias de référence.
Définissez model sur le Model ID de cette section et operation sur reference_to_video. Utilisez uniquement les champs de génération du tableau ci-dessous ; placez les médias dans le tableau media.
| Champ | Type | Obligatoire | Valeurs ou plage | Valeur par défaut |
|---|---|---|---|---|
audio.mode | string | Non | provider_default | provider_default |
duration.mode | string | Non | fixed | fixed |
duration.seconds | integer | Non | 4–15, pas 1 s; uniquement en durée fixe | 4 |
output.aspect_ratio | string | Non | adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | adaptive |
output.format | string | Non | mp4 | mp4 |
output.resolution | string | Non | 768p, 2k | 768p |
prompt | string | Oui | Chaîne | Aucun |
watermark | boolean | Non | false, true | false |
Exigences des médias
| Rôle du média | Type et quantité | Formats | Limites par fichier |
|---|---|---|---|
reference_image | image, facultatif, au maximum 9 | jpg, jpeg, png, webp, heic, heif | Taille maximale : 30 MB; largeur : 256–5760 px; hauteur : 256–5760 px |
reference_video | video, facultatif, au maximum 3 | mp4, mov | Taille maximale : 50 MB; largeur : 256–5760 px; hauteur : 256–5760 px; durée : 2–15 s; fréquence d’images minimale : 23.976 fps ; maximale : 60 fps; durée totale maximale de ce rôle : 15 s |
reference_audio | audio, facultatif, au maximum 3 | wav, mp3 | Taille maximale : 15 MB; durée : 2–15 s; durée totale maximale de ce rôle : 15 s |
Les médias requis dépendent aussi des contraintes de combinaison ci-dessous.
Contraintes de combinaison
duration.mode="fixed"exigeduration.seconds. Si vous indiquez explicitementfixed, précisez aussi le nombre de secondes.- Fournissez au moins un de ces rôles :
reference_image,reference_video,reference_audio. - Ne combinez pas les images de début ou de fin avec des images, vidéos ou fichiers audio de référence. Utilisez l’opération image vers vidéo pour les images de début et de fin, et la génération avec références pour les médias de référence.
Exemple de requête
Enregistrez le JSON ci-dessous dans request.json, puis suivez le processus général : demandez un devis et confirmez avant de créer la tâche.
{ "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" } ]}Erreurs 422 courantes
| Code d’erreur 422 | Solution |
|---|---|
enum / range / step | Ajustez les valeurs et le pas selon le tableau des champs de cette section. |
unsupported_field | Supprimez les champs absents du tableau de cette opération. |
requires | Ajoutez les secondes, le rapport d’aspect, les réglages audio ou les médias selon les contraintes de cette section. |
mutually_exclusive_roles | Utilisez les images de début et de fin séparément des médias de référence. |
count / media_role | Ajustez les rôles et les quantités selon le tableau des médias de cette section. |
video_input_unsupported | Vérifiez l’URL HTTPS publique, le Content-Type et le format du fichier, puis demandez un nouveau devis. |
Régénérer une vidéo
MiniMax-H3
Utilisez cette opération si vous disposez de votre propre vidéo H3 de 768p et souhaitez la régénérer en 2k en conservant son contenu. Elle n’accepte pas de fichiers vidéo quelconques.
La tâche source doit respecter toutes les conditions suivantes :
- Elle appartient à votre compte et son Model ID est
MiniMax-H3. - La génération a réussi et la vidéo est toujours téléchargeable.
- La sortie est définie sur
768p. - Sa création remonte à 7 jours au maximum.
Le serveur vérifie aussi le format de la vidéo source et renvoie 422 video_regeneration_source_invalid si elle n’est pas admissible. Demandez le devis avec l’ID de la tâche source ; ne modifiez pas le fichier vidéo pour remplacer cette tâche.
| Champ de requête | Type | Obligatoire | Valeur |
|---|---|---|---|
model | string | Oui | MiniMax-H3 |
operation | string | Oui | video_edit |
provider_options.hailuo.source_task_id | string | Oui | ID de votre tâche source admissible |
watermark | boolean | Non | false / true, par défaut : false |
N’envoyez ni prompt, ni duration, ni output, ni audio, ni media. La régénération reprend le contenu et les entrées de la tâche source et produit une sortie 2k, adaptive, MP4.
Remplacez d’abord REPLACE_WITH_YOUR_H3_TASK_ID par l’ID de votre tâche source, puis demandez le devis et créez la tâche. Cela crée une nouvelle tâche payante ; utilisez un nouveau fichier d’état.
{ "model": "MiniMax-H3", "operation": "video_edit", "provider_options": { "hailuo": { "source_task_id": "REPLACE_WITH_YOUR_H3_TASK_ID" } }}Si la tâche source n’est pas admissible ou n’existe pas, le devis renvoie 422 video_regeneration_source_invalid, avec field_path défini sur provider_options.hailuo.source_task_id. L’exemple ci-dessous illustre cette erreur et ne permet pas de générer une vidéo :
{ "model": "MiniMax-H3", "operation": "video_edit", "provider_options": { "hailuo": { "source_task_id": "video_DOES_NOT_EXIST" } }}Documentation officielle
Pour appeler BetterToken, utilisez les champs de cette page et l’opération correspondante du catalogue de modèles en temps réel.

