Skip to main content
POST
cURL
Use este endpoint para enviar o trabalho final de edição de vídeo multimodal depois que sua sessão e seleções estiverem prontas.

Fluxo de trabalho completo

1

Inicializar a sessão de edição

Comece com Initialize Video for Editing para obter o session_id do clipe que você deseja editar.
2

Construir a área de seleção

Use Add Video Selection e, quando necessário, Preview Selected Video Area para refinar a região de edição.
3

Enviar a tarefa final

Envie o session_id, edit_mode, o prompt final e quaisquer configurações opcionais de geração por meio deste endpoint, depois salve o id da tarefa retornado para verificar o status.

Antes de chamar

  • Certifique-se de que a sessão de seleção já foi inicializada
  • Confirme que a seleção da região está correta antes de gastar uma chamada de geração
  • Execute as chamadas de acompanhamento da seleção na mesma conta e com o session_id exato retornado pela inicialização
  • Defina edit_mode como addition, swap ou removal
  • Forneça image_list para addition e swap; omita image_list para removal
  • Envie duration como uma string, como "5" ou "10"; os exemplos passam "5" explicitamente
  • Trate esta rota como a etapa final de geração, não como a etapa de configuração
  • Adicione image_list, negative_prompt, mode, duration, callback_url ou external_task_id somente quando o fluxo de edição precisar deles
Para a referência completa dos parâmetros, consulte a documentação da API Kling.

Autorizações

Authorization
string
header
obrigatório

Bearer token authentication. Use your CometAPI key.

Corpo

application/json
session_id
string
obrigatório

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

edit_mode
enum<string>
obrigatório

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

Opções disponíveis:
addition,
swap,
removal
prompt
string
obrigatório

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

model_name
enum<string>
padrão:kling-v1-6

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

Opções disponíveis:
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.

Opções disponíveis:
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.

Resposta

200 - application/json

Task accepted.

code
integer
obrigatório
message
string
obrigatório
data
object
obrigatório