Crear tarea

Crea una tarea de edición de video multimodal de Kling a través de CometAPI: POST /kling/v1/videos/multi-elements para combinar múltiples elementos y generar videos de forma asíncrona.

POST /kling/v1/videos/multi-elements

Create a Kling multimodal edit task

cURL

curl --request POST \
  --url https://api.cometapi.com/kling/v1/videos/multi-elements \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "session_id": "784914037360041984",
  "edit_mode": "replace",
  "prompt": "Replace the selected object with a red paper boat."
}
'

200

{
  "code": 123,
  "message": "<string>",
  "data": {
    "task_id": "<string>",
    "task_status": "<string>",
    "created_at": 123,
    "updated_at": 123
  }
}

Usa este endpoint para enviar el trabajo final de edición de video multimodal una vez que tu sesión y selecciones estén listas.

​

Flujo completo

1. Inicializar la sesión de edición

   Comienza con Initialize Video for Editing para obtener el session_id del clip que quieres editar.

2. Construir el área de selección

   Usa Add Video Selection y, cuando sea necesario, Preview Selected Video Area para ajustar la región de edición.

3. Enviar la tarea final

   Envía el session_id, edit_mode y el prompt final a través de este endpoint, y luego guarda el id de tarea devuelto para consultar el estado.

​

Antes de llamarlo

• Asegúrate de que la sesión de selección ya esté inicializada
• Confirma que la selección de región sea correcta antes de consumir una llamada de generación
• Trata esta ruta como el paso final de generación, no como el paso de configuración

Para la referencia completa de parámetros, consulta la documentación de la API de Kling.

Autorizaciones

Authorization · string · header · requerido

Bearer token authentication. Use your CometAPI key.

Cuerpo

application/json

session_id · string · predeterminado: 784914037360041984 · requerido

Session id returned by the video initialization endpoint.

edit_mode · string · predeterminado: replace · requerido

Editing operation to apply. Options: replace, remove.

prompt · string · predeterminado: Replace the selected object with a red paper boat. · requerido

Text prompt describing the desired edit for the selected region.

Respuesta

200 - application/json

Task accepted.

code · integer · requerido

message · string · requerido

data · object · requerido

Show child attributes