Skip to main content
POST
cURL
Use este endpoint para criar clipes de avatar falante a partir de uma imagem de origem e uma fonte de áudio.

Antes de chamá-lo

  • Forneça uma image de avatar como URL pública ou string base64 bruta
  • Use uma imagem de avatar que atenda aos requisitos de pixels da Kling; miniaturas muito pequenas são rejeitadas pela tarefa de geração
  • Envie exatamente um de audio_id ou sound_file
  • Mantenha a primeira solicitação simples: uma imagem de rosto, um clipe de áudio e um prompt opcional curto
  • Inclua task_id quando o áudio referenciado pertencer a uma tarefa anterior que precise ser vinculada
  • Comece com mode: std, a menos que você precise especificamente do caminho de maior qualidade

Regras da fonte de áudio

  • audio_id é o caminho mais fácil quando você já gerou fala pela rota Kling TTS
  • sound_file funciona quando você já tem seu próprio arquivo MP3, WAV, M4A ou AAC
  • A documentação do áudio de avatar informa duração de 2 a 60 segundos

Fluxo da tarefa

1

Criar a tarefa de avatar

Envie a imagem e uma fonte de áudio, depois salve o id da tarefa retornado.
2

Consultar a tarefa

Continue com Obter uma tarefa Kling até que a tarefa atinja um estado terminal.
3

Armazenar o resultado final

Copie o recurso final para o seu próprio armazenamento se precisar mantê-lo além da URL de entrega do provedor.
Para a referência completa dos parâmetros, consulte a documentação oficial do Kling Avatar.

Autorizações

Authorization
string
header
obrigatório

Bearer token authentication. Use your CometAPI key.

Cabeçalhos

Content-Type
string

Optional content type header.

Corpo

application/json
image
string
obrigatório

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

prompt
string
obrigatório

Prompt describing the desired avatar performance.

audio_id
string
obrigatório

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.

Opções disponíveis:
std,
pro

Resposta

200 - application/json

Task accepted.

code
integer
obrigatório
message
string
obrigatório
data
object
obrigatório