Référence API de MiniMax H3

Une seule clé API PopNow suffit pour appeler MiniMax H3 depuis votre code. Vous trouverez ici les identifiants de modèle à envoyer, chaque champ d’entrée accepté, le coût d’une requête en crédits et une requête à coller telle quelle dans un terminal.

Les descriptions des paramètres proviennent du schéma d’entrée du modèle et ne sont disponibles qu’en anglais.

En bref

Éditeur: MiniMax
Résultat: Vidéo
À partir de: 5.55 crédits par seconde produite ($0.0555)
Durée habituelle: environ 33 s
Identifiants de modèle: minimax/h3/text-to-video
minimax/h3/image-to-video
minimax/h3/reference-to-video
minimax/h3/video-extend

1 crédit = 0,01 $. À l’acceptation, une tâche réserve le montant maximal possible, puis facture la consommation réelle à la fin, arrondie au crédit supérieur ; le reste est libéré. Une tâche en échec n’est pas facturée. Pour connaître le montant exact avant de lancer, appelez POST /api/v1/jobs/quote.

Créer une vidéo

minimax/h3/text-to-video

Prix

Option	Crédits (par seconde produite)	Dollars US
`768p`	5.55	$0.0555
`2k`	8.7	$0.087

Paramètres

Champ	Type	Valeur par défaut	Valeurs admises	Rôle
`prompt`Obligatoire	`string`	—	jusqu’à 7 000 caractères	Describe the picture, the action, the camera, the sound, and the boundaries for the shot.
`aspect_ratio`Facultatif	`string`	`16:9`	16:9, 9:16, 1:1, 4:3, 3:4, 21:9	Output aspect ratio.
`resolution`Facultatif	`string`	`768p`	768p, 2k	Output resolution.
`duration_seconds`Facultatif	`integer`	`5`	de 5 à 15	Requested output length in seconds.
`enable_prompt_expansion`Facultatif	`boolean`	`false`	false	Accepted for compatibility only. This endpoint does not expand prompts, so the only allowed value is false.

Exemple de requête

Cette requête fonctionne telle quelle ; les champs omis gardent leur valeur par défaut. Placez d’abord votre clé dans POPNOW_API_KEY.

POST /api/v1/jobs/createTask?wait=60

curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask?wait=60" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "minimax/h3/text-to-video",
  "input": {
    "prompt": "A paper boat drifts down a rain-soaked street at dusk, neon signs reflecting in the water, slow tracking shot at ground level",
    "duration_seconds": 5,
    "resolution": "768p"
  }
}'

La réponse contient tout de suite un taskId. Récupérez le résultat avec GET /api/v1/jobs/recordInfo, ou ajoutez callBackUrl pour être prévenu.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Image vers vidéo

minimax/h3/image-to-video

Prix

Option	Crédits (par seconde produite)	Dollars US
`768p`	5.55	$0.0555
`2k`	8.7	$0.087

Paramètres

Champ	Type	Valeur par défaut	Valeurs admises	Rôle
`prompt`Obligatoire	`string`	—	jusqu’à 7 000 caractères	Describe what happens after the opening frame: the action, the camera, and the sound.
`image_url`Obligatoire	`string (uri)`	—	—	Authorised opening frame.
`last_image_url`Facultatif	`string (uri)`	—	—	Optional closing frame the clip should resolve to.
`resolution`Facultatif	`string`	`768p`	768p, 2k	Output resolution.
`duration_seconds`Facultatif	`integer`	`5`	de 4 à 15	Requested output length in seconds.
`enable_prompt_expansion`Facultatif	`boolean`	`false`	false	Accepted for compatibility only. This endpoint does not expand prompts, so the only allowed value is false.

Exemple de requête

Cette requête fonctionne telle quelle ; les champs omis gardent leur valeur par défaut. Placez d’abord votre clé dans POPNOW_API_KEY.

L’exemple utilise des fichiers d’exemple PopNow dans image_url. Remplacez-les par vos propres liens HTTPS publics, fichiers envoyés ou ressources enregistrées.

POST /api/v1/jobs/createTask

curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "minimax/h3/image-to-video",
  "input": {
    "prompt": "He lands softly on the rooftop, laughs and turns toward the camera while the balloons sway in the evening breeze; slow push-in",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "duration_seconds": 5,
    "resolution": "768p"
  }
}'

La réponse contient tout de suite un taskId. Récupérez le résultat avec GET /api/v1/jobs/recordInfo, ou ajoutez callBackUrl pour être prévenu.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Références vers vidéo

minimax/h3/reference-to-video

Prix

Option	Crédits (par seconde produite)	Dollars US
`768p`	5.55	$0.0555
`2k`	8.7	$0.087

Paramètres

Champ	Type	Valeur par défaut	Valeurs admises	Rôle
`prompt`Obligatoire	`string`	—	jusqu’à 7 000 caractères	Refer to the references by number and describe the shot they should produce.
`reference_image_urls`Obligatoire	`array<string (uri)>`	—	jusqu’à 9 éléments	Authorised image references, up to nine.
`reference_video_urls`Facultatif	`array<string (uri)>`	—	jusqu’à 3 éléments	Up to three reference videos, 2 to 15 seconds each and 15 seconds in total. Refer to them in the prompt as <Video 1> and so on. Their seconds have their own per-second rate, lower than output seconds.
`reference_audio_urls`Facultatif	`array<string (uri)>`	—	jusqu’à 3 éléments	Up to three reference audio clips (WAV or MP3), 2 to 15 seconds each and 15 seconds in total, for a voice or a sound.
`aspect_ratio`Facultatif	`string`	`16:9`	16:9, 9:16, 1:1, 4:3, 3:4, 21:9	Output aspect ratio.
`resolution`Facultatif	`string`	`768p`	768p, 2k	Output resolution.
`duration_seconds`Facultatif	`integer`	`5`	de 4 à 15	Requested output length in seconds.
`enable_prompt_expansion`Facultatif	`boolean`	`false`	false	Accepted for compatibility only. This endpoint does not expand prompts, so the only allowed value is false.

Exemple de requête

Cette requête fonctionne telle quelle ; les champs omis gardent leur valeur par défaut. Placez d’abord votre clé dans POPNOW_API_KEY.

L’exemple utilise des fichiers d’exemple PopNow dans reference_image_urls. Remplacez-les par vos propres liens HTTPS publics, fichiers envoyés ou ressources enregistrées.

POST /api/v1/jobs/createTask

curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "minimax/h3/reference-to-video",
  "input": {
    "prompt": "The man from the reference image jogs across a sunlit rooftop at golden hour and smiles at the camera; smooth tracking shot",
    "reference_image_urls": [
      "https://media.popnow.ai/influencer/examples/ava.webp"
    ],
    "duration_seconds": 5,
    "resolution": "768p"
  }
}'

La réponse contient tout de suite un taskId. Récupérez le résultat avec GET /api/v1/jobs/recordInfo, ou ajoutez callBackUrl pour être prévenu.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Prolonger une vidéo

minimax/h3/video-extend

Prix

Option	Crédits (par seconde produite)	Dollars US
`768p`	5.55	$0.0555
`2k`	8.7	$0.087

Paramètres

Champ	Type	Valeur par défaut	Valeurs admises	Rôle
`prompt`Obligatoire	`string`	—	jusqu’à 7 000 caractères	Describe what happens next: the action that follows, the camera move and the sound.
`video_url`Obligatoire	`string (uri)`	—	—	The clip to continue: MP4, MOV or WebM, up to 60 seconds. Its last frame opens the new segment, and the result is your clip with the new segment joined on.
`last_image_url`Facultatif	`string (uri)`	—	—	Optional target end frame: the new segment closes on this image.
`resolution`Facultatif	`string`	`768p`	768p, 2k	Resolution of the new segment. It sets how sharp the new part is generated; match your source clip.
`duration_seconds`Facultatif	`integer`	`5`	de 4 à 15	Length of the new segment in seconds, from 4 to 15. The source clip is added on top and is not billed.
`enable_prompt_expansion`Facultatif	`boolean`	`false`	false	Accepted for compatibility only. This endpoint does not expand prompts, so the only allowed value is false.

Exemple de requête

Cette requête fonctionne telle quelle ; les champs omis gardent leur valeur par défaut. Placez d’abord votre clé dans POPNOW_API_KEY.

L’exemple utilise des fichiers d’exemple PopNow dans video_url. Remplacez-les par vos propres liens HTTPS publics, fichiers envoyés ou ressources enregistrées.

POST /api/v1/jobs/createTask

curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "minimax/h3/video-extend",
  "input": {
    "prompt": "The flowers keep opening while the camera slowly pulls back to reveal a sunlit meadow",
    "video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
    "duration_seconds": 5,
    "resolution": "768p"
  }
}'

La réponse contient tout de suite un taskId. Récupérez le résultat avec GET /api/v1/jobs/recordInfo, ou ajoutez callBackUrl pour être prévenu.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Référence API de MiniMax H3

En bref

Créer une vidéo

Prix

Paramètres

Exemple de requête

Image vers vidéo

Prix

Paramètres

Exemple de requête

Références vers vidéo

Prix

Paramètres

Exemple de requête

Prolonger une vidéo

Prix

Paramètres

Exemple de requête

Pour aller plus loin

Sur cette page