MiniMax H3
hailuo/minimax-h3MiniMax H3 (Hailuo 03) là mô hình tạo video đa phương thức thống nhất, biến văn bản, hình ảnh, video và tài liệu âm thanh thành các video 2K hoàn chỉnh với âm thanh nổi gốc. Xây dựng cảnh nguyên bản, chuyển động ảnh tĩnh, chỉnh sửa video hiện có — tất cả qua một MiniMax H3 API duy nhất.
Tổng quan
MiniMax H3 (Hailuo 03) là mô hình tạo video đa phương thức thống nhất, biến văn bản, hình ảnh, video và tài liệu âm thanh thành các video 2K hoàn chỉnh với âm thanh nổi gốc. Xây dựng cảnh nguyên bản, chuyển động ảnh tĩnh, chỉnh sửa video hiện có — tất cả qua một MiniMax H3 API duy nhất.
Xác thực
Tất cả request API yêu cầu khóa API hợp lệ được truyền qua header Authorization sử dụng scheme Bearer.
Bắt đầu nhanh
Thông tin xác thực
Đặt biến môi trường RUNBASE_API_KEY.
export RUNBASE_API_KEY=your-api-keyTạo lượt chạy
curl -s https://runbase.net/api/v1/runs \
-H "Authorization: Bearer $RUNBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "hailuo/minimax-h3",
"input": {
"prompt": "A cinematic product photo of a ceramic lamp"
}
}'Lượt chạy
Các lượt chạy được xử lý bất đồng bộ. Gửi request, sau đó poll để lấy kết quả.
Tạo lượt chạy
curl -s https://runbase.net/api/v1/runs \
-H "Authorization: Bearer $RUNBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "hailuo/minimax-h3",
"input": { "prompt": "A cinematic product photo of a ceramic lamp" }
}'Lấy trạng thái lượt chạy
curl -s https://runbase.net/api/v1/runs/RUN_ID \
-H "Authorization: Bearer $RUNBASE_API_KEY"Lấy kết quả
Poll endpoint trạng thái cho đến khi status là "succeeded", sau đó đọc output.urls từ response.
Schema đầu vào
| Tham số | Loại | Bắt buộc | Mô tả |
|---|---|---|---|
| prompt | string | Bắt buộc | PromptTối đa 7000 ký tự |
| aspect_ratio | string | Tùy chọn | Aspect ratioTùy chọn: 16:99:161:14:33:421:9Mặc định: 16:9 |
| resolution | string | Tùy chọn | 2K requires at least one reference image; text-only generation supports 768p only.Tùy chọn: 768p2kMặc định: 768p |
| duration | number | Tùy chọn | Duration (seconds)Phạm vi: 4–15Mặc định: 5 |
| image_urls | string[] | Tùy chọn | Reference imagesTối đa 5 ảnh |
Schema đầu ra
| Trường | Loại | Mô tả |
|---|---|---|
| urls | string[] | URL đầu ra đã tạo |
Lỗi
API sử dụng mã trạng thái HTTP tiêu chuẩn để biểu thị thành công hoặc thất bại.
| Mã trạng thái | Mô tả |
|---|---|
| 400 | Ungültige Anfrage – fehlende oder fehlerhafte Parameter |
| 401 | Authentifizierung fehlgeschlagen – fehlender oder ungültiger API-Schlüssel |
| 402 | Unzureichendes Guthaben |
| 403 | Zugriff verweigert – IP nicht erlaubt, Konto gesperrt oder Ausgabenlimit des API-Schlüssels überschritten |
| 404 | Ausführung nicht gefunden |
| 429 | Rate-Limit überschritten |
| 500 | Interner Serverfehler |

