# "đồng bộ chuyển động môi" Nguồn: https://docs.openaihub.net/api-45209031/ > API origin: `https://api.openaihub.net`. Chọn đúng nhóm API và model. Thông số dưới đây là bản tham chiếu kỹ thuật; chưa phải kết quả kiểm thử từng endpoint bằng tài khoản của bạn. ## OpenAPI Specification ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /kling/v1/videos/advanced-lip-sync: post: summary: đồng bộ chuyển động môi deprecated: false description: '' operationId: post-kling-v1-videos-advanced-lip-sync tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/đồng bộ chuyển động môi - kling parameters: - name: Content-Type in: header description: Content-Type của phần thân yêu cầu, thường là application/json required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa API Bearer required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - session_id - face_choose properties: callback_url: type: string description: URL gọi lại được kích hoạt khi tác vụ hoàn tất external_task_id: type: string description: >- Mã định danh tác vụ bên ngoài tùy chỉnh để đối chiếu phía nghiệp vụ face_choose: type: array items: type: object required: - face_id - sound_start_time - sound_end_time - sound_insert_time - sound_volume - original_audio_volume properties: audio_id: type: string description: >- ID âm thanh từ API xem trước. Chỉ âm thanh trong 30 ngày gần nhất có thời lượng 2–60 giây. Phải có chính xác một trong hai trường audio_id hoặc sound_file face_id: type: string description: ID khuôn mặt do API nhận diện khuôn mặt trả về original_audio_volume: type: integer description: >- Âm lượng video gốc; giá trị cao hơn = âm thanh lớn hơn; phạm vi [0,2]; không có tác dụng nếu bản gốc không có âm thanh sound_end_time: type: integer description: >- thời gian kết thúc của đoạn âm thanh không được vượt quá thời lượng của âm thanh gốc sound_file: type: string description: >- Tệp âm thanh. Dữ liệu Base64 hoặc URL có thể truy cập; .mp3/.wav/.m4a; ≤5MB; thời lượng 2–60 giây. Chỉ được cung cấp một trong hai trường audio_id hoặc sound_file. Định dạng/kích thước không hợp lệ hoặc vấn đề về nội dung sẽ trả về lỗi sound_insert_time: type: integer description: >- thời gian chèn của khoảng âm thanh đã cắt phải chồng lấp với khoảng thời gian khuôn mặt có thể đồng bộ khẩu hình ít nhất 2 giây; thời điểm bắt đầu chèn không được trước thời điểm bắt đầu video, và thời điểm kết thúc chèn không được sau thời điểm kết thúc video sound_start_time: type: integer description: >- thời gian bắt đầu của đoạn âm thanh;tính tương đối so với thời điểm bắt đầu của âm thanh gốc (0:00), đơn vị: ms;phần âm thanh trước thời điểm bắt đầu sẽ bị cắt bỏ, đoạn âm thanh sau khi cắt phải dài ít nhất 2 giây sound_volume: type: integer description: Âm lượng âm thanh; cao hơn=to hơn; phạm vi [0, 2] x-apifox-orders: - audio_id - face_id - original_audio_volume - sound_end_time - sound_file - sound_insert_time - sound_start_time - sound_volume x-apidog-orders: - audio_id - face_id - original_audio_volume - sound_end_time - sound_file - sound_insert_time - sound_start_time - sound_volume description: >- chỉ định một khuôn mặt để đồng bộ hóa khẩu hình;bao gồm ID khuôn mặt, tham chiếu đồng bộ hóa khẩu hình, v.v.;hiện chỉ hỗ trợ đồng bộ hóa khẩu hình cho một người session_id: type: string description: ID phiên từ API nhận diện khuôn mặt đồng bộ khẩu hình x-apifox-orders: - callback_url - external_task_id - face_choose - session_id x-apidog-orders: - callback_url - external_task_id - face_choose - session_id examples: example: value: callback_url: '' external_task_id: '' face_choose: - audio_id: '825451760499568680' face_id: '-1' original_audio_volume: 1 sound_end_time: 5000 sound_file: '' sound_insert_time: 1000 sound_start_time: 0 sound_volume: 1 session_id: '825465778199224380' summary: example responses: '200': description: '' content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: code: 0 data: task_id: task_example_001 message: thành công headers: {} x-apidog-name: '' '400': description: Yêu cầu không hợp lệ hoặc xác thực thất bại content: application/json: schema: type: object required: - error properties: error: type: object required: - message - type properties: message: type: string description: Thông báo lỗi (thường kết thúc bằng mã yêu cầu) type: type: string description: Loại lỗi; các lỗi cổng cục bộ thường là new_api_error examples: - new_api_error x-apifox-orders: - message - type x-apidog-orders: - message - type refName: NewApiError x-apifox-orders: - error x-apidog-orders: - error examples: example: summary: example value: error: message: >- Yêu cầu không hợp lệ (mã yêu cầu: 20260805120000123456789AbCdEfGh) type: new_api_error headers: {} x-apidog-name: Yêu cầu không hợp lệ hoặc xác thực thất bại '401': description: Khóa API bị thiếu hoặc không hợp lệ content: application/json: schema: type: object required: - error properties: error: type: object required: - message - type properties: message: type: string description: Thông báo lỗi (thường kết thúc bằng mã yêu cầu) type: type: string description: Loại lỗi; các lỗi cổng cục bộ thường là new_api_error examples: - new_api_error x-apifox-orders: - message - type x-apidog-orders: - message - type refName: NewApiError x-apifox-orders: - error x-apidog-orders: - error examples: example: summary: example value: error: message: >- Mã thông báo không hợp lệ (request id: 20260805120000123456789AbCdEfGh) type: new_api_error headers: {} x-apidog-name: Khóa API bị thiếu hoặc không hợp lệ security: [] x-apidog-folder: OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/đồng bộ chuyển động môi x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209031-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ```