메인 콘텐츠로 건너뛰기
POST
/
kling
/
v1
/
videos
/
identify-face
Lip-Sync
curl --request POST \
  --url https://api.cometapi.com/kling/v1/videos/identify-face \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "video_url": "https://replicate.delivery/xezq/lZfr3rskBEVLDCytear4lUo92fOpAcoblFWzk6e06WEnC3PTB/tmpny051d_c.mp4"
}
'
{
  "code": 123,
  "message": "<string>",
  "request_id": "<string>",
  "data": {
    "session_id": "<string>",
    "face_data": [
      {
        "face_id": "<string>",
        "face_image": "<string>",
        "start_time": 123,
        "end_time": 123
      }
    ]
  }
}
이 엔드포인트를 사용하면 후속 립싱크 워크플로를 실행하기 전에 원본 비디오에서 얼굴을 식별할 수 있습니다.

이 경로가 반환하는 것

  • 현재 얼굴 감지 결과를 묶는 session_id
  • 하나 이상의 감지된 얼굴이 포함된 face_data 배열
  • face_id, 미리보기 이미지, 시간 범위와 같은 얼굴별 메타데이터

사용 시점

  • 화면에 여러 사람이 등장하는 비디오에 대해 립싱크 요청을 만들기 전에
  • 자동 선택에 의존하지 않고 특정 얼굴을 선택해야 할 때
  • 더 비용이 큰 작업을 시작하기 전에 얼굴 감지 범위를 미리 확인하고 싶을 때
전체 파라미터 참조는 공식 Kling 문서를 참고하세요.

인증

Authorization
string
header
필수

Bearer token authentication. Use your CometAPI key.

본문

application/json
video_url
string
기본값:example
필수

Public URL of the video to analyze for face identification.

응답

200 - application/json

OK

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