Skip to main content
POST
cURL
Use este endpoint para aplicar uma das cenas de efeito predefinidas do Kling e transformar os recursos de entrada em um novo vídeo curto.

Escolha uma cena de efeito

  • Efeitos de imagem única usam effect_scene mais input.image e input.duration
  • Efeitos de interação entre duas pessoas usam effect_scene mais input.images com exatamente duas imagens
  • As imagens de entrada devem atender aos requisitos de pixels do Kling; miniaturas muito pequenas são rejeitadas pela tarefa de geração
  • O formato exato do recurso depende do efeito selecionado, mas a requisição sempre envolve as configurações do efeito dentro de input
  • Use uma cena de efeito que esteja disponível no Kling; a CometAPI rejeita valores desconhecidos de effect_scene
  • Evite depender de uma lista enum pública fixa; a disponibilidade de efeitos muda conforme a trilha do modelo e a família da cena

Fluxo da tarefa

1

Enviar a solicitação de efeito

Envie effect_scene mais o objeto input correspondente e armazene o id da tarefa retornado.
2

Consultar a tarefa

Continue com Obter uma tarefa do Kling até que o trabalho de efeito seja concluído.
3

Persistir o recurso final

Faça o download ou espelhe o vídeo de efeito concluído se precisar de retenção estável.
Para a referência completa de parâmetros, consulte a documentação oficial do Kling.

Autorizações

Authorization
string
header
obrigatório

Bearer token authentication. Use your CometAPI key.

Corpo

application/json
effect_scene
string
obrigatório

Kling preset effect scene. Single-image effects use input.image; two-person interaction effects use input.images with exactly two images.

input
Single-image effect input · object
obrigatório

Effect-specific input payload. Single-image scenes require image and duration; two-person interaction scenes require exactly two images and duration.

callback_url
string

Webhook URL for task status notifications. The server sends a callback when the task status changes.

external_task_id
string

Optional user-defined task ID for your own tracking. Does not replace the system-generated task ID. Must be unique per account.

Resposta

200 - application/json

Task accepted.

code
integer
obrigatório

Error code; specific error code definition

message
string
obrigatório

Error message

data
object
obrigatório