# "Tác vụ tạo mẫu hiệu ứng đặc biệt" Nguồn: https://docs.openaihub.net/api-45209082/ > 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: /tencent-vod/v1/template-effect: post: summary: Tác vụ tạo mẫu hiệu ứng đặc biệt deprecated: false description: >- Tạo hiệu ứng đặc biệt từ mẫu. Tài liệu chính thức: https://cloud.tencent.com/document/product/266/126240 operationId: tencent_vod_template_effect 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: - scene_type - ext_info properties: ext_info: type: object required: - AdditionalParameters properties: AdditionalParameters: type: object required: - template properties: template: type: string description: >- Tham số mẫu cảnh Các mẫu cảnh khác nhau có các tham số gọi khác nhau. Chúng tôi cung cấp hai phương thức xem: ●Trung tâm mẫu chính thức: https://platform.vidu.cn/docs/templates ●Tài liệu trực tuyến (hỗ trợ truy vấn theo thời gian đăng trực tuyến): https://shengshu.feishu.cn/wiki/L2Dbwi7QeilCAgkdJKjcrj2Lnrg?from=from_copylink Lưu ý: Các mẫu hiệu ứng đặc biệt hiện chỉ hỗ trợ những mẫu được tạo bằng loại video. description: Các tham số bổ sung x-apifox-orders: - template x-apidog-orders: - template description: Thông tin mở rộng 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ầu 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 từ thông báo sự kiện hoàn tất tải video lên hoặc 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. Khuyến nghị 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 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. 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 có kích thước nhỏ hơn 7M; 2. Các định dạng hình ảnh được hỗ trợ là: jpeg, jpg, png, webp. Giá trị ví dụ: https://test.com/1.png x-apifox-orders: - category - file_id - type - url x-apidog-orders: - category - file_id - 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 mà mô hình sẽ sử dụng khi tạo video. Lưu ý: 1. Kích thước hình ảnh không vượt quá 10M. 2. Các định dạng hình ảnh được hỗ trợ: jpeg, png. prompt: type: string description: từ trong lời nhắc scene_type: type: string description: Giá trị template_effect refName: PostTencentVodV1TemplateEffectRequest x-apifox-orders: - ext_info - file_infos - prompt - scene_type x-apidog-orders: - ext_info - file_infos - prompt - scene_type examples: example_single: value: ext_info: AdditionalParameters: template: morphlab file_infos: - category: Hình ảnh type: Url url: >- https://image01.vidu.zone/vidu/example/20241206-175531.jpeg prompt: >- Nội dung video\nKhi cảnh bắt đầu, các chủ thể đột ngột phát nổ, những hạt nhỏ li ti bắn tung ra\n# Yêu cầu\n1. Xác định số lượng chủ thể dựa trên hình ảnh do người dùng tải lên, mỗi chủ thể đều phải phát nổ\n2. Đặt Motion Level thành: Middle\n3. Lấy >nội dung video của tôi làm yếu tố ưu tiên hàng đầu; phần mô tả hậu cảnh phải thống nhất, hợp lý và không được mô tả hai lần. scene_type: template_effect summary: example_single description: Tác vụ tạo mẫu hiệu ứng đặc biệt 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-45209082-run components: schemas: {} securitySchemes: {} servers: - url: https://api.openaihub.net description: Prod Env security: [] ```