메인 콘텐츠로 건너뛰기
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
  }
}
세션과 선택 항목 준비가 완료된 후, 이 엔드포인트를 사용해 최종 멀티모달 비디오 편집 작업을 제출합니다.

전체 워크플로

1

편집 세션 초기화

Initialize Video for Editing을 먼저 실행해 편집하려는 클립의 session_id를 가져옵니다.
2

선택 영역 구성

Add Video Selection과 필요 시 Preview Selected Video Area를 사용해 편집 영역을 세밀하게 조정합니다.
3

최종 작업 제출

이 엔드포인트를 통해 session_id, edit_mode, 최종 prompt를 전송한 다음, 상태 확인에 사용할 반환된 작업 id를 저장합니다.

호출 전 확인 사항

  • 선택 세션이 이미 초기화되어 있는지 확인하세요
  • 생성 호출을 사용하기 전에 영역 선택이 올바른지 확인하세요
  • 이 경로는 설정 단계가 아니라 최종 생성 단계로 사용하세요
전체 파라미터 참조는 Kling API documentation을 확인하세요.

인증

Authorization
string
header
필수

Bearer token authentication. Use your CometAPI key.

본문

application/json
session_id
string
기본값:784914037360041984
필수

Session id returned by the video initialization endpoint.

edit_mode
string
기본값:replace
필수

Editing operation to apply. Options: replace, remove.

prompt
string
기본값:Replace the selected object with a red paper boat.
필수

Text prompt describing the desired edit for the selected region.

응답

200 - application/json

Task accepted.

code
integer
필수
message
string
필수
data
object
필수