flux-3-max
FLUX 3 Max · Hình sắc nét, có tiếng, tới 20s — Tổng hợp các mô hình tạo video thế hệ mới: Kling 4.0 (30s), Wan 3.0 (30s), Google Veo 3.1 (4K), Vidu Q4, MiniMax H3 Max, FLUX 3 Max, LTX 2.5 Fast.
Input — tham số đầu vào
/v1/generationsGửi JSON gồm "model": "flux-3-max" 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 | flux-3-max | Mã model |
moderequired | enum | flux-3-max:t2vflux-3-max:i2v | Chế độ đầu vào — Chọn chế độ tạo video: Chữ → Video, Ảnh → Video, Khung đầu – cuối hoặc Tham chiếu (@Image1, @Video1, @Audio1) |
promptrequired | string | Tối đa 5.000 ký tự | Mô tả cảnh & chuyển động (prompt) |
image_url | string (URL image) | Ảnh khung đầu — Tải lên ảnh khung hình mở đầu của video Chỉ có hiệu lực khi | |
last_frame_url | string (URL image) | Ảnh khung cuối — Chốt khung hình kết thúc (bắt buộc ở chế độ Khung đầu – cuối; tuỳ chọn ở Ảnh → Video) Chỉ có hiệu lực khi | |
image_urls | string[] (URL image) | Tối đa 12 file | Ảnh tham chiếu @Image1, @Image2... (tối đa 12 ảnh) — Thứ tự ảnh #1, #2, #3... tương ứng @Image1, @Image2, @Image3 trong câu mô tả Chỉ có hiệu lực khi |
video_urls | string[] (URL video) | Tối đa 5 file | Video tham chiếu @Video1... (tối đa 5 video) — Tham chiếu chuyển động / góc máy (@Video1...). Hệ thống tự báo giá thời gian thực theo độ dài video tham chiếu đính kèm Chỉ có hiệu lực khi |
audio_urls | string[] (URL audio) | Tối đa 5 file | Âm thanh tham chiếu @Audio1... (tối đa 5 file) — File giọng thoại / nhạc nền MP3, WAV để nhân vật nhép môi hoặc khớp nhịp (@Audio1...) Chỉ có hiệu lực khi |
resolutionrequired | enum | Lựa chọn thay đổi theo | Độ phân giải |
durationrequired | enum | Lựa chọn thay đổi theo | Thời lượng video |
aspectrequired | enum | Lựa chọn thay đổi theo | Tỉ lệ khung hình Chỉ có hiệu lực khi |
audio | boolean | true, false Mặc định: | Tạo âm thanh & lời thoại — Tự sinh tiếng động môi trường và lời thoại theo cảnh (với Veo 3.1 & Kling 3.0, tắt tiếng giúp giảm mạnh chi phí) Chỉ có hiệu lực khi |
negative | string | Tối đa 1.500 ký tự | Không muốn có trong video (tuỳ chọn) Chỉ có hiệu lực khi |
seed | string | Tối đa 20 ký tự | Seed cố định (tuỳ chọn) Chỉ có hiệu lực khi |
- 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.
- Thứ tự phần tử trong mảng
image_urls([url_1, url_2, url_3]) được hệ thống khoá cố định 1–1 theo đúng thứ tự: Ảnh 1 / Image 1 / FIRST image, Ảnh 2 / Image 2 / SECOND image, Ảnh 3 / Image 3 / THIRD image. Khi tải file từ máy qua POST /account/ai/uploads, hãy upload tuần tự theo đúng thứ tự [1, 2, 3] để mảng URL không bị đảo. - Bỏ trống tham số không bắt buộc thì dùng giá trị mặc định.
Ví dụ request (cURL)
curl -X POST https://nov.ai.vn/api/v1/generations \
-H "X-API-Key: $API_KEY" -H "Content-Type: application/json" \
-d '{
"model": "flux-3-max",
"mode": "flux-3-max:t2v",
"prompt": "Giữ nguyên tư thế và bố cục của Ảnh 1, thay sang bộ trang phục ở Ảnh 2 và lấy khuôn mặt từ Ảnh 3.",
"resolution": "...",
"duration": "..."
}'Code mẫu tích hợp đầy đủ (Upload file → Tạo tác vụ → Nhận kết quả)
Python 3
import os, time, requests
BASE = "https://nov.ai.vn/api"
API_KEY = os.environ["API_KEY"] # hoặc điền trực tiếp "cmsnt_..."
HEADERS = {"X-API-Key": API_KEY}
def upload_file(local_path: str) -> str:
"""Tải 1 file từ máy lên server và trả về URL đầu vào"""
with open(local_path, "rb") as f:
r = requests.post(f"{BASE}/account/ai/uploads", headers=HEADERS, files={"file": f}, timeout=120)
data = r.json()
if not r.ok:
raise RuntimeError(data.get("message") or r.text)
return data["url"]
# Bước 1: Upload tuần tự đúng thứ tự Ảnh 1 -> Ảnh 2 -> Ảnh 3 (hoặc dùng thẳng link https công khai)
image_urls = [
upload_file("./1.jpg"), # Ảnh 1 (Image 1 / FIRST image)
upload_file("./2.jpg"), # Ảnh 2 (Image 2 / SECOND image)
upload_file("./3.jpg"), # Ảnh 3 (Image 3 / THIRD image)
]
# Bước 2: Gửi yêu cầu tạo ảnh với đúng thứ tự mảng image_urls [1, 2, 3]
payload = {
"model": "flux-3-max",
"mode": "flux-3-max:t2v",
"prompt": "Giữ nguyên tư thế và bố cục của Ảnh 1, thay sang bộ trang phục ở Ảnh 2 và lấy khuôn mặt từ Ảnh 3.",
"resolution": "...",
"duration": "..."
}
r = requests.post(f"{BASE}/v1/generations", headers=HEADERS, json=payload, timeout=60)
gen = r.json()
if not r.ok:
raise RuntimeError(gen.get("message") or r.text)
# Bước 3: Hỏi trạng thái mỗi 5 giây tới khi hoàn tất
while gen["status"] in ("queued", "processing"):
time.sleep(5)
poll = requests.get(f"{BASE}/v1/generations/{gen['id']}", headers=HEADERS, timeout=60)
gen = poll.json()
if gen["status"] != "succeeded":
raise RuntimeError(gen.get("error") or gen["status"])
print("Kết quả:", [f["url"] for f in gen["output"]["files"]])Node.js (18+)
import fs from "node:fs";
import path from "node:path";
const BASE = "https://nov.ai.vn/api";
const API_KEY = process.env.API_KEY; // hoặc điền trực tiếp "cmsnt_..."
async function uploadFile(filePath) {
const form = new FormData();
const buf = fs.readFileSync(filePath);
form.append("file", new Blob([buf]), path.basename(filePath));
const res = await fetch(`${BASE}/account/ai/uploads`, {
method: "POST",
headers: { "X-API-Key": API_KEY },
body: form,
});
const data = await res.json();
if (!res.ok) throw new Error(data.message || res.statusText);
return data.url;
}
// Bước 1: Upload tuần tự từng ảnh 1 -> 2 -> 3 để giữ đúng thứ tự mảng
const imageUrls = [];
for (const file of ["./1.jpg", "./2.jpg", "./3.jpg"]) {
imageUrls.push(await uploadFile(file));
}
// Bước 2: Gửi tạo tác vụ
const createRes = await fetch(`${BASE}/v1/generations`, {
method: "POST",
headers: { "X-API-Key": API_KEY, "Content-Type": "application/json" },
body: JSON.stringify({
...{
"model": "flux-3-max",
"mode": "flux-3-max:t2v",
"prompt": "Giữ nguyên tư thế và bố cục của Ảnh 1, thay sang bộ trang phục ở Ảnh 2 và lấy khuôn mặt từ Ảnh 3.",
"resolution": "...",
"duration": "..."
},
image_urls: imageUrls,
}),
});
let gen = await createRes.json();
if (!createRes.ok) throw new Error(gen.message || createRes.statusText);
// Bước 3: Chờ kết quả
while (["queued", "processing"].includes(gen.status)) {
await new Promise((r) => setTimeout(r, 5000));
const pollRes = await fetch(`${BASE}/v1/generations/${gen.id}`, {
headers: { "X-API-Key": API_KEY },
});
gen = await pollRes.json();
}
if (gen.status !== "succeeded") throw new Error(gen.error ?? gen.status);
console.log("Kết quả:", gen.output.files.map((f) => f.url));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.
/v1/generations/{id}{
"id": "3f1c...-uuid",
"object": "generation",
"code": "T8KQ2M4X",
"model": "flux-3-max",
"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
/v1/generations/estimateCùng body với POST /v1/generations, không chạy và không trừ tiền.
# => { "object": "estimate", "model": "flux-3-max", "cost": 2400, "currency": "VND" }