Tài liệu API
image-to-video-15s-720p
Ảnh thành Video 720p - 15s — Biến ảnh tĩnh nhân vật, sản phẩm hoặc phong cảnh thành video chuyển động liền mạch 15 giây kèm âm thanh tự nhiên bằng mô hình Omni 1.2 mới nhất · xuất chuẩn HD 720p tốc độ cao.
type: videooutput: video999 ₫
Input — tham số đầu vào
POST
/v1/generationsGửi JSON gồm "model": "image-to-video-15s-720p" và các tham số dưới đây ở cùng cấp. Tham số không có trong bảng sẽ bị từ chối (400).
| Tham số | Kiểu | Giá trị hỗ trợ | Mô tả |
|---|---|---|---|
modelrequired | string | image-to-video-15s-720p | Mã model |
image_urlrequired | string (URL image) | Ảnh gốc / Nhân vật — JPG, PNG, WebP · tạo video liền mạch 15 giây bằng mô hình Omni 1.2 mới nhất · tối đa 50 MB | |
image2_url | string (URL image) | Ảnh tham chiếu phụ (Không bắt buộc) — Tuỳ chọn đính kèm thêm ảnh sản phẩm / đạo cụ / bối cảnh thứ 2 để kết hợp trong video 15s | |
prompt | string | Tối đa 4.000 ký tự | Mô tả chuyển động & diễn biến 15 giây |
aspectrequired | enum | 9:1616:9 Mặc định: | Tỷ lệ khung hình |
audio_moderequired | enum | soundnone Mặc định: | Âm thanh video |
- Tham số file (string URL) nhận link công khai http(s) — máy chủ tự tải về — hoặc URL trả về từ API tải file POST /account/ai/uploads.
- Bỏ trống tham số không bắt buộc thì dùng giá trị mặc định.
Ví dụ request
curl -X POST https://nov.ai.vn/api/v1/generations \
-H "X-API-Key: $API_KEY" -H "Content-Type: application/json" \
-d '{
"model": "image-to-video-15s-720p",
"image_url": "https://example.com/image.jpg",
"prompt": "Một chú mèo phi hành gia",
"aspect": "9:16",
"audio_mode": "sound"
}'Output — kết quả trả về
Tác vụ chạy bất đồng bộ. POST /v1/generations trả ngay đối tượng generation với status queued hoặc processing; hỏi lại GET /v1/generations/{id} mỗi 5–10 giây tới khi status là succeeded, failed hoặc cancelled.
GET
/v1/generations/{id}{
"id": "3f1c...-uuid",
"object": "generation",
"code": "T8KQ2M4X",
"model": "image-to-video-15s-720p",
"status": "succeeded", // queued | processing | succeeded | failed | cancelled
"progress": 100,
"cost": 2400, // số tiền đã trừ
"currency": "VND",
"refunded": false,
"output": {
"type": "video",
"files": [{ "url": "https://nov.ai.vn/uploads/ai/outputs/....mp4", "type": "video", "name": "video.mp4" }],
"text": null
},
"error": null,
"created_at": "2026-10-30T08:00:00.000Z",
"completed_at": "2026-10-30T08:01:12.000Z"
}| Trường | Ý nghĩa |
|---|---|
| output.files[].url | Link file kết quả — nên tải về hệ thống của bạn, file trên máy chủ có thể được dọn sau một thời gian. |
| output.text | Nội dung văn bản (chỉ có với model trả văn bản). |
| cost | Số tiền VND đã trừ vào số dư; lỗi hoặc huỷ thì tự hoàn lại (refunded = true). |
| error | Lý do lỗi khi status = failed. |
Báo giá trước khi chạy
POST
/v1/generations/estimateCùng body với POST /v1/generations, không chạy và không trừ tiền.
# => { "object": "estimate", "model": "image-to-video-15s-720p", "cost": 2400, "currency": "VND" }