Skip to main content
POST
cURL
Verwenden Sie diesen Endpunkt, um sprechende Avatar-Clips aus einem Quellbild und einer Audioquelle zu erstellen.

Bevor Sie ihn aufrufen

  • Stellen Sie ein Avatar-image als öffentliche URL oder als rohe base64-Zeichenfolge bereit
  • Verwenden Sie ein Avatar-Bild, das die Pixelanforderungen von Kling erfüllt; winzige Vorschaubilder werden von der Generierungsaufgabe abgelehnt
  • Senden Sie genau eines von audio_id oder sound_file
  • Halten Sie die erste Anfrage einfach: ein Gesichtsbild, ein Audioclip und ein kurzer optionaler Prompt
  • Geben Sie task_id an, wenn das referenzierte Audio zu einer vorherigen Aufgabe gehört, die verknüpft werden muss
  • Beginnen Sie mit mode: std, es sei denn, Sie benötigen ausdrücklich den Pfad mit höherer Qualität

Regeln für die Audioquelle

  • audio_id ist der einfachste Weg, wenn Sie Sprache bereits über die Kling-TTS-Route erzeugt haben
  • sound_file funktioniert, wenn Sie bereits Ihre eigene MP3-, WAV-, M4A- oder AAC-Datei haben
  • Avatar-Audio ist mit einer Länge von 2 bis 60 Sekunden dokumentiert

Aufgabenablauf

1

Die Avatar-Aufgabe erstellen

Übermitteln Sie das Bild und eine Audioquelle und speichern Sie dann die zurückgegebene Aufgaben-ID.
2

Die Aufgabe abfragen

Fahren Sie mit Eine Kling-Aufgabe abrufen fort, bis die Aufgabe einen terminalen Zustand erreicht.
3

Das fertige Ergebnis speichern

Kopieren Sie das endgültige Asset in Ihren eigenen Speicher, wenn Sie es über die vom Anbieter bereitgestellte URL hinaus aufbewahren müssen.
Die vollständige Parameterreferenz finden Sie in der offiziellen Kling Avatar-Dokumentation.

Autorisierungen

Authorization
string
header
erforderlich

Bearer token authentication. Use your CometAPI key.

Header

Content-Type
string

Optional content type header.

Body

application/json
image
string
erforderlich

Avatar image URL or base64 image string. Use an image that meets Kling pixel requirements; very small thumbnails are rejected.

prompt
string
erforderlich

Prompt describing the desired avatar performance.

audio_id
string
erforderlich

Audio id from a prior Kling audio task.

sound_file
string

Public audio URL when you provide your own audio.

task_id
string

Optional prior task id associated with the referenced audio asset.

mode
enum<string>

Generation mode. Use std or pro; omitted requests use std.

Verfügbare Optionen:
std,
pro

Antwort

200 - application/json

Task accepted.

code
integer
erforderlich
message
string
erforderlich
data
object
erforderlich