Skip to main content
POST
cURL
Usa este endpoint para aplicar una de las escenas de efectos predefinidas de Kling y convertir los recursos de entrada en un nuevo video corto.

Elegir una escena de efecto

  • Los efectos de una sola imagen usan effect_scene junto con input.image e input.duration
  • Los efectos de interacción entre dos personas usan effect_scene junto con input.images con exactamente dos imágenes
  • Las imágenes de entrada deben cumplir con los requisitos de píxeles de Kling; las miniaturas muy pequeñas son rechazadas por la tarea de generación
  • La estructura exacta del recurso depende del efecto seleccionado, pero la solicitud siempre agrupa la configuración del efecto dentro de input
  • Usa una escena de efecto que esté disponible en Kling; CometAPI rechaza valores de effect_scene desconocidos
  • Evita depender de una lista enum pública fija; la disponibilidad de efectos cambia según la línea del modelo y la familia de escenas

Flujo de la tarea

1

Enviar la solicitud de efecto

Envía effect_scene junto con el objeto input correspondiente y guarda el id de tarea devuelto.
2

Consultar la tarea

Continúa con Obtener una tarea de Kling hasta que el trabajo del efecto termine.
3

Conservar el recurso final

Descarga o replica el video de efecto terminado si necesitas una retención estable.
Para la referencia completa de parámetros, consulta la documentación oficial de Kling.

Autorizaciones

Authorization
string
header
requerido

Bearer token authentication. Use your CometAPI key.

Cuerpo

application/json
effect_scene
string
requerido

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
requerido

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.

Respuesta

200 - application/json

Task accepted.

code
integer
requerido

Error code; specific error code definition

message
string
requerido

Error message

data
object
requerido