Introduction
daVinci-MagiHuman Texte vers vidéo transforme un prompt écrit en court clip avec une voix. daVinci-MagiHuman est un modèle ouvert de 15 milliards de paramètres de Sand.ai et SII-GAIR qui génère l’image et la bande sonore ensemble. Placez la réplique que doit dire la personne entre guillemets, et le modèle la prononce. Ce point de terminaison renvoie de 5 à 10 secondes en 256p, 720p ou 1080p, en 16:9 ou 9:16. Vous pouvez aussi envoyer votre propre fichier de parole ou de chanson en audio_url.
Choisir un mode selon le point de départ
| Ce que vous avez | Mode |
|---|---|
| une description écrite | daVinci-MagiHuman Texte vers vidéo |
| une photo de départ, avec ou sans votre propre audio | daVinci-MagiHuman Image vers vidéo |
Fonctionnalités et points forts
L’image et la voix à partir d’un seul prompt
Une requête renvoie la vidéo et sa bande sonore. Décrivez qui est dans le cadre, ce que fait la personne et, entre guillemets, ce qu’elle dit. Vous ne choisissez pas de voix et n’enchaînez pas une seconde étape.
Ce que nous avons mesuré
Nous avons lancé deux clips en texte vers vidéo. Le premier, en 1080p et 16:9, est revenu à environ 1904 x 1088, 25 fps, 5,0 secondes, avec son, après environ 3 min 53 s de traitement. Le second, en 720p et 9:16, à environ 726 x 1270, 5,0 secondes, après environ une minute. Nous avons transcrit la bande sonore des deux, et chacune correspondait mot pour mot à la réplique entre guillemets du prompt. Le 720p en 16:9 n’est pas exactement 1280 x 720 (un essai en image vers vidéo a donné environ 1358 x 678), donc traitez les dimensions comme approximatives.
Trois résolutions, deux formats
resolution vaut 256p, 720p (par défaut) ou 1080p. Le modèle génère à basse résolution, et son propre étage de super-résolution produit les niveaux supérieurs. aspect_ratio vaut 16:9 (par défaut) ou 9:16. Les niveaux supérieurs coûtent davantage à la seconde ; le format ne change pas le prix.
Votre propre audio
audio_url est facultatif. Avec un fichier de parole ou de chanson joint, la vidéo est générée en synchronisation avec lui au lieu d’inventer une voix. Nous l’avons utilisé en image vers vidéo, pas sur ce point de terminaison.
Langues
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.
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
prompt | Oui | Décrivez qui est dans le cadre, où, ce que la personne fait et la manière dont la caméra la filme. Placez la réplique entre guillemets : le modèle la prononce. 3 caractères minimum · 5000 caractères maximum |
audio_url | Non | Facultatif. Lien public vers un fichier de parole ou de chanson ; la vidéo est générée en synchronisation avec lui au lieu d’inventer une voix. |
aspect_ratio | Non | 16:9 pour le paysage (par défaut) ou 9:16 pour le portrait. Le format ne change pas le prix. |
resolution | Non | 256p, 720p (par défaut) ou 1080p. Les niveaux supérieurs coûtent davantage à la seconde. |
duration_seconds | Non | De 5 à 10 secondes, 5 par défaut, facturées à la seconde. |
seed | Non | Entier facultatif. La même seed avec les mêmes entrées donne des résultats similaires, et non garantis identiques. |
Tarification
Facturé à la seconde de la durée demandée ; le prix à la seconde dépend de la résolution, tandis que le son et le ratio d’image ne le modifient pas. Les requêtes en échec ne sont pas facturées.
| Spécification | Prix |
|---|---|
| $0.024 / seconde |
| $0.048 / seconde |
| $0.072 / seconde |
Cas d’utilisation
Courts clips parlés
Un salut, une introduction ou une bande-annonce : une personne, une réplique, de 5 à 10 secondes, avec la voix générée pour vous.
Clips verticaux
Réglez aspect_ratio sur 9:16 pour les écrans de téléphone. Notre essai en portrait en 720p est revenu à environ 726 x 1270.
Brouillons de dialogue
Testez une réplique, un visage et un décor ensemble avant de planifier une pièce plus longue.
Guide de prompt et conseils pratiques
Placez la réplique entre guillemets
Dites qui parle et comment, puis la réplique : says softly: "...". Nos répliques comptaient de 8 à 10 mots pour un clip de 5 secondes.
Décrivez le cadrage, pas un appareil
Lors d’un essai supplémentaire en 9:16, demander un selfie avec un téléphone a placé dans le cadre un téléphone orienté vers la caméra depuis l’arrière. Écrivez « looks straight into the camera » et une taille de plan comme « vertical medium close-up ».
Ordonnez le prompt
La personne et le lieu d’abord, puis l’action et la réplique, puis la lumière et la caméra : Warm practical light, shallow depth of field, ou Handheld, eye level.
Écoutez le premier essai
La parole est générée : lisez le clip et comparez-le à votre réplique avant de construire dessus. Utilisez seed pour garder les entrées stables pendant que vous changez une chose, en sachant que le résultat est similaire et non garanti identique.
Choisir entre les modèles
Si vous avez déjà l’enregistrement vocal et un portrait et voulez un clip plus long, jusqu’à 300 secondes, piloté par cet audio, utilisez OmniHuman 2.0 ; Kling Avatar 2.0 repose sur la même idée. Choisissez daVinci-MagiHuman quand vous voulez que le modèle prononce une réplique que vous écrivez, ou quand vous avez besoin d’un clip en 9:16.
Démarrage rapide de l’API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "sand-ai/davinci-magihuman/text-to-video",
"input": {
"aspect_ratio": "16:9",
"duration_seconds": 5,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
La référence API détaille l’authentification, le schéma complet, le polling et la gestion des erreurs.


