PopNow APIpopnow.ai
API-Schlüssel holen

Talking Avatar API

von PopNow

Lippensynchrones Sprechvideo aus Porträt und Stimme

popnow/talking-avatar-v1/talking-avatarAb 2,7 Creditspro Sekunde · 0,027 $
Im Playground testenAPI-Schlüssel holen
  • Sprechender Avatar

Über Talking Avatar

Aus einem Porträt und einer Sprachaufnahme wird ein Video, in dem genau diese Person den Text spricht. Lippen, Kopf und Mimik folgen dem Ton, und der Clip ist exakt so lang wie die Aufnahme.

Du rufst es mit dem Modellnamen popnow/talking-avatar-v1/talking-avatar über POST /jobs/createTask auf, ab 2,7 Credits pro Sekunde (0,027 $). Neue Konten bekommen 30 kostenlose Credits, damit du es zuerst im Playground testen kannst.

Diese Anleitung gibt es vorerst nur auf Englisch. →

Anfrageparameter

ParameterPflichtBeschreibung
audio_urlJaDie Stimme oder Musik, die verwendet wird.
image_urlJaDas Bild, von dem aus es losgeht.
mask_urlNeinÜbermale den Bereich, der sich ändern soll.
promptNeinOptional note on expression or mood, such as calm or cheerful. Identity and setting come from the portrait.
seedNeinDieselbe Zahl liefert ein wiederholbares Ergebnis. ≥ 0 · ≤ 2147483647

Preise

Die Preise sind in Credits angegeben, denselben Credits, die du auf der Website nutzt (1 Credit = 0,01 $). Beim Annehmen der Aufgabe wird der Betrag reserviert und nach Abschluss auf die tatsächlichen Kosten abgerechnet; fehlgeschlagene Aufgaben werden erstattet.

OptionCredits pro Sekunde≈ USD
Standard2,70,027 $

Für eine exakte Zahl vor dem Start sendest du denselben Body an POST /jobs/quote.

API-Schnellstart

Die Talking Avatar API in drei Schritten aufrufen

  1. API-Schlüssel erstellen. Melde dich bei PopNow an und erstelle in der API-Konsole einen Schlüssel. Schlüssel beginnen mit sk-popnow- und nutzen dieselben Credits wie die Website.
  2. Anfrage senden. Sende POST /jobs/createTask mit model popnow/talking-avatar-v1/talking-avatar und einem input-Objekt nach der Parametertabelle. Die Antwort enthält sofort eine Task-ID.
  3. Ergebnis abholen. Frage GET /jobs/recordInfo mit der Task-ID ab oder gib eine callBackUrl mit, dann schicken wir das Ergebnis dorthin. Lade die Ausgabelinks herunter, sobald die Aufgabe erfolgreich ist.
# 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"

Ersetze den Prompt und alle Links durch deine eigenen. Im Tab „API“ findest du die Referenz zu Antwort, Polling und Callback.

Fragen zur Talking Avatar API

Was kostet die Talking Avatar API?

Talking Avatar kostet 2,7 Credits (0,027 $) pro Sekunde. Die Credits sind dieselben wie auf der Website (1 Credit = 0,01 $), neue Konten bekommen 30 Gratis-Credits, und fehlgeschlagene Tasks werden erstattet.

Wie lautet der Modellname von Talking Avatar in der API?

Trag popnow/talking-avatar-v1/talking-avatar für Sprechender Avatar im Feld model von POST /jobs/createTask ein.

Wie lang kann das Video werden?

So lang wie das Audio: 3 bis 60 Sekunden. Längere Skripte teilen Sie in mehrere Aufnahmen und fügen die Clips danach zusammen.

Braucht es einen Prompt?

Nein. Mund und Kopf werden vom Audio gesteuert. Ein kurzer Prompt kann die Mimik etwas lenken, etwa ruhig oder fröhlich; Person und Szene kommen aber aus dem Porträt.

Was, wenn mehrere Personen im Bild sind?

Übergeben Sie mask_url: ein Schwarz-Weiß-Bild in derselben Größe wie das Porträt, weiß über der Person, die sprechen soll. Ohne Maske wählt das Werkzeug das Gesicht selbst, und das ist nicht unbedingt das gemeinte.

Welche Limits hat die Talking Avatar API?

Prompt-Länge (Zeichen): 1,000; Größter Upload: 90 MB. Anfragen außerhalb dieser Grenzen werden abgelehnt, bevor etwas abgebucht wird.

Kann ich Talking Avatar testen, ohne Code zu schreiben?

Ja. Der Playground führt Talking Avatar mit deinen PopNow-Credits aus, braucht keinen API-Schlüssel und zeigt dir zu jedem Lauf den passenden Code.

Mehr zu Talking Avatar