Skip to main content
POST
cURL
이 엔드포인트를 사용하면 소스 비디오에서 오디오 결과를 생성할 수 있습니다.

호출하기 전에

  • video_id 또는 video_url 중 하나만 전송하고, 둘 다 전송하지는 마세요
  • 소스 클립이 원래 Kling에서 생성된 것이 아닌 경우 video_url을 사용하세요
  • 통합에 필요한 경우가 아니라면 callback_urlexternal_task_id는 선택 사항으로 유지하세요

작업 흐름

1

소스 비디오 제출

Kling video_id 또는 접근 가능한 video_url 중 하나를 전송한 다음, 반환된 task id를 저장하세요.
2

작업 폴링

작업이 종료 상태에 도달할 때까지 Kling 오디오 조회 경로를 사용해 Kling 작업 가져오기를 계속 진행하세요.
3

출력 저장

안정적인 보존 또는 다운스트림 처리가 필요하다면 최종 오디오 자산을 저장하세요.
전체 파라미터 참조는 공식 Kling 문서를 참고하세요.

인증

Authorization
string
header
필수

Bearer token authentication. Use your CometAPI key.

본문

application/json
video_id
string
필수

ID of a Kling-generated video. Only videos created within the last 30 days with a duration of 3–20 seconds are supported. Mutually exclusive with video_url — exactly one must be provided.

external_task_id
string

Optional user-defined task ID for your own tracking. Does not replace the system-generated task ID. Must be unique per account.

callback_url
string

Webhook URL for task status notifications. The server sends a callback when the task status changes.

video_url
string

Accessible URL of the source video. Accepted formats: MP4, MOV. Max 100 MB, 720p or 1080p resolution, duration 3–20 seconds. Mutually exclusive with video_id — exactly one must be provided.

응답

200 - application/json

Task accepted.

code
integer
필수

Error code; specific error code definition

message
string
필수

Error message

data
object
필수