Tạo video
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: /alibailian/api/v1/services/aigc/video-generation/video-synthesis: post: summary: Tạo video deprecated: false description: >- Diem tao thong nhat cho cac tac vu tong hop video bat dong bo, chang han nhu tao video tu hinh anh/van ban bang Wan va chinh sua video bang HappyHorse, duoc phan biet boi `model`:
- Cac mo hinh tao video tu hinh anh cua Wan (vi du: `wan2.5-i2v-preview`): bat buoc phai co `input.img_url` (hinh anh khung hinh dau tien) va `input.prompt`.
- `happyhorse-1.0-video-edit`: bat buoc phai co `input.media` (1 video + 0-5 hinh anh tham chieu).
Tra ve `output.task_id`; tham do `GET /alibailian/api/v1/tasks/{task_id}` de lay ket qua. operationId: alibailian_video_synthesis tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Thông Nghĩa Vạn Tượng - Xưởng mô hình Alibaba parameters: [] requestBody: content: application/json: schema: type: object required: - model - input properties: input: type: object required: - prompt properties: audio_url: type: string description: >- Tùy chọn. URL âm thanh tùy chỉnh (wav/mp3, 3-30 giây, tối đa 15MB) được dùng làm âm thanh cho video được tạo; chỉ được hỗ trợ bởi các mô hình thuộc dòng Wan 2.5/2.6.
Nếu dài hơn `duration`, chỉ 5/10 giây đầu tiên được sử dụng; nếu ngắn hơn, phần video còn lại sẽ không có âm thanh. img_url: type: string description: >- URL hình ảnh khung hình đầu tiên hoặc Base64 (`data:{MIME_type};base64,{data}`), hỗ trợ JPEG/JPG/PNG/BMP/WEBP.
**Bắt buộc đối với các mô hình chuyển hình ảnh thành video Wan** (ví dụ: `wan2.5-i2v-preview`); không được `happyhorse-1.0-video-edit` sử dụng (thay vào đó, hãy dùng `media`). media: type: array items: type: object required: - type - url properties: type: type: string description: >- Loại tư liệu phương tiện. Các giá trị tùy chọn là:
video: bắt buộc phải được truyền vào. Video cần chỉnh sửa.
reference_image: không bắt buộc. Hình ảnh tham chiếu.
Các giới hạn về tư liệu:
Số lượng video: Chỉ duy nhất một.
Số lượng hình ảnh tham chiếu: từ 0 đến 5. url: type: string description: >- Video đầu vào (type=video)
URL của video cần chỉnh sửa phải là URL có thể truy cập từ mạng công cộng.
Hỗ trợ giao thức HTTP và HTTPS.
Giá trị ví dụ: https://xxx/xxx.mp4.
Giới hạn đối với video:
Định dạng: MP4, MOV (khuyến nghị mã hóa H.264).
Thời lượng: 3~60 giây.
Độ phân giải: không quá 2160 pixel ở cạnh dài và không dưới 320 pixel ở cạnh ngắn.
Tỷ lệ khung hình: 1:2.5~2.5:1.
Kích thước tệp: không quá 100MB.
Tốc độ khung hình: lớn hơn 8fps.
Mô tả
Thời lượng video đầu ra: 3~15 giây.
Khi video đầu vào không vượt quá 15 giây, thời lượng video đầu ra được giữ nguyên như video đầu vào.
Khi video đầu vào vượt quá 15 giây, hệ thống sẽ tự động lấy 15 giây đầu tiên tính từ đầu video làm đoạn hợp lệ, vì vậy thời lượng đầu ra tối đa là 15 giây.
Hình ảnh đầu vào (type=reference_image)
URL của hình ảnh tham chiếu phải là URL có thể truy cập từ mạng công cộng.
Hỗ trợ giao thức HTTP hoặc HTTPS.
Giá trị ví dụ: https://xxx/xxx.png.
Giới hạn đối với hình ảnh:
Định dạng: JPEG, JPG, PNG, WEBP.
Độ phân giải: chiều rộng và chiều cao không được dưới 300 pixel.
Tỷ lệ khung hình: 1:2.5~2.5:1.
Kích thước tệp: không quá 10MB. x-apifox-orders: - type - url x-apidog-orders: - type - url description: >- Danh sach tu lieu phuong tien, dung de chi dinh video va cac hinh anh tham chieu can duoc chinh sua.
Mang phai chua 1 phan tu loai video; tuy chon chua tu 0 den 5 phan tu loai reference_image. prompt: type: string description: >- Các từ trong lời nhắc văn bản. Được dùng để mô tả ý định chỉnh sửa video (chuyển đổi phong cách, thay thế một phần, v.v.) cho HappyHorse, hoặc nội dung video cho các mô hình chuyển hình ảnh thành video/chuyển văn bản thành video của Wan.
Hỗ trợ đầu vào bằng mọi ngôn ngữ; độ dài không vượt quá 5000 ký tự không phải tiếng Trung hoặc 2500 ký tự tiếng Trung; phần vượt quá sẽ tự động bị cắt bỏ. description: >- Đầu vào. Tùy theo `model`, bắt buộc cung cấp chính xác một trong hai trường: `img_url` (bắt buộc đối với các mô hình Wan chuyển hình ảnh thành video) hoặc `media` (bắt buộc đối với `happyhorse-1.0-video-edit`). x-apifox-orders: - audio_url - img_url - media - prompt x-apidog-orders: - audio_url - img_url - media - prompt model: type: string description: |- Tên mô hình.
Giá trị cố định: happyhorse-1.0-video-edit. parameters: type: object properties: audio_setting: type: string description: >- Điều khiển âm thanh (chỉ dành cho `happyhorse-1.0-video-edit`).
auto: Giá trị mặc định, do chính mô hình điều khiển.
origin: Giữ nguyên âm thanh gốc của video đầu vào. duration: type: integer enum: - 5 - 10 description: >- Thời lượng video tính bằng giây (chỉ dành cho các mô hình Wan), có thể là 5 hoặc 10; thời lượng đầu ra của `happyhorse-1.0-video-edit` được xác định bởi video đầu vào và không sử dụng trường này. prompt_extend: type: boolean description: >- Có bật tính năng viết lại lời nhắc thông minh hay không (chỉ dành cho các mô hình Wan). Khi được bật, một LLM sẽ viết lại lời nhắc đầu vào; tính năng này cải thiện đáng kể kết quả đối với các lời nhắc ngắn nhưng làm tăng độ trễ. resolution: type: string description: |- Mức độ phân giải của video được tạo.
Các giá trị tùy chọn:
1080P: Giá trị mặc định.
720P seed: type: integer description: >- Hạt giống ngẫu nhiên (chỉ dành cho các mô hình Wan), phạm vi `[0, 2147483647]`. Được tự động tạo nếu không được chỉ định. watermark: type: boolean description: >- Có thêm biểu trưng hình mờ vào video được tạo hay không. Hình mờ nằm ở góc dưới bên phải của video và nội dung văn bản được cố định là "Happy Horse".
true: Giá trị mặc định, thêm hình mờ.
false: Không thêm hình mờ. description: tham số x-apifox-orders: - audio_setting - duration - prompt_extend - resolution - seed - watermark x-apidog-orders: - audio_setting - duration - prompt_extend - resolution - seed - watermark refName: >- PostAlibailianApiV1ServicesAigcVideoGenerationVideoSynthesisRequest x-apifox-orders: - input - model - parameters x-apidog-orders: - input - model - parameters examples: happyhorse_1_0_video_edit: value: input: media: - type: video url: >- https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260409/dozxak/Wan_Video_Edit_33_1.mp4 - type: reference_image url: >- https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20260415/hynnff/wan-video-edit-clothes.webp prompt: >- Cho nhân vật đầu ngựa thân người trong video mặc chiếc áo len sọc trong ảnh. model: happyhorse-1.0-video-edit parameters: resolution: 720P summary: happyhorse_1_0_video_edit description: happyhorse-1.0-video-edit wan2_5_i2v_preview: value: input: img_url: >- https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/wpimhv/rap.png prompt: Một con mèo đang chạy trên đồng cỏ. model: wan2.5-i2v-preview parameters: duration: 5 resolution: 720P summary: wan2_5_i2v_preview description: Ảnh thành video (Wan 2.5) responses: '200': description: '' content: application/json: schema: type: object required: - request_id - output properties: output: type: object required: - task_id - task_status properties: task_id: type: string description: ID tác vụ bất đồng bộ task_status: type: string description: Trạng thái tác vụ description: Kết quả đầu ra x-apifox-orders: - task_id - task_status x-apidog-orders: - task_id - task_status request_id: type: string description: ID truy vết yêu cầu refName: >- PostAlibailianApiV1ServicesAigcVideoGenerationVideoSynthesisResponse x-apifox-orders: - output - request_id x-apidog-orders: - output - request_id examples: example: summary: example value: output: task_id: 86438901-c911-4bfa-9137-621478c85efd task_status: ĐANG CHỜ request_id: 1445f928-f1b6-9c43-8143-bfaddb5989cf 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/Thông Nghĩa Vạn Tượng x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45209061-runcomponents: schemas: {} securitySchemes: {}servers: - url: https://api.openaihub.net description: Prod Envsecurity: []