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-image: post: summary: Tạo tác vụ deprecated: false description: >- Tạo ảnh theo yêu cầu trên Đám mây Tencent.
Tài liệu chính thức: https://cloud.tencent.com/document/product/266/126240 operationId: tencent_vod_sample tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Hình ảnh/Ảnh thô AIGC của Tencent - 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 từ ngữ trong lời nhắc hay không. Khi được bật, các lời nhắc gửi đến sẽ tự động được 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; ext_info: type: string 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 file_infos: type: array items: type: object properties: 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: - file_id - text - type - url x-apidog-orders: - file_id - text - type - url description: Danh sách thông tin tệp model_name: type: string description: |- Tên mô hình. Giá trị: GEM: Gemini; Qwen: Qianwen. Hunyuan: Hunyuan.
Giá trị ví dụ: GEM model_version: type: string description: |- phien ban mo hinh. Gia tri: Khi ModelName la GEM, cac gia tri tuy chon la 2.5 va 3.0; Khi ModelName la Qwen, gia tri tuy chon la 0925; Khi ModelName la Hunyuan, gia tri tuy chon la 3.0;
Gia tri vi du: 2.5 negative_prompt: type: string description: Từ khóa trong câu lệnh để ngăn mô hình tạo hình ảnh. output_config: type: object properties: aspect_ratio: type: string description: >- Chỉ định tỷ lệ khung hình của hình ảnh được tạo.
Khi ModelName là GEM, các giá trị tùy chọn gồm 1:1, 3:2, 2:3, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 và 21:9;
Khi ModelName là Qwen hoặc Jimeng, tính năng này hiện chưa được hỗ trợ. Jimeng sẽ kết hợp ý định trong Prompt với kích thước hình ảnh tham chiếu, và mô hình sẽ xác định tỷ lệ khung hình của hình ảnh đầu ra một cách thông minh.
Giá trị ví dụ: 16:9 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 hình ảnh được tạo. Các giá trị tùy chọn gồm 720P, 1080P, 2K, 4K, 1024x1024, 2048x2048, 2304x1728, 2496x1664, 2560x1440 , 3024x1296, 4096x4096, 4694x3520, 4992x3328, 5404x3040, 6198x2656. Khi sử dụng mô hình Jimeng, bạn nên chỉ định độ phân giải và tỷ lệ khung hình của hình ảnh thông qua Prompt.
Giá trị ví dụ: 1024x1024 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 của tác vụ tạo ảnh. x-apifox-orders: - aspect_ratio - input_compliance_check - output_compliance_check - person_generation - resolution - storage_mode x-apidog-orders: - aspect_ratio - input_compliance_check - output_compliance_check - person_generation - resolution - storage_mode prompt: type: string description: từ trong lời nhắc 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: TencentVodSampleRequest x-apifox-orders: - enhance_prompt - ext_info - file_infos - model_name - model_version - negative_prompt - output_config - prompt - session_context - session_id - tasks_priority x-apidog-orders: - enhance_prompt - ext_info - file_infos - model_name - model_version - negative_prompt - output_config - prompt - session_context - session_id - tasks_priority examples: example_single: value: enhance_prompt: Đã bật ext_info: '' file_infos: - file_id: '387702299774574677' text: Thông tin mô tả của hình ảnh gốc type: file url: '' model_name: GEM model_version: '3.0' negative_prompt: mờ, méo mó output_config: aspect_ratio: '1:1' input_compliance_check: Đã bật output_compliance_check: Đã bật person_generation: AllowAdult resolution: 1080P storage_mode: Tạm thời prompt: chuyển hình ảnh này sang phong cách anime session_context: '{"user_id": "123", "scene": "anh_dai_dien"}' session_id: image-task-67890 tasks_priority: 10 summary: example_single description: Tạo tác vụ responses: '200': description: '' content: application/json: schema: type: object required: - Response properties: Response: type: object required: - TaskId - RequestId properties: RequestId: type: string description: Mã yêu cầu TaskId: type: string description: Mã tác vụ description: Phần thân phản hồi theo phong cách Tencent Cloud x-apifox-orders: - RequestId - TaskId x-apidog-orders: - RequestId - TaskId refName: TencentVodSampleResponse description: >- Khi gửi thành công, hệ thống trả về `Response.TaskId`, được dùng cho truy vấn `GET /tencent-vod/v1/query/{task_id}` tiếp theo. x-apifox-orders: - Response x-apidog-orders: - Response examples: example: summary: example value: Response: RequestId: f50d7667-72d8-46bb-a7e3-0613588971b6 TaskId: 251007502-AigcImage***2782aff1e896673f1ft 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/Hình ảnh/Ảnh thô AIGC của Tencent x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208926-runcomponents: schemas: {} securitySchemes: {}servers: - url: https://api.openaihub.net description: Prod Envsecurity: []