Saltar para o conteúdo principal
POST
/
kling
/
v1
/
videos
/
multi-elements
Create a Kling multimodal edit task
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."
}
'
{
  "code": 123,
  "message": "<string>",
  "data": {
    "task_id": "<string>",
    "task_status": "<string>",
    "created_at": 123,
    "updated_at": 123
  }
}
Use este endpoint para enviar o job final de edição de vídeo multimodal depois que sua sessão e seleções estiverem prontas.

Fluxo 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 e o prompt final por meio deste endpoint e, em seguida, salve o id da tarefa retornado para verificações de status.

Antes de chamá-lo

  • Certifique-se de que a sessão de seleção já foi inicializada
  • Confirme que a seleção da sua região está correta antes de consumir uma chamada de geração
  • Trate esta rota como a etapa final de geração, não como a etapa de configuração
Para a referência completa de parâmetros, consulte a documentação da API do Kling.

Autorizações

Authorization
string
header
obrigatório

Bearer token authentication. Use your CometAPI key.

Corpo

application/json
session_id
string
padrão:784914037360041984
obrigatório

Session id returned by the video initialization endpoint.

edit_mode
string
padrão:replace
obrigatório

Editing operation to apply. Options: replace, remove.

prompt
string
padrão:Replace the selected object with a red paper boat.
obrigatório

Text prompt describing the desired edit for the selected region.

Resposta

200 - application/json

Task accepted.

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