Talking Avatar API-Referenz

Mit einem einzigen PopNow-API-Schlüssel rufst du Talking Avatar aus deinem eigenen Code auf. Hier findest du die Modell-IDs, jedes Eingabefeld, die Kosten pro Anfrage in Credits und eine Anfrage, die du direkt ins Terminal kopieren kannst.

Die Parameterbeschreibungen stammen aus dem Eingabeschema des Modells und sind nur auf Englisch verfügbar.

Auf einen Blick

Hersteller: PopNow
Ergebnis: Video
Ab: 2.7 Credits pro Sekunde Ergebnis ($0.027)
Modell-IDs: popnow/talking-avatar-v1/talking-avatar

1 Credit = 0,01 $. Bei Annahme reserviert ein Task den höchstmöglichen Betrag und rechnet am Ende den tatsächlichen Verbrauch ab, auf ganze Credits aufgerundet; der Rest wird freigegeben. Fehlgeschlagene Tasks kosten nichts. Den genauen Betrag vorab liefert POST /api/v1/jobs/quote.

Sprechender Avatar

popnow/talking-avatar-v1/talking-avatar

Preis

Option	Credits (pro Sekunde Ergebnis)	US-Dollar
`Standard`	2.7	$0.027

Parameter

Feld	Typ	Standardwert	Erlaubt	Bedeutung
`image_url`Pflicht	`string`	—	—	Portrait of the person who will speak. One clearly visible face, looking roughly at the camera, works best.
`audio_url`Pflicht	`string`	—	—	Speech that drives the lips, 3 to 60 seconds, MP3 or WAV. The video runs as long as this audio; files outside that range are rejected before any charge.
`prompt`Optional	`string`	—	bis zu 1.000 Zeichen	Optional note on expression or mood, such as calm or cheerful. Identity and setting come from the portrait.
`mask_url`Optional	`string`	—	—	Optional black-and-white mask the same size as the portrait, white over the person who should speak. Only needed when the portrait shows several people.
`seed`Optional	`integer`	—	0 bis 2147483647	Random seed for controlled comparisons.

Beispielanfrage

Diese Anfrage läuft so, wie sie ist; weggelassene Felder behalten ihren Standardwert. Leg deinen Schlüssel vorher in POPNOW_API_KEY ab.

Das Beispiel nutzt in audio_url, image_url Beispieldateien von PopNow. Ersetze sie durch eigene öffentliche HTTPS-Links, Uploads oder gespeicherte Assets.

POST /api/v1/jobs/createTask

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: $(uuidgen)" \
  -d '{
  "model": "popnow/talking-avatar-v1/talking-avatar",
  "input": {
    "prompt": "Speaks warmly to the camera with natural head movement and a relaxed smile",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "audio_url": "https://media.popnow.ai/shortfilm/voices/Aoede-46e4c427.mp3"
  }
}'

Die Antwort enthält sofort eine taskId. Das Ergebnis holst du mit GET /api/v1/jobs/recordInfo ab – oder du gibst callBackUrl mit und wirst benachrichtigt.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"