Passer au contenu principal
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "MiniMax-Hailuo-2.3",
    "prompt": "A cute kitten running on the grass",
    "duration": 6,
    "resolution": "768p",
    "prompt_optimizer": true,
    "fast_pretreatment": false,
    "watermark": false
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01J9HA7JPQ9A0Z6JZ3V8M9W6PZ"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

curl --request POST \
  --url https://api.apimart.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "MiniMax-Hailuo-2.3",
    "prompt": "A cute kitten running on the grass",
    "duration": 6,
    "resolution": "768p",
    "prompt_optimizer": true,
    "fast_pretreatment": false,
    "watermark": false
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01J9HA7JPQ9A0Z6JZ3V8M9W6PZ"
    }
  ]
}

​
Autorisation

​
Authorization
string
requis
Tous les endpoints API requièrent une authentification par Bearer TokenObtenez votre API Key :Visitez la page de gestion des API Keys pour obtenir votre API KeyAjoutez-la à l’en-tête de la requête :
Authorization: Bearer YOUR_API_KEY

​
Paramètres de la requête

​
model
string
requis
Modèles pris en charge :
  • MiniMax-Hailuo-2.3 — Hailuo 2.3
  • MiniMax-Hailuo-2.3-Fast — Hailuo 2.3 Fast (latence réduite)
MiniMax-Hailuo-2.3-Fast :
Avec ce modèle, first_frame_image est obligatoire.
​
prompt
string
requis
Description du contenu de la vidéo (2000 caractères maximum)Décrivez les scènes, actions et styles en détail pour de meilleurs résultats. Prend en charge les commandes de mouvement de caméra (voir la section « Commandes de mouvement de caméra » ci-dessous).Exemple : "A cute kitten running on the grass"
​
duration
integer
défaut:"6"
Durée de la vidéo (secondes)Options :
  • 6 — vidéo de 6 secondes
  • 10 — vidéo de 10 secondes
Par défaut : 6
Limitation 1080p : à la résolution 1080p, seule la durée de 6 secondes est prise en charge
​
resolution
string
défaut:"768p"
Résolution de la vidéoOptions :
  • 768p — haute définition
  • 1080p — Full HD (uniquement 6 secondes)
Par défaut : 768p
​
first_frame_image
string
Image de première trame de la vidéoDeux formats pris en charge :
  • URL publique : https://example.com/start.jpg
  • Encodage Base64 : data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
Lorsqu’elle est fournie, cette image sera utilisée comme première trame de la vidéo
MiniMax-Hailuo-2.3-Fast :
Avec ce modèle, first_frame_image est obligatoire.
​
prompt_optimizer
boolean
défaut:"true"
Optimiser automatiquement le promptLorsqu’activé, le système optimise automatiquement votre prompt pour de meilleurs résultatsPar défaut : true
​
fast_pretreatment
boolean
défaut:"false"
Réduire le temps d’optimisation du promptLorsqu’activé, la vitesse de traitement est plus rapide mais la qualité de l’optimisation peut être légèrement affectéePar défaut : false
​
watermark
boolean
défaut:"false"
Ajouter un filigranePar défaut : false

​
Combinaisons résolution / durée

RésolutionDurée prise en chargeRemarques
768p6s, 10sToutes prises en charge
1080p6s10s non pris en charge

​
Commandes de mouvement de caméra

Utilisez la syntaxe [commande] dans le prompt pour contrôler les mouvements de caméra. 15 commandes sont prises en charge :
CatégorieCommandes
Panoramique[左移] (panoramique gauche) [右移] (panoramique droite)
Rotation horizontale[左摇] (rotation gauche) [右摇] (rotation droite)
Avant/arrière[推进] (avancer) [拉远] (reculer)
Mouvement vertical[上升] (monter) [下降] (descendre)
Rotation verticale[上摇] (incliner vers le haut) [下摇] (incliner vers le bas)
Zoom[变焦推近] (zoom avant) [变焦拉远] (zoom arrière)
Autres[晃动] (tremblement) [跟随] (suivre) [固定] (statique)
Exemple d’utilisation : 
{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "[推进]A cat running in the garden, camera slowly pushing in for a close-up"
}

​
Réponse

​
code
integer
Code de statut de la réponse, 200 en cas de succès
​
data
array
Tableau de données de la réponse

​
Cas d’utilisation

​
Cas 1 : Génération rapide texte-vers-vidéo

{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "A cute kitten running on the grass, sunny day"
}

​
Cas 2 : Vidéo 1080p de haute qualité

{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "City nightscape, neon lights flickering, traffic flowing",
  "duration": 6,
  "resolution": "1080p",
  "prompt_optimizer": true,
  "watermark": false
}

​
Cas 3 : Image-vers-vidéo avec première trame

{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "Kitten running towards camera, smiling and blinking",
  "first_frame_image": "https://example.com/cat.jpg",
  "duration": 6,
  "resolution": "1080p"
}

​
Cas 4 : Commandes de mouvement de caméra

{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "[推进]A cat running in the garden, camera slowly pushing in for a close-up",
  "duration": 6,
  "resolution": "768p"
}

​
Cas 5 : Mode de prétraitement rapide

{
  "model": "MiniMax-Hailuo-2.3",
  "prompt": "Waves crashing on the beach at sunset",
  "duration": 10,
  "resolution": "768p",
  "prompt_optimizer": true,
  "fast_pretreatment": true
}
Interroger les résultats de la tâcheLa génération vidéo est une tâche asynchrone qui renvoie un task_id lors de la soumission. Utilisez l’endpoint Obtenir le statut de la tâche pour interroger la progression et les résultats de la génération.