MiniMax-H3 API

Utilisez l’ID de modèle exact MiniMax-H3. Le champ modèle doit correspondre exactement à cette page.

Exemple de sortieMiniMax-H3POST /v1/videos5.2s

Paramètres : duration=5resolution=2Kratio=16:9

Prompt : A fleet of hot-air balloons drifts over mist-filled mountain valleys at dawn. Aerial camera glides slowly between the balloons as golden light breaks over the ridges and fog rolls through the pines below. Calm, majestic, photoreal landscape, steady motion, no text.

Requête qui a produit cet échantillon

{
  "model": "MiniMax-H3",
  "prompt": "A fleet of hot-air balloons drifts over mist-filled mountain valleys at dawn. Aerial camera glides slowly between the balloons as golden light breaks over the ridges and fog rolls through the pines below. Calm, majestic, photoreal landscape, steady motion, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "2K",
  "ratio": "16:9",
  "aspect_ratio": "16:9"
}

Authentification et point de terminaison

Utilisez une clé API Modelflare avec https://modelflare.dev/v1. Le point d’entrée de la passerelle est POST /v1/videos.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Créer une tâche

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "content": [{"type": "text", "text": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot"}],
    "resolution": "2K", "duration": 5, "ratio": "16:9"
  }'

Sondage et téléchargement

Enregistrez l’ID de la tâche. Sondez GET /v1/videos/{task_id} et téléchargez avec GET /v1/videos/{task_id}/content. Les URL des résultats peuvent expirer, alors transférez le fichier rapidement.

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Demander des notes

MiniMax-H3 utilise content[] avec la sortie de contrôle resolution, duration et ratio.

Paramètres de requête

MiniMax-H3 utilise un tableau multimodal content[]. Interrogez le chemin de requête MiniMax après la création de la tâche ; Les rôles first_frame / last_frame et reference_* sont des flux de travail distincts.

Champ	Obligatoire	Remarques
model	Oui	MiniMax-H3
content[]	Oui	Exactement un élément text ; peut inclure first_frame, last_frame, reference_image, reference_video ou reference_audio
resolution	Oui	768P / 2K
duration	Oui	4 à 15 secondes
ratio	Conditionnel	21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive
content[].role	Conditionnel	Utilisez first_frame / last_frame pour la conversion image-vidéo et reference_* pour les flux de travail de référence ; ne mélangez pas les groupes
content[].url	Non	URL HTTP/HTTPS publique requise ; Le support Base64 n’est pas pris en charge
aigc_watermark	Non	S’il faut ajouter un filigrane
callback_url	Non	URL de rappel de l’état de la tâche

Limites d’entrée et de sortie

La sortie est 768P ou 2K pendant 4 à 15 secondes. Les requêtes en texte uniquement nécessitent un ratio concret ; l’image vers la vidéo autorise une première image et une dernière image, tandis que les flux de travail de référence nécessitent au moins une image ou une vidéo de référence et ne peuvent pas utiliser l’audio seul. Ne mélangez pas les deux groupes de rôles.

Exemples de flux de travail documentés

MiniMax-H3 doivent être accessibles au public et ne peuvent pas utiliser Base64 ; Les workflows de première/fin image et de référence ne doivent pas être mélangés.

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "content": [
      {"type": "text", "text": "让图像主体沿视频动作自然移动"},
      {"type": "reference_image", "role": "reference_image", "url": "https://example.com/subject.png"},
      {"type": "reference_video", "role": "reference_video", "url": "https://example.com/motion.mp4"}
    ],
    "resolution": "2K", "duration": 5, "ratio": "16:9"
  }'

Erreurs et tâches ayant échoué

Les paramètres de modèle invalides renvoient un 4xx avec un ID de demande. Une tâche asynchrone peut également échouer une fois la création réussie ; utilisez error_code et error_message de la réponse au sondage comme raison finale de la tâche. Ne réessayez pas la même requête avec une forme JSON différente.

Portée prise en charge

Cette page couvre la génération et l’édition de modèles Modelflare. L’enrichissement de la recherche ou de la carte, la gestion de la voix et la gestion de la bibliothèque d’éléments sont des API de ressources en dehors de cette surface d’appel de modèle publique et ne sont pas des champs de requête obligatoires.

Tarification et facturation

Ce modèle utilise la facturation vidéo à la seconde. Consultez la page de tarification du modèle pour connaître le prix client actuel, le prix catalogue de référence et les spécifications complètes.

Note

Cette page documente l’interface publique de Modelflare ; les champs et limites indiqués ici sont le contrat en cours.

Variantes

ID du modèle	Différence
MiniMax-H3	Le modèle documenté sur cette page.