카운터파트 작업 생성 - CometAPI Documentation

POST

kling

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 항목을 구성하세요
타이밍 필드가 비디오 내에서 오디오가 어떻게 정렬되어야 하는지를 올바르게 설명하는지 확인하세요

작업 흐름

먼저 얼굴 식별

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

고급 립싱크 작업 생성

이 엔드포인트를 통해 session_id와 face_choose 배열을 제출하세요.

생성된 작업 추적

상태 확인과 최종 결과 조회를 위해 반환된 작업 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.

Show child attributes

응답

200 - application/json

Task accepted.

code

integer

필수

message

string

필수

data

object

필수

Show child attributes

립싱크

비디오 효과

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
  }
}

Documentation Index

​호출 전에 확인할 사항

​작업 흐름

인증

본문

응답

호출 전에 확인할 사항

작업 흐름