Skip to main content
POST
cURL
Usa questo endpoint per creare clip con avatar parlanti a partire da un’immagine sorgente e una sorgente audio.

Prima di chiamarlo

  • Fornisci un image avatar come URL pubblico o stringa base64 grezza
  • Usa un’immagine avatar che soddisfi i requisiti in pixel di Kling; le miniature troppo piccole vengono rifiutate dal task di generazione
  • Invia esattamente uno tra audio_id o sound_file
  • Mantieni semplice la prima richiesta: un’immagine del volto, una clip audio e un prompt opzionale breve
  • Includi task_id quando l’audio di riferimento appartiene a un task precedente che deve essere collegato
  • Inizia con mode: std a meno che tu non abbia bisogno specificamente del percorso di qualità superiore

Regole per la sorgente audio

  • audio_id è il percorso più semplice quando hai già generato il parlato tramite il percorso Kling TTS
  • sound_file funziona quando hai già una tua risorsa MP3, WAV, M4A o AAC
  • La documentazione indica che l’audio dell’avatar deve avere una durata compresa tra 2 e 60 secondi

Flusso del task

1

Crea il task avatar

Invia l’immagine e una sorgente audio, quindi salva il task id restituito.
2

Interroga il task

Continua con Ottenere un task Kling finché il task non raggiunge uno stato terminale.
3

Archivia il risultato finale

Copia la risorsa finale nel tuo storage se hai bisogno di conservarla oltre l’URL di consegna del provider.
Per il riferimento completo dei parametri, consulta la documentazione ufficiale di Kling Avatar.

Autorizzazioni

Authorization
string
header
obbligatorio

Bearer token authentication. Use your CometAPI key.

Intestazioni

Content-Type
string

Optional content type header.

Corpo

application/json
image
string
obbligatorio

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

prompt
string
obbligatorio

Prompt describing the desired avatar performance.

audio_id
string
obbligatorio

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.

Opzioni disponibili:
std,
pro

Risposta

200 - application/json

Task accepted.

code
integer
obbligatorio
message
string
obbligatorio
data
object
obbligatorio