À propos de daVinci-MagiHuman
daVinci-MagiHuman, un modèle ouvert de Sand.ai et SII-GAIR, génère l’image et la voix ensemble : mettez une réplique parlée entre guillemets et la personne à l’écran la dit. Il crée des clips de 5 à 10 secondes à partir d’un prompt ou d’une photo de départ, en 256p, 720p ou 1080p, en 16:9 ou 9:16.
Appelez-le avec le nom de modèle sand-ai/davinci-magihuman/text-to-video sur POST /jobs/createTask, à partir de 0,12 $US.
Ce guide n'est disponible qu'en anglais pour le moment. →
Paramètres de requête
| Paramètre | Requis | Description |
|---|---|---|
aspect_ratio | Non | La forme du cadre : large, carrée ou verticale. 16:9 · 9:16 · Par défaut: 16:9 |
duration_seconds | Non | La durée du clip. Facturée à la seconde. ≥ 5 · ≤ 10 · Par défaut: 5 |
prompt | Oui | What happens, and in quotes what the person says. The model speaks quoted lines itself. |
resolution | Non | Taille de sortie. Plus c’est grand, plus c’est net et plus c’est cher. 256p · 720p · 1080p · Par défaut: 720p |
seed | Non | Le même nombre donne un résultat reproductible. ≥ 0 · ≤ 2147483647 |
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é.
| Option | USD par seconde |
|---|---|
| resolution 256p | 0,024 $US |
| resolution 720p | 0,048 $US |
| resolution 1080p | 0,072 $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 daVinci-MagiHuman en trois étapes
- 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.
- Envoyer la requête. Envoyez POST /jobs/createTask avec model sand-ai/davinci-magihuman/text-to-video et un objet input conforme au tableau des paramètres. La réponse renvoie aussitôt un ID de tâche.
- 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": "sand-ai/davinci-magihuman/text-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"aspect_ratio": "16:9",
"resolution": "720p",
"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 daVinci-MagiHuman
Combien coûte l’API daVinci-MagiHuman ?
daVinci-MagiHuman coûte à partir de 0,12 $US pour un clip de 5 secondes avec Créer une vidéo, sa tâche la moins chère. Prix par option : 256p 0,024 $US par seconde, 720p 0,048 $US par seconde, 1080p 0,072 $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 daVinci-MagiHuman dans l’API ?
Indiquez sand-ai/davinci-magihuman/text-to-video pour Créer une vidéo; sand-ai/davinci-magihuman/image-to-video pour Image vers vidéo dans le champ model de POST /jobs/createTask.
Qu’est-ce que daVinci-MagiHuman ?
Un modèle de 15 milliards de paramètres de Sand.ai et SII-GAIR, publié avec des poids ouverts sous Apache 2.0 ; l’article a été publié le 2026-03-23. Il génère la vidéo et l’audio en un seul passage, si bien qu’une seule requête renvoie l’image et la bande sonore. Il est conçu pour les personnes qui parlent ou chantent face caméra, et gère aussi des scènes générales.
Quelles langues la personne peut-elle parler ?
L’éditeur liste le chinois (mandarin et cantonais), l’anglais, le japonais, le coréen, l’allemand et le français. Nous avons testé l’anglais : vérifiez donc un premier essai dans toute autre langue.
Comment faire dire quelque chose à la personne ?
Placez la réplique entre guillemets dans le prompt. Le modèle prononce lui-même les répliques entre guillemets. Lors de nos trois essais avec une réplique entre guillemets, la transcription de la bande sonore correspondait mot pour mot au prompt.
Quelles sont la durée et la taille des clips ?
De 5 à 10 secondes (par défaut 5), en 256p, 720p (par défaut) ou 1080p, en 16:9 ou 9:16. Le modèle génère à basse résolution de base, et son propre étage de super-résolution produit les niveaux supérieurs. Dans nos essais, le 720p en 16:9 est revenu à environ 1358 x 678, le 720p en 9:16 à environ 726 x 1270 et le 1080p en 16:9 à environ 1904 x 1088, le tout à 25 fps.
La même seed donne-t-elle le même clip ?
Une seed fixe avec les mêmes entrées donne des résultats similaires, et non garantis identiques. Utilisez-la pour comparer les essais pendant que vous ne changez qu’une chose à la fois.
Quelles sont les limites de l’API daVinci-MagiHuman ?
Durée du clip: 5–10 s; Résolutions: 256p · 720p · 1080p; Formats d’image: 16:9 · 9:16; Longueur du prompt (caractères): 5,000. Les requêtes hors de ces limites sont refusées avant tout débit.
Puis-je essayer daVinci-MagiHuman sans écrire de code ?
Exécutez daVinci-MagiHuman 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.