Aplicar efeitos de vídeo do Kling
Use a API de efeitos de vídeo do Kling via CometAPI para aplicar efeitos estilizados a vídeos com POST /kling/v1/videos/effects e controlar os parâmetros do efeito.
Escolha uma cena de efeito
- Efeitos de imagem única usam
effect_scenemaisinput.imageeinput.duration - Efeitos de interação entre duas pessoas usam
effect_scenemaisinput.imagescom 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
Enviar a solicitação de efeito
effect_scene mais o objeto input correspondente e armazene o id da tarefa retornado.Consultar a tarefa
Persistir o recurso final
Autorizações
Bearer token authentication. Use your CometAPI key.
Corpo
Kling preset effect scene. Single-image effects use input.image; two-person interaction effects use input.images with exactly two images.
Effect-specific input payload. Single-image scenes require image and duration; two-person interaction scenes require exactly two images and duration.
- Single-image effect input
- Two-person interaction effect input
Webhook URL for task status notifications. The server sends a callback when the task status changes.
Optional user-defined task ID for your own tracking. Does not replace the system-generated task ID. Must be unique per account.