Obtenir une clé API

par MiniMax

Clips expressifs avec son, jusqu’en 2K

minimax/h3/text-to-videoÀ partir de 28 créditspour un clip de 5 secondes · 0,28 $US
  • Jusqu’à 2K
  • Clips de 4 à 15 s
  • Image de début et de fin
  • Jusqu’à 9 images de référence
  • 6 formats d’image
  • Créer une vidéo
  • Image vers vidéo
  • Références vers vidéo
  • Prolonger une vidéo
Voir les exemples

À propos de MiniMax H3

MiniMax H3 transforme une phrase, une image fixe ou quelques photos de référence en une vidéo sonore de 4 à 15 secondes, jusqu’en 2K.

Appelez-le avec le nom de modèle minimax/h3/text-to-video sur POST /jobs/createTask, à partir de 28 crédits pour un clip de 5 secondes (0,28 $US). Les nouveaux comptes reçoivent 30 crédits gratuits pour l’essayer d’abord dans le Playground.

Ce guide n'est disponible qu'en anglais pour le moment. →

Paramètres de requête

ParamètreRequisDescription
promptOuiDescribe the picture, the action, the camera, the sound, and the boundaries for the shot.
resolutionNonTaille de sortie. Plus c’est grand, plus c’est net et plus c’est cher. 768p · 2k · Par défaut: 768p
aspect_ratioNonLa forme du cadre : large, carrée ou verticale. 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 · Par défaut: 16:9
duration_secondsNonLa durée du clip. Facturée à la seconde. ≥ 5 · ≤ 15 · Par défaut: 5
enable_prompt_expansionNonLaisse le modèle enrichir un prompt court. false · Par défaut: false

Tarifs

Les prix sont en crédits, les mêmes que ceux que vous utilisez sur le site (1 crédit = 0,01 $). Le montant est réservé à l'acceptation de la tâche, puis réglé au coût réel à la fin ; les tâches en échec sont remboursées.

OptionCrédits par seconde≈ USD
resolution 768p5,550,056 $US
resolution 2K8,70,087 $US

Chaque tâche est arrondie au crédit entier supérieur : une exécution au palier le plus bas coûte donc 28 crédits pour un clip de 5 secondes (0,28 $US).

Pour obtenir un montant exact avant de lancer, envoyez le même corps à POST /jobs/quote.

Démarrage rapide de l'API

Appeler l’API MiniMax H3 en trois étapes

  1. Créer une clé API. Connectez-vous à PopNow et créez une clé dans la console API. Les clés commencent par sk-popnow- et utilisent les mêmes crédits que le site.
  2. Envoyer la requête. Envoyez POST /jobs/createTask avec model minimax/h3/text-to-video et un objet input conforme au tableau des paramètres. La réponse renvoie aussitôt un ID de tâche.
  3. Récupérer le résultat. Interrogez GET /jobs/recordInfo avec l’ID de tâche, ou passez une callBackUrl et nous y envoyons le résultat. Téléchargez les liens de sortie quand la tâche réussit.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
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: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "minimax/h3/text-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "aspect_ratio": "16:9",
    "resolution": "768p",
    "duration_seconds": 5
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Remplacez le prompt et les liens par les vôtres. L'onglet API contient la référence pour la réponse, le polling et le callback.

Questions sur l’API MiniMax H3

Combien coûte l’API MiniMax H3 ?

MiniMax H3 coûte à partir de 28 crédits (0,28 $US) pour un clip de 5 secondes avec Créer une vidéo, sa tâche la moins chère. Prix par option : 768p 5,55 crédits par seconde, 2K 8,7 crédits par seconde. Les crédits sont les mêmes que sur le site (1 crédit = 0,01 $), les nouveaux comptes reçoivent 30 crédits offerts et les tâches échouées sont remboursées.

Quel est le nom de modèle de MiniMax H3 dans l’API ?

Indiquez minimax/h3/text-to-video pour Créer une vidéo; minimax/h3/image-to-video pour Image vers vidéo; minimax/h3/reference-to-video pour Références vers vidéo; minimax/h3/video-extend pour Prolonger une vidéo dans le champ model de POST /jobs/createTask.

Quelle durée peut avoir une vidéo MiniMax H3 ?

Jusqu’à 15 secondes par clip. Pour une scène plus longue, gardez la dernière image d’un clip réussi et utilisez-la comme image de départ du suivant : tenue, décor et lumière se conservent.

MiniMax H3 génère-t-il du son ?

Oui. Ambiance, bruits de pas, musique et répliques sortent dans le même fichier que l’image. Décrivez le son voulu dans le prompt, comme vous décrivez le plan.

Comment garder le même personnage dans chaque clip ?

Utilisez la référence vers vidéo. Donnez-lui jusqu’à neuf photos, chacune avec un rôle (visage, tenue, pièce), et appelez-les Picture 1, Picture 2 dans le prompt. Trois ou quatre photos nettes tiennent un visage mieux que neuf qui se recoupent.

Suis-je facturé quand une génération échoue ?

Non. Si une génération échoue, le montant réservé pour elle revient aussitôt sur votre solde.

Quelles sont les limites de l’API MiniMax H3 ?

Durée du clip: 5–15 s; Résolutions: 768p · 2K; Formats d’image: 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9; Longueur du prompt (caractères): 7,000. Les requêtes hors de ces limites sont refusées avant tout débit.

Puis-je essayer MiniMax H3 sans écrire de code ?

Oui. Le Playground lance MiniMax H3 avec vos crédits PopNow, sans clé API, et affiche le code correspondant à chaque génération.

Tous les modèles MiniMax

MiniMax H3 Max est la variante de génération rapide, avec une dernière image en option mais sans mode référence ni 2K. H3 est le polyvalent.

En savoir plus sur MiniMax H3