Skip to main content
POST
cURL
세션과 선택 항목 준비가 완료된 후, 이 엔드포인트를 사용해 최종 멀티모달 비디오 편집 작업을 제출합니다.

전체 워크플로

1

편집 세션 초기화

편집용 비디오 초기화를 먼저 수행하여 편집하려는 클립의 session_id를 획득하세요.
2

선택 영역 구성

비디오 선택 추가와 필요 시 선택한 비디오 영역 미리보기를 사용해 편집 영역을 세부 조정하세요.
3

최종 작업 제출

이 엔드포인트를 통해 session_id, edit_mode, 최종 prompt, 그리고 필요한 선택적 생성 설정을 전송한 다음, 반환된 task id를 상태 확인용으로 저장하세요.

호출 전에 확인할 사항

  • 선택 세션이 이미 초기화되어 있는지 확인하세요
  • 생성 호출 비용이 발생하기 전에 영역 선택이 올바른지 확인하세요
  • 선택 관련 후속 호출은 반드시 동일한 계정과 초기화 시 반환된 정확한 session_id로 실행하세요
  • edit_modeaddition, swap, 또는 removal로 설정하세요
  • additionswap에는 image_list를 제공하고, removal에는 image_list를 생략하세요
  • duration"5" 또는 "10"과 같은 문자열로 전송하세요. 예제에서는 "5"를 명시적으로 전달합니다
  • 이 경로는 설정 단계가 아니라 최종 생성 단계로 취급하세요
  • 편집 워크플로에 필요한 경우에만 image_list, negative_prompt, mode, duration, callback_url, 또는 external_task_id를 추가하세요
전체 파라미터 참조는 Kling API 문서를 확인하세요.

인증

Authorization
string
header
필수

Bearer token authentication. Use your CometAPI key.

본문

application/json
session_id
string
필수

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

edit_mode
enum<string>
필수

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

사용 가능한 옵션:
addition,
swap,
removal
prompt
string
필수

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

model_name
enum<string>
기본값:kling-v1-6

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

사용 가능한 옵션:
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.

사용 가능한 옵션:
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.

응답

200 - application/json

Task accepted.

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