Tạo tác vụ
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: /tencent-vod/v1/aigc-video: post: summary: Tạo tác vụ deprecated: false description: >- Tạo video theo yêu cầu của Tencent Cloud.
Tài liệu chính thức: https://cloud.tencent.com/document/product/266/126240 operationId: tencent_vod_aigc_video tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Tencent AIGC - VOD của Tencent Cloud parameters: [] requestBody: content: application/json: schema: type: object required: - model_name - prompt - model_version properties: enhance_prompt: type: string description: >- Có tự động tối ưu hóa nội dung câu lệnh hay không. Khi được bật, các câu lệnh đầu vào sẽ được tự động tối ưu hóa để cải thiện chất lượng bản dựng. Các giá trị gồm:
Enabled: bật;
Disabled: tắt;
Giá trị ví dụ: Enabled ext_info: type: object properties: AdditionalParameters: type: object properties: multi_prompt: type: array items: type: object properties: duration: type: integer description: >- Thoi luong bang phan canh:
○Thoi luong cua moi bang phan canh khong duoc lon hon tong thoi luong cua tac vu hien tai va khong duoc nho hon 1
○Tong thoi luong cua tat ca cac bang phan canh bang tong thoi luong cua tac vu hien tai index: type: integer description: >- Số thứ tự bảng phân cảnh:
○Hỗ trợ tối đa 6 bảng phân cảnh và tối thiểu 1 bảng phân cảnh
○Độ dài tối đa của mỗi nội dung liên quan đến bảng phân cảnh không vượt quá 512 prompt: type: string description: >- Lời nhắc bảng phân cảnh:
Khi sử dụng tính năng này, nội dung được truyền vào tham số số từ tổng cộng của lời nhắc bên ngoài sẽ không hợp lệ. x-apifox-orders: - duration - index - prompt x-apidog-orders: - duration - index - prompt description: >- Thông tin của từng bảng phân cảnh, chẳng hạn như từ khóa nhắc lệnh, thời lượng, v.v.
●Xác định số thứ tự của bảng phân cảnh cùng các từ khóa nhắc lệnh và thời lượng tương ứng thông qua các tham số index, prompt và duration, trong đó:
○Hỗ trợ tối đa 6 bảng phân cảnh và tối thiểu 1 bảng phân cảnh
○Độ dài tối đa của mỗi nội dung liên quan đến bảng phân cảnh không vượt quá 512
○Thời lượng của mỗi bảng phân cảnh không được lớn hơn tổng thời lượng của tác vụ hiện tại và không được nhỏ hơn 1
○Tổng thời lượng của tất cả bảng phân cảnh bằng tổng thời lượng của tác vụ hiện tại
Sử dụng key:value để truyền tải,
Các mô hình khả dụng:
3.0 và 3.0-Omni của Kling multi_shot: type: boolean description: >- Có tạo video đa góc máy hay không
●Khi tham số hiện tại là true, tham số prompt không có hiệu lực
●Khi tham số hiện tại là false, tham số shot_type và tham số multi_prompt không có hiệu lực.
Các mô hình khả dụng:
Kling 3.0 và 3.0-Omni
Lưu ý: Tính năng tham chiếu video của Kling 3.0-Omni không hỗ trợ chế độ đa máy quay shot_type: type: string description: >- Phương pháp lập bảng phân cảnh
●Giá trị liệt kê: customize
Khi tham số multi_shot là true, tham số hiện tại là bắt buộc
Các mô hình khả dụng:
Kling 3.0 và 3.0-Omni description: Các tham số bổ sung x-apifox-orders: - multi_prompt - multi_shot - shot_type x-apidog-orders: - multi_prompt - multi_shot - shot_type description: >- Các trường dành riêng, được sử dụng cho các mục đích đặc biệt.
Giá trị ví dụ: myextinfo x-apifox-orders: - AdditionalParameters x-apidog-orders: - AdditionalParameters file_infos: type: array items: type: object properties: category: type: string description: |- Phân loại tập tin. Các giá trị là: Image: hình ảnh; Video: video. Giá trị ví dụ: Image file_id: type: string description: >- ID tệp phương tiện của tệp hình ảnh, là mã định danh duy nhất toàn cục của tệp trên dịch vụ đám mây theo yêu cầu, được hệ thống nền của dịch vụ đám mây theo yêu cầu cấp sau khi tải lên thành công. Có thể lấy trường này trong thông báo sự kiện hoàn tất tải video lên hoặc trên bảng điều khiển đám mây theo yêu cầu. Tham số này hợp lệ khi giá trị của Type là File.
Mô tả:
1. Nên sử dụng hình ảnh có kích thước nhỏ hơn 7M;
2. Các giá trị định dạng hình ảnh là: jpeg, jpg, png, webp.
Giá trị ví dụ: 3704211***509819 text: type: string description: >- Nhập thông tin mô tả của hình ảnh để giúp mô hình hiểu hình ảnh. Chỉ hợp lệ với GEM 2.5 và GEM 3.0.
Giá trị ví dụ: Bối cảnh tác vụ: Đây là tòa nhà chính cần được cải tạo (Hình 1), không được thay đổi hình dạng của tòa nhà. type: type: string description: |- Loại tệp video đầu vào. Các giá trị gồm: File: tệp phương tiện theo yêu cầu; Url: URL có thể truy cập;
Giá trị ví dụ: File url: type: string description: >- URL tệp có thể truy cập được. Tham số này hợp lệ khi giá trị của Type là Url.
Mô tả:
1. Nên sử dụng hình ảnh nhỏ hơn 7M;
2. Giá trị định dạng hình ảnh là: jpeg, jpg, png, webp.
Giá trị ví dụ: https://test.com/1.png x-apifox-orders: - category - file_id - text - type - url x-apidog-orders: - category - file_id - text - type - url description: >- Danh sách gồm tối đa ba hình ảnh tài nguyên, mô tả các hình ảnh tài nguyên sẽ được mô hình sử dụng khi tạo video.
Các mô hình hỗ trợ đầu vào nhiều hình ảnh:
1. GV: khi sử dụng đầu vào nhiều hình ảnh, không thể sử dụng LastFrameFileId và LastFrameUrl.
2. Vidu hỗ trợ video tham chiếu nhiều hình ảnh. Có thể truyền các hình ảnh 1-7 của mô hình q2 thông qua ObjectId trong FileInfos dưới dạng id chủ thể.
Lưu ý:
1. Kích thước hình ảnh không được vượt quá 10M.
2. Các định dạng hình ảnh được hỗ trợ: jpeg, png. last_frame_url: type: string description: >- URL của tệp phương tiện được dùng làm khung hình kết thúc khi tạo video. Mô tả:
1. Chỉ hỗ trợ các mô hình GV, Kling và Vidu. Các mô hình khác hiện chưa được hỗ trợ. Khi ModelName là GV, nếu tham số này được chỉ định thì FileInfos cũng phải được chỉ định làm khung hình đầu tiên của video cần tạo. Tham số này chỉ có thể được chỉ định khi ModelName là Kling, ModelVersion là 2.1 và độ phân giải đầu ra được chỉ định là 1080P. Tham số này chỉ có thể được chỉ định khi ModelName là Vidu và ModelVersion là q2-pro hoặc q2-turbo.
2. Kích thước hình ảnh phải nhỏ hơn 5M.
3. 3. Giá trị định dạng hình ảnh là: jpeg, jpg, png, webp.
Giá trị ví dụ: https://test.com/1.png model_name: type: string description: |- Tên mô hình. Giá trị: Hailuo: conch; Kling: Keling; Vidu;
Giá trị ví dụ: GV model_version: type: string description: >- phiên bản mô hình. Giá trị:
Khi ModelName là Hailuo, các giá trị tùy chọn là 02, 2.3, 2.3-fast;
Khi ModelName là Kling, các giá trị tùy chọn là 1.6, 2.0, 2.1, 2.5, O1, 3.0, 3.0-Omni;
Khi ModelName là Vidu, các giá trị tùy chọn là q2, q2-pro, q2-turbo, q3-pro, q3-turbo;
Giá trị ví dụ: 2.3 negative_prompt: type: string description: |- Từ nhắc để ngăn mô hình tạo video. Giá trị ví dụ: red output_config: type: object properties: aspect_ratio: type: string description: >- Chỉ định tỷ lệ khung hình của video được tạo.
Khi ModelName là Kling và sử dụng video Vincent, các giá trị tùy chọn là 16:9, 9:16, 1:1 và giá trị mặc định là 16:9;
Khi ModelName là Vidu, lúc tạo video và sử dụng hình ảnh tham chiếu, các giá trị tùy chọn là 16:9, 9:16, 4:3, 3:4 và 1:1. Chỉ phiên bản q2 hỗ trợ 4:3 và 3:4.
Khi ModelName là Hailuo, tính năng này chưa được hỗ trợ.
Giá trị ví dụ: 16:9 audio_generation: type: string description: >- Có tạo âm thanh hay không. Các mô hình được hỗ trợ bao gồm GV, OS. Các giá trị gồm:
Enabled: bật;
Disabled: tắt;
Giá trị mặc định: Disabled
Giá trị ví dụ: Enabled duration: type: number description: >- Thời lượng của video được tạo, đơn vị: giây.
Khi ModelName là Kling, các giá trị tùy chọn là 5 và 10, và giá trị mặc định là 5;
Khi ModelName là Kling và ModelVersion là 3.0 hoặc 3.0-Omni, các giá trị tùy chọn là 3-15, giá trị mặc định là 5
Khi ModelName là Kling và ModelVersion là 3.0 - tệp do Omni truyền vào được phân loại là Video, giá trị tùy chọn là 3-10, giá trị mặc định là 5
Khi ModelName là Hailuo, các giá trị tùy chọn là 6 và 10, và giá trị mặc định là 6;
Khi ModelName là Vidu, có thể chỉ định giá trị từ 1-10;
Giá trị ví dụ: 8.0 input_compliance_check: type: string description: >- Có bật kiểm tra tuân thủ cho nội dung đầu vào hay không. Các giá trị gồm:
Enabled: bật;
Disabled: tắt;
Giá trị ví dụ: Enabled output_compliance_check: type: string description: >- Có bật kiểm tra tính tuân thủ của nội dung đầu ra hay không. Các giá trị gồm:
Enabled: bật;
Disabled: tắt;
Giá trị ví dụ: Enabled person_generation: type: string description: >- Có cho phép tạo nhân vật hoặc khuôn mặt hay không. Các giá trị gồm:
AllowAdult: Cho phép tạo người trưởng thành;
Disallowed: Không được phép đưa người hoặc khuôn mặt vào hình ảnh;
Giá trị ví dụ: AllowAdult resolution: type: string description: >- Độ phân giải của video được tạo.
Khi ModelName là Kling, các giá trị tùy chọn là 720P và 1080P, và giá trị mặc định là 720P;
Khi ModelName là Hailuo, các giá trị tùy chọn là 768P và 1080P, và giá trị mặc định là 768P;
Khi ModelName là Vidu, các giá trị tùy chọn là 720P và 1080P, và giá trị mặc định là 720P;
Giá trị ví dụ: 720P storage_mode: type: string description: >- Chế độ lưu trữ. Các giá trị gồm:
Permanent: Lưu trữ vĩnh viễn, các tệp hình ảnh được tạo sẽ được lưu trữ trên đám mây khi có yêu cầu, và có thể lấy FileId trong thông báo sự kiện;
Temporary: Lưu trữ tạm thời. Các tệp hình ảnh được tạo sẽ không được lưu trữ trên đám mây khi có yêu cầu. Có thể lấy URL truy cập tạm thời trong thông báo sự kiện;
Giá trị mặc định: Temporary description: Cấu hình tệp phương tiện đầu ra cho các tác vụ tạo video. x-apifox-orders: - aspect_ratio - audio_generation - duration - input_compliance_check - output_compliance_check - person_generation - resolution - storage_mode x-apidog-orders: - aspect_ratio - audio_generation - duration - input_compliance_check - output_compliance_check - person_generation - resolution - storage_mode prompt: type: string description: từ trong lời nhắc scene_type: type: string description: |- Loại cảnh. Các giá trị như sau: Khi ModelName là Kling: motion_control biểu thị điều khiển chuyển động; avatar_i2v biểu thị người kỹ thuật số; lip_sync có nghĩa là đồng bộ khẩu hình; Các ModelName khác hiện chưa được hỗ trợ.
Giá trị ví dụ: motion_control session_context: type: string description: >- Ngữ cảnh nguồn, được dùng để truyền thông tin yêu cầu của người dùng một cách minh bạch. Lệnh gọi lại khi hoàn tất quá trình tái tạo chất lượng âm thanh và video sẽ trả về giá trị của trường này, với độ dài tối đa là 1000 ký tự.
Giá trị ví dụ: mySessionContext session_id: type: string description: >- Mã định danh được dùng để loại bỏ yêu cầu trùng lặp. Nếu có yêu cầu sử dụng cùng mã định danh trong vòng ba ngày, yêu cầu này sẽ trả về lỗi. Độ dài tối đa là 50 ký tự; không cung cấp giá trị hoặc dùng chuỗi rỗng để biểu thị rằng không loại bỏ yêu cầu trùng lặp.
Giá trị ví dụ: mysession tasks_priority: type: integer description: >- Mức độ ưu tiên của tác vụ. Giá trị càng lớn thì mức độ ưu tiên càng cao. Phạm vi giá trị là từ -10 đến 10. Nếu để trống, giá trị được hiểu là 0.
Giá trị ví dụ: 10 refName: PostTencentVodV1AigcVideoRequest x-apifox-orders: - enhance_prompt - ext_info - file_infos - last_frame_url - model_name - model_version - negative_prompt - output_config - prompt - scene_type - session_context - session_id - tasks_priority x-apidog-orders: - enhance_prompt - ext_info - file_infos - last_frame_url - model_name - model_version - negative_prompt - output_config - prompt - scene_type - session_context - session_id - tasks_priority examples: example_single: value: enhance_prompt: Đã bật model_name: Kling model_version: '1.6' negative_prompt: Mờ, rung output_config: aspect_ratio: '16:9' audio_generation: Đã bật duration: 8 enhance_switch: Đã bật input_compliance_check: Đã bật media_name: car-video output_compliance_check: Đã bật person_generation: AllowAdult resolution: 1080P storage_mode: Tạm thời prompt: Một chiếc ô tô đang chạy trên đường cao tốc, trời nắng đẹp. summary: example_single description: Tạo tác vụ responses: '200': description: thành công content: application/json: schema: type: object x-apidog-orders: [] examples: example: summary: example value: Response: RequestId: req-example TaskId: task-example headers: {} x-apidog-name: thành công '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/Tencent AIGC x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209081-runcomponents: schemas: {} securitySchemes: {}servers: - url: https://api.openaihub.net description: Prod Envsecurity: []