Skip to main content
POST
cURL
Sử dụng endpoint này để tạo một tác vụ đồng bộ môi nâng cao sau khi bạn đã xác định khuôn mặt trong video nguồn.

Trước khi gọi

  • Bắt đầu với Lip-Sync để lấy session_id và các giá trị face_id khả dụng
  • Tạo một hoặc nhiều mục face_choose để ánh xạ từng khuôn mặt với một đoạn âm thanh
  • Sử dụng audio_id cho âm thanh được tạo từ một tác vụ trước đó, hoặc sound_file cho một tệp âm thanh được lưu trữ
  • Gửi các trường thời gian theo mili giây. Ví dụ: sound_start_time: "0"sound_end_time: "2000" sẽ chọn 2 giây đầu tiên.
  • Đảm bảo đoạn âm thanh được cắt có thời lượng ít nhất 2000 ms và không vượt quá thời lượng âm thanh nguồn
  • Chỉ đặt callback_url hoặc external_task_id khi bạn cần gửi webhook hoặc mã theo dõi riêng của mình

Luồng tác vụ

1

Trước tiên hãy xác định khuôn mặt

Chạy Lip-Sync trên video nguồn và lưu lại session_id được trả về cùng với các giá trị face_id mục tiêu.
2

Tạo tác vụ đồng bộ môi nâng cao

Gửi session_id và mảng face_choose thông qua endpoint này.
3

Theo dõi tác vụ đã tạo

Lưu task id được trả về để kiểm tra trạng thái và truy xuất kết quả cuối cùng.
Để xem tài liệu tham chiếu tham số đầy đủ, hãy xem tài liệu Kling chính thức.

Ủy quyền

Authorization
string
header
bắt buộc

Bearer token authentication. Use your CometAPI key.

Nội dung

application/json
session_id
string
bắt buộc

Session id returned by identify-face.

face_choose
object[]
bắt buộc

One or more face/audio mappings to synthesize.

Minimum array length: 1
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.

Phản hồi

200 - application/json

Task accepted.

code
integer
bắt buộc
message
string
bắt buộc
data
object
bắt buộc