Tạo video (hình ảnh tham chiếu)
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: /v1/video/create: post: summary: Tạo video (hình ảnh tham chiếu) deprecated: false description: >- Omni-Flash · tạo video hợp nhất (`POST /v1/video/create`, tuyến vật lý chuyển tiếp VEO; xem `relay/veo` là tuyến chính).
`model=omni-flash` / `omni-flash-edit` định tuyến đến quy trình Omni-Flash; `type` chọn khả năng:
- `1` = chuyển văn bản thành video (chỉ yêu cầu `prompt`)
- `2` = khung hình đầu/cuối (`images` yêu cầu 1-2 mục)
- `3` = hình ảnh tham chiếu (`images` yêu cầu 1-3 mục)
- `4` = chỉnh sửa video Omni-Flash (yêu cầu `input_reference`)
Trả về `id` (ID tác vụ); thăm dò `GET /v1/video/query?id=` để nhận kết quả. operationId: omni_video_create tags: - OpenAiHub Việt Nam/OpenAiHub Tiếng Việt/Video/Veo/Định dạng hợp nhất cho video - Omni parameters: - name: Content-Type in: header description: Định dạng dữ liệu phần thân yêu cầu required: false example: application/json schema: type: string - name: Accept in: header description: Định dạng dữ liệu phản hồi mà máy khách dự kiến nhận được required: false example: application/json schema: type: string - name: Authorization in: header description: Khóa xác thực API, định dạng là Bearer + dấu cách + khóa API của bạn required: false example: Bearer {{YOUR_API_KEY}} schema: type: string requestBody: content: application/json: schema: type: object required: - model - prompt properties: aspect_ratio: type: string enum: - '16:9' - '9:16' description: tỷ lệ khung hình enable_sample: type: boolean description: >- Dòng Omni-Flash chuyển sang 1080p (bỏ qua đối với các mẫu 4K) enable_upsample: type: boolean description: >- Đã nâng cấp lên 1080p (khả dụng trên một số mẫu 4K nhất định) images: type: array items: type: string format: uri description: >- Mảng URL hình ảnh (type=2 yêu cầu 1-2 hình ảnh, type=3 yêu cầu 1-3 hình ảnh) input_reference: type: string description: >- Video tham chieu chinh sua Omni-Flash (canh JSON duoc truyen den URL hoac dataURI) model: type: string description: 'Tên mô hình (ví dụ: omni-flash, omni-flash-edit)' prompt: type: string description: Mô tả nội dung video seconds: type: string description: 'Thời lượng video (giây), ví dụ: "8"' size: type: string description: >- Kích thước tùy chỉnh, tỷ lệ chiều rộng là 16:9 và tỷ lệ chiều cao là 9:16. Khi aspect_ratio có hiệu lực, tham số này không còn giá trị. type: type: integer enum: - 1 - 2 - 3 - 4 description: >- Loại tạo sinh: 1=Video từ văn bản, 2=Khung hình đầu và cuối, 3=Tham chiếu nhiều hình ảnh, 4=Chỉnh sửa video Omni-Flash allOf: - type: string - type: string - type: string - type: string refName: PostV1VideoCreateRequest x-apifox-orders: - aspect_ratio - enable_sample - enable_upsample - images - input_reference - model - prompt - seconds - size - type x-apidog-orders: - aspect_ratio - enable_sample - enable_upsample - images - input_reference - model - prompt - seconds - size - type examples: omni_flash: value: model: omni-flash prompt: xin chào thế giới summary: omni_flash description: >- Khuyến nghị cho người mới bắt đầu: Yêu cầu tối thiểu cho người mới bắt đầu · Kiến thức cơ bản về tạo sinh từ văn bản · mô hình+lời nhắc omni_flash_2: value: aspect_ratio: '16:9' model: omni-flash prompt: Cảnh hoàng hôn bên bờ biển quay từ trên không seconds: '8' summary: omni_flash_2 description: >- Khuyên dùng cho người mới bắt đầu: Màn hình ngang tiêu chuẩn · Vincent Video · model+prompt+aspect_ratio+seconds omni_flash_3: value: aspect_ratio: '9:16' model: omni-flash prompt: Nhân vật đường phố quay chậm seconds: '8' summary: omni_flash_3 description: >- Khuyến nghị cho người mới bắt đầu: tiêu chuẩn màn hình dọc · Vincent Video · model+prompt+aspect_ratio+seconds omni_flash_4: value: images: - >- https://ts1.tc.mm.bing.net/th/id/R-C.8dbf8e136e7d71653b63fdbd4d17fb6c?rik=KEcgD1%2fwKEKc9A&riu=http%3a%2f%2fimg.xintp.com%2f2019%2f12%2f10%2fxl5gp5kgesw.jpg&ehk=j5IVfJ0NDf2S9Ki9dJ7uXRMGlqubf9rR8TGsNLZP%2fMQ%3d&risl=&pid=ImgRaw&r=0 - >- https://ts1.tc.mm.bing.net/th/id/R-C.ef98ae99612a621c19aaf5c02df8590a?rik=bpRpplfXRRo8pA&riu=http%3a%2f%2fimg95.699pic.com%2fphoto%2f50166%2f6903.jpg_wh300.jpg&ehk=yf0pMNdv%2bxIdqiWephK%2fg%2bt9K%2fTLDd8Db46yw8Q%2bSXM%3d&risl=&pid=ImgRaw&r=0 model: omni-flash prompt: Chuyển tiếp mượt mà giữa khung hình đầu và cuối seconds: '8' summary: omni_flash_4 description: >- Khuyên dùng cho người mới bắt đầu: Chuyển tiếp giữa hai hình ảnh · Tạo khung hình đầu và cuối · mô hình+lời nhắc+hình ảnh+số giây omni_flash_5: value: images: - >- https://static.jokers.pub/upload/ai/728c4393-77ee-441a-99fa-ea1c294035a1/Image-91o3qgbn15t9o2k/1779515038884-1742.jpg model: omni-flash prompt: Tạo video giữ nguyên phong cách của chủ thể chính seconds: '8' summary: omni_flash_5 description: >- Khuyến nghị cho người mới bắt đầu: tham chiếu một ảnh · tạo ảnh tham chiếu đệm · mô hình+câu lệnh+ảnh+số giây omni_flash_6: value: aspect_ratio: '9:16' images: - >- https://ts2.tc.mm.bing.net/th/id/OIP-C.iBy7zllJXvjrzOH-VdwH_gHaEK?rs=1&pid=ImgDetMain&o=7&rm=3 - https://imgs.699pic.com/images/600/406/117.jpg!list1x.v2 - >- https://ts2.tc.mm.bing.net/th/id/OIP-C.thJJkD55hZLuc-D86OW7bgHaEW?rs=1&pid=ImgDetMain&o=7&rm=3 model: omni-flash prompt: >- Kết hợp chủ thể và phong cách phối màu của ba hình ảnh tham khảo seconds: '8' summary: omni_flash_6 description: >- Khuyến nghị nâng cao: Kết hợp ba hình ảnh · Tạo hình ảnh tham chiếu Mat · model+prompt+images+aspect_ratio+seconds omni_flash_7: value: model: omni-flash prompt: Video tua nhanh Thành phố Chân trời seconds: '8' type: 1 summary: omni_flash_7 description: >- Khuyến nghị nâng cao: kiểu tường minh Vincent · lệnh gọi tương thích với Vincent · mô hình+lời nhắc+kiểu+số giây omni_flash_edit: value: input_reference: https://example.com/input.mp4 model: omni-flash-edit prompt: Chuyển video gốc sang phong cách điện ảnh type: 4 summary: omni_flash_edit description: >- Khuyến nghị cho người mới bắt đầu: Kiến thức cơ bản về chỉnh sửa URL · Chỉnh sửa video · model+prompt+input_reference+seconds omni_flash_edit_datauri: value: input_reference: >- https://cdn.dealonhorizon.us/video/d2fa3281de7a69f3ac07b3451cf922e3ba609daad00d081674b283a63de67e54.mp4 model: omni-flash-edit prompt: Nâng cao màu sắc và ánh sáng type: 4 summary: omni_flash_edit_datauri description: >- Khuyến nghị nâng cao: Chỉnh sửa DataURI · Chỉnh sửa video · model+prompt+input_reference(dataURI)+seconds responses: '200': description: '' content: application/json: schema: type: object required: - id - status - status_update_time properties: id: type: string description: ID tài nguyên hoặc tác vụ status: type: string description: Trạng thái status_update_time: type: integer description: Thời điểm cập nhật trạng thái refName: PostV1VideoCreateResponse x-apifox-orders: - id - status - status_update_time x-apidog-orders: - id - status - status_update_time examples: example: summary: example value: id: omni-flash_X:task_uAbDkbRmcOafvSBBmNWwQkIA1gvTdoaX status: queued status_update_time: 1779950697931 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/Veo/Định dạng hợp nhất cho video x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1218648/apis/api-45208976-runcomponents: schemas: {} securitySchemes: {}servers: - url: https://api.openaihub.net description: Prod Envsecurity: []