Phần nội dung chính (phiên bản mới)
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
Phần tiêu đề “OpenAPI Specification”openapi: 3.0.1info: title: '' description: '' version: 1.0.0paths: /kling/v1/general/advanced-custom-elements: post: summary: Phần nội dung chính (phiên bản mới) deprecated: false description: '' operationId: post-kling-v1-general-advanced-custom-elements tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Kling/nội dung chính - 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: - element_name - element_description - reference_type properties: callback_url: type: string description: >- URL goi lai ket qua tac vu; neu duoc thiet lap, may chu se thong bao khi trang thai thay doi element_description: type: string description: Vui lòng gửi tài liệu cần dịch. element_image_list: type: object properties: frontal_image: type: string description: Hình ảnh tham chiếu chính diện refer_images: type: array items: type: object required: - image_url properties: image_url: type: string description: URL hình ảnh x-apifox-orders: - image_url x-apidog-orders: - image_url description: Danh sách hình ảnh tham khảo description: >- Xác định chủ thể qua nhiều hình ảnh: ít nhất một frontal_image cùng với 1–3 refer_images khác nhau (image_url). Dưới dạng key:value trong element_image_list. Base64 hoặc URL; .jpg/.jpeg/.png; tối đa 10MB; tối thiểu 300px; tỷ lệ khung hình 1:2.5–2.5:1. Bắt buộc khi reference_type=image_refer x-apifox-orders: - frontal_image - refer_images x-apidog-orders: - frontal_image - refer_images element_name: type: string description: tối đa 20 ký tự element_video_list: type: object properties: refer_videos: type: array items: type: object properties: video_url: type: string description: URL video x-apifox-orders: - video_url x-apidog-orders: - video_url description: Danh sách video tham khảo description: >- Xác định chủ thể qua video. Video có lời nói sẽ kích hoạt tùy chỉnh giọng nói. Hiện tại chỉ hỗ trợ người thật. Bắt buộc đối với tham chiếu video; bị bỏ qua đối với tham chiếu hình ảnh. MP4/MOV; 3–8 giây; 16:9 hoặc 9:16 1080P; mỗi đoạn phim ≤200MB; bắt buộc có video_url. Chủ thể được tùy chỉnh bằng video chỉ khả dụng trên kling-video-o3+ x-apifox-orders: - refer_videos x-apidog-orders: - refer_videos element_voice_id: type: string description: >- có thể liên kết một giọng nói hiện có từ thư viện; khi tham số này để trống, chủ thể này không được liên kết với giọng nói. Chỉ lấy ID thông qua API giọng nói. Chỉ các chủ thể được tùy chỉnh bằng video mới hỗ trợ liên kết giọng nói external_task_id: type: string description: >- ID tác vụ tùy chỉnh. Không ghi đè ID tác vụ hệ thống, nhưng có thể được dùng cho các truy vấn. Phải là duy nhất đối với mỗi người dùng reference_type: type: string description: >- enum: video_refer、 image_refer
video_refer: chủ thể video; diện mạo từ element_video_list
image_refer: chủ thể nhiều hình ảnh; diện mạo từ element_image_list
Chủ thể tùy chỉnh theo video và theo hình ảnh có phạm vi khả dụng khác nhau; xem bảng ánh xạ khả năng / tham số. tag_list: type: array items: type: object properties: tag_id: type: string description: ID thẻ x-apifox-orders: - tag_id x-apidog-orders: - tag_id description: >- Một chủ thể có thể có nhiều thẻ ở dạng khóa:giá trị. ID/tên thẻ: o_101 meme, o_102 người, o_103 động vật, o_104 đạo cụ, o_105 trang phục, o_106 cảnh, o_107 hiệu ứng hình ảnh, o_108 khác x-apifox-orders: - callback_url - element_description - element_image_list - element_name - element_video_list - element_voice_id - external_task_id - reference_type - tag_list x-apidog-orders: - callback_url - element_description - element_image_list - element_name - element_video_list - element_voice_id - external_task_id - reference_type - tag_list examples: example: value: element_description: Kiểm thử element_image_list: frontal_image: >- Không thể truy cập nội dung trong ảnh từ URL này. Vui lòng tải ảnh trực tiếp lên để tôi dịch. refer_images: - image_url: >- Không thể truy cập nội dung trong ảnh từ URL này. Vui lòng tải ảnh trực tiếp lên để tôi dịch. element_name: Phần chính ysh11112311213 reference_type: image_refer 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/nội dung chính x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209040-runcomponents: schemas: {} securitySchemes: {}servers: - url: https://api.openaihub.net description: Prod Envsecurity: []