Skip to main content
POST
cURL
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 de trabajo completo

1

Initialize the editing session

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

Build the selection area

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

Submit the final task

Envía el session_id, edit_mode, el prompt final y cualquier configuración opcional de generación mediante 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 tu región sea correcta antes de consumir una llamada de generación
  • Ejecuta las llamadas de seguimiento de selección en la misma cuenta y con el session_id exacto devuelto por la inicialización
  • Establece edit_mode en addition, swap o removal
  • Proporciona image_list para addition y swap; omite image_list para removal
  • Envía duration como una cadena como "5" o "10"; los ejemplos pasan "5" explícitamente
  • Trata esta ruta como el paso final de generación, no como el paso de configuración
  • Agrega image_list, negative_prompt, mode, duration, callback_url o external_task_id solo cuando el flujo de edición los necesite
Para ver 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
requerido

Selection session id returned by init-selection. Follow-up calls must use the same account and exact session id.

edit_mode
enum<string>
requerido

Editing operation for the selected video region. Use addition to add an element, swap to replace a selected element, or removal to remove it.

Opciones disponibles:
addition,
swap,
removal
prompt
string
requerido

Instruction describing the desired edit. Reference the source video as <<<video_1>>> and any reference image as <<<image_1>>>.

model_name
enum<string>
predeterminado:kling-v1-6

Kling model variant for the final edit task. Omit to use kling-v1-6.

Opciones disponibles:
kling-v1-6
image_list
object[]

Image references used by addition and swap tasks. Omit this field for removal tasks.

Minimum array length: 1
negative_prompt
string

Elements to avoid in the edited result.

mode
enum<string>

Generation mode. Use std or pro.

Opciones disponibles:
std,
pro
duration
string

Requested output duration in seconds.

callback_url
string

Webhook URL to receive task status updates.

external_task_id
string

Custom task id for your own tracking. Must be unique per account.

Respuesta

200 - application/json

Task accepted.

code
integer
requerido
message
string
requerido
data
object
requerido