API MiniMax H3

Référence API complète pour les modèles de génération vidéo MiniMax H3.

Variantes du modèle

Cette API prend en charge trois variantes du modèle :

Comparaison rapide

Formats d'image pris en charge

Texte vers vidéo et Référence vers vidéo prennent en charge :

21:9, 16:9, 4:3, 1:1, 3:4, 9:16

Options de résolution

MiniMax H3 Texte vers vidéo

Point de terminaison

POST /api/v1/video/task

Paramètres de la requête

Obligatoires

Exemple de requête

javascriptCopier
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'minimax-h3-text-to-video',
    prompt: 'Un golden retriever courant dans une prairie baignée de soleil',
    duration: 8,
    resolution: '2k',
    aspect_ratio: '16:9'
  })
});

const { data } = await response.json();
const taskId = data.task_id;

MiniMax H3 Image vers vidéo

Point de terminaison

POST /api/v1/video/task

Paramètres de la requête

Obligatoires

Facultatifs

Remarque : Image vers vidéo ne prend pas en charge aspect_ratio.

Exemple de requête

javascriptCopier
{
  model_name: 'minimax-h3-image-to-video',
  image_url: 'https://example.com/first-frame.jpg',
  image_end_url: 'https://example.com/last-frame.jpg',
  prompt: 'La caméra recule lentement pour révéler l\'ensemble du paysage',
  duration: 8,
  resolution: '2k'
}

MiniMax H3 Référence vers vidéo

Générez une nouvelle vidéo à partir de références facultatives d'image, de vidéo et d'audio.

Point de terminaison

POST /api/v1/video/task

Paramètres de la requête

Obligatoires

Médias de référence

Espaces réservés de référence @ (AT)

La fonctionnalité de référence @ (AT) relie les médias de référence au prompt à l'aide d'espaces réservés <<<...>>> numérotés. La numérotation commence à 1 indépendamment pour chaque type de média et suit l'ordre du tableau correspondant.

Par exemple, si la première image est une référence de personnage et la seconde une référence de scène, utilisez <<<image_1>>> pour le personnage et <<<image_2>>> pour la scène dans prompt. Chaque espace réservé doit pointer vers un élément présent dans le tableau correspondant.

Exemple de requête

javascriptCopier
{
  model_name: 'minimax-h3-reference-to-video',
  prompt: 'Utilisez l\'image un pour le sujet, la vidéo un pour le mouvement et l\'audio un pour l\'atmosphère',
  duration: 8,
  resolution: '2k',
  aspect_ratio: '16:9',
  images: ['https://example.com/subject-reference.jpg'],
  videos: ['https://example.com/motion-reference.mp4'],
  audios: ['https://example.com/atmosphere-reference.mp3']
}

Exemple de requête Référence vers vidéo @ (AT)

javascriptCopier
{
  model_name: 'minimax-h3-reference-to-video',
  prompt: 'Placez l\'explorateur de <<<image_1>>> dans l\'environnement de <<<image_2>>>, en suivant le mouvement de caméra de <<<video_1>>> et en parlant avec la voix de référence de <<<audio_1>>>',
  duration: 10,
  resolution: '2k',
  aspect_ratio: '16:9',
  images: [
    'https://example.com/explorer-reference.jpg',
    'https://example.com/environment-reference.jpg'
  ],
  videos: ['https://example.com/camera-movement-reference.mp4'],
  audios: ['https://example.com/voice-reference.mp3']
}

Format de la réponse

Réponse initiale

Tous les modèles renvoient un task_id pour l'interrogation :

jsonCopier
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}

Réponse de l'interrogation

Interrogez GET /api/v1/video/{taskId} pour vérifier l'état :

jsonCopier
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "task_result": {
      "videos": [
        {
          "url": "https://example.com/generated-video.mp4"
        }
      ]
    }
  }
}

Valeurs d'état

• submitted : Tâche acceptée et en attente de traitement
• processing : Génération de la vidéo en cours
• succeed : Génération de la vidéo terminée
• failed : Échec de la génération de la vidéo

Bonnes pratiques

1. Décrivez clairement le mouvement : Incluez des descriptions précises du mouvement dans les prompts
2. Sélection de la résolution : Utilisez 768p pour un traitement plus rapide et 2k pour une sortie de meilleure qualité
3. Qualité de l'image : Pour la conversion d'image en vidéo, utilisez des images d'entrée de haute qualité afin d'obtenir les meilleurs résultats
4. Ordre des références : Conservez images, videos et audios dans un ordre intentionnel et faites-y référence de manière cohérente dans le prompt
5. Références @ (AT) : Utilisez les espaces réservés <<<image_N>>>, <<<video_N>>> et <<<audio_N>>> lorsque vous avez besoin de contrôler explicitement quel élément de référence détermine chaque partie de la scène