PopNowAPI
Obtenir une clé API

par MiniMax

Changez la lumière, la météo ou le style d’un clip ; personnes et mouvements restent

minimax/h3-edit/video-edit
  • Jusqu’à 768p
  • Clips de 3 à 15 s
  • Son inclus
  • Jusqu’à 9 images de référence
  • 7 formats d’image
  • Modifier une vidéo

À propos de MiniMax H3 Edit

MiniMax H3 Edit modifie la lumière, la météo, le style ou le décor d’un clip que vous importez, tandis que vos images continuent de décider qui apparaît, du cadrage et du mouvement. Il retouche de 3 à 15 secondes en 480p, 540p ou 768p et ajoute par défaut une nouvelle bande sonore.

Appelez-le avec le nom de modèle minimax/h3-edit/video-edit sur POST /jobs/createTask, à partir de 0,15 $US.

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

Paramètres de requête

ParamètreRequisDescription
aspect_ratioNonLa forme du cadre : large, carrée ou verticale. 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 · 9:21
duration_secondsNonLa durée du clip. Facturée à la seconde. ≥ 3 · ≤ 15 · Par défaut: 5
generate_audioNonAjoute un son assorti à l’image : voix, ambiance et effets. Par défaut: true
promptOuiThe change to make: lighting, weather, style, setting or specific elements. Name references as <Picture 1> or <Audio 1>.
reference_audio_urlsNonUn son à reproduire : une voix, une musique ou un rythme.
reference_image_urlsNonDes images des personnes, tenues ou lieux que le résultat doit conserver.
resolutionNonTaille de sortie. Plus c’est grand, plus c’est net et plus c’est cher. 480p · 540p · 768p · Par défaut: 768p
seedNonLe même nombre donne un résultat reproductible. ≥ 0 · ≤ 2147483647
video_urlOuiLe clip à traiter.

Tarifs

Les prix sont en USD. L’API utilise un solde distinct en dollars américains. Les crédits du site ne peuvent pas être utilisés pour l’API ni convertis en solde API, et le solde API ne peut pas être converti en crédits du site. À l’acceptation d’une tâche, le montant maximal du devis est réservé sur votre solde API. À la fin, la facturation suit l’usage réel, sans dépasser ce montant, et le reste est libéré. En cas d’échec, le montant réservé est libéré.

OptionUSD par seconde
resolution 480p0,03 $US
resolution 540p0,045 $US
resolution 768p0,066 $US

Avant l’exécution, envoyez le même corps de requête à POST /jobs/quote pour connaître les frais estimés et leur plafond en USD. Le devis ne lance aucune tâche et ne débite pas votre solde.

Démarrage rapide de l'API

Appeler l’API MiniMax H3 Edit 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-. Les appels API utilisent votre solde distinct en dollars américains.
  2. Envoyer la requête. Envoyez POST /jobs/createTask avec model minimax/h3-edit/video-edit 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-edit/video-edit",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
    "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 Edit

Combien coûte l’API MiniMax H3 Edit ?

MiniMax H3 Edit coûte 0,15 $US pour un clip de 5 secondes. Prix par option : 480p 0,03 $US par seconde, 540p 0,045 $US par seconde, 768p 0,066 $US par seconde. L’API utilise un solde distinct en dollars américains. Les crédits du site ne peuvent pas être utilisés pour l’API ni convertis en solde API, et le solde API ne peut pas être converti en crédits du site. À l’acceptation d’une tâche, le montant maximal du devis est réservé sur votre solde API. À la fin, la facturation suit l’usage réel, sans dépasser ce montant, et le reste est libéré. En cas d’échec, le montant réservé est libéré.

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

Indiquez minimax/h3-edit/video-edit pour Modifier une vidéo dans le champ model de POST /jobs/createTask.

Comment modifier une vidéo avec l’IA en une seule phrase ?

Importez votre clip et écrivez la modification en une phrase, puis ce qui doit rester identique. Une requête renvoie une nouvelle version du plan avec la modification appliquée.

Les personnes et leur mouvement resteront-ils les mêmes ?

Votre clip détermine qui apparaît dans le plan, le cadrage et le mouvement : ils sont donc conservés. De petits changements peuvent tout de même apparaître lorsque le prompt décrit un mouvement. Décrivez donc la météo et la lumière, et laissez les actions à la source.

Et si je veux un nouveau clip au lieu d’en modifier un ?

Utilisez MiniMax H3 (/models/minimax-h3), qui part d’une scène écrite, d’une image d’ouverture ou d’images de référence. Choisissez l’édition lorsque vous avez déjà un clip et voulez qu’il change d’apparence.

Quelles sont les limites de l’API MiniMax H3 Edit ?

Durée du clip: 3–15 s; Résolutions: 480p · 540p · 768p; Formats d’image: 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9 · 9:21; Audio de référence: 3; Images de référence: 9. Les requêtes hors de ces limites sont refusées avant tout débit.

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

Exécutez MiniMax H3 Edit dans le Playground avec votre solde API en USD, sans clé API. Chaque exécution figure dans votre historique développeur avec le code correspondant.

Tous les modèles MiniMax

Kling O3 modifie aussi les clips et va jusqu’en 4K. H3 Edit est le choix plus rapide et moins cher pour les changements de style et de météo.

En savoir plus sur MiniMax H3 Edit