메인 콘텐츠로 건너뛰기
POST
/
kling
/
v1
/
videos
/
advanced-lip-sync
Create an advanced Kling lip-sync task
curl --request POST \
  --url https://api.cometapi.com/kling/v1/videos/advanced-lip-sync \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "session_id": "806556222048190514",
  "face_choose": [
    {
      "face_id": "0",
      "sound_file": "https://cdn1.suno.ai/e5c97078-3260-4354-a3a6-1d7249262a48.mp3",
      "sound_start_time": "1200",
      "sound_end_time": "5000",
      "sound_insert_time": "0"
    }
  ]
}
'
{
  "code": 123,
  "message": "<string>",
  "data": {
    "task_id": "<string>",
    "task_status": "<string>",
    "created_at": 123,
    "updated_at": 123
  }
}
이 엔드포인트는 원본 비디오에서 얼굴 식별을 이미 완료한 후 고급 립싱크 작업을 생성할 때 사용합니다.

호출 전에 확인할 사항

  • Lip-Sync로 시작해 session_id와 사용 가능한 face_id 값을 가져오세요
  • 각 얼굴을 오디오 세그먼트에 매핑하는 하나 이상의 face_choose 항목을 구성하세요
  • 타이밍 필드가 비디오 내에서 오디오가 어떻게 정렬되어야 하는지를 올바르게 설명하는지 확인하세요

작업 흐름

1

먼저 얼굴 식별

원본 비디오에서 Lip-Sync를 실행하고 반환된 session_id와 대상 face_id 값을 보관하세요.
2

고급 립싱크 작업 생성

이 엔드포인트를 통해 session_idface_choose 배열을 제출하세요.
3

생성된 작업 추적

상태 확인과 최종 결과 조회를 위해 반환된 작업 id를 저장하세요.
전체 파라미터 참조는 공식 Kling 문서를 참고하세요.

인증

Authorization
string
header
필수

Bearer token authentication. Use your CometAPI key.

본문

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

Session id returned by the face identification (lip-sync) endpoint.

face_choose
object[]
필수

Face-to-audio mappings. Each entry connects a detected face to an audio segment for lip-sync.

응답

200 - application/json

Task accepted.

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