Ce guide n'est disponible qu'en anglais pour le moment. →
Paramètres de requête
| Paramètre | Requis | Description |
|---|---|---|
audio_url | Oui | La voix ou la musique à utiliser. |
image_url | Oui | L’image de départ. |
mask_url | Non | Peignez la zone qui doit changer. |
prompt | Non | Optional note on expression or mood, such as calm or cheerful. Identity and setting come from the portrait. |
seed | Non | Le même nombre donne un résultat reproductible. ≥ 0 · ≤ 2147483647 |
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.
| Option | Crédits par seconde | ≈ USD |
|---|---|---|
| Standard | 2,7 | 0,027 $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 Talking Avatar 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- et utilisent les mêmes crédits que le site.
- Envoyer la requête. Envoyez POST /jobs/createTask avec model popnow/talking-avatar-v1/talking-avatar 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": "popnow/talking-avatar-v1/talking-avatar",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"audio_url": "https://media.popnow.ai/shortfilm/voices/Aoede-46e4c427.mp3"
}
}'
# 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 Talking Avatar
Combien coûte l’API Talking Avatar ?
Talking Avatar coûte 2,7 crédits (0,027 $US) 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 Talking Avatar dans l’API ?
Indiquez popnow/talking-avatar-v1/talking-avatar pour Avatar parlant dans le champ model de POST /jobs/createTask.
Quelle durée peut faire la vidéo ?
Celle de l'audio : de 3 à 60 secondes. Découpez les scripts plus longs en plusieurs enregistrements et assemblez les clips ensuite.
Faut-il un prompt ?
Non. La bouche et la tête sont pilotées par l'audio. Un prompt court peut orienter un peu l'expression, calme ou enjouée par exemple, mais la personne et la scène viennent du portrait.
Et si la photo montre plusieurs personnes ?
Passez mask_url : une image noir et blanc de la même taille que le portrait, blanche sur la personne qui doit parler. Sans masque, l'outil choisit le visage lui-même, pas forcément celui que vous visiez.
Quelles sont les limites de l’API Talking Avatar ?
Longueur du prompt (caractères): 1,000; Taille maximale d’envoi: 90 MB. Les requêtes hors de ces limites sont refusées avant tout débit.
Puis-je essayer Talking Avatar sans écrire de code ?
Oui. Le Playground lance Talking Avatar avec vos crédits PopNow, sans clé API, et affiche le code correspondant à chaque génération.
