Source: https://ailoot.ai/models/vi/minimax-hailuo-3-max/
Canonical: https://ailoot.ai/models/vi/minimax-hailuo-3-max/
Language: vi

# MiniMax: H3 Max

[Markdown](https://ailoot.ai/models/vi/minimax-hailuo-3-max/index.md) · [JSON](https://ailoot.ai/models/vi/minimax-hailuo-3-max/facts.json)

## [MiniMax: H3 Max](https://ailoot.ai/models/vi/minimax-hailuo-3-max/)

MiniMax H3 Max là biến thể H3 được hậu huấn luyện để tạo nhanh video ngắn có âm thanh đồng bộ. Quy trình MiniMax được mô tả hỗ trợ văn bản, ảnh khung và tham chiếu đa phương thức, với đầu ra 480P hoặc 768P, thời lượng 5–15 giây và lựa chọn mở rộng lời nhắc riêng.

- [**Ailoot Ultra · Video** `POST /v1/videos` `minimax/hailuo-3-max`](https://ailoot.ai/models/vi/minimax-hailuo-3-max/#method-0)

Về mô hình

Mô tả này trình bày khả năng của mô hình. Đầu vào, đầu ra và tùy chọn có trên Ailoot được liệt kê bên dưới cho phương thức đã chọn.

Biến thể H3 nhanh được hậu huấn luyện

MiniMax H3 Max là biến thể hậu huấn luyện của mô hình cơ sở MiniMax H3, tối ưu cho tạo nhanh hơn, tuân thủ lời nhắc và chất lượng âm thanh–hình ảnh. Biến thể được phát triển bằng hậu huấn luyện bởi fal Research. Mô hình giữ ngữ cảnh đa phương thức thống nhất và khả năng đồng bộ hình–tiếng tích hợp. Tốc độ là ưu tiên thiết kế thay vì thời gian hoàn tất cố định cho mọi lời nhắc, thời lượng hoặc ứng dụng.

Phân biệt Max với hệ H3 gốc và biến thể Max Turbo riêng. Giao diện MiniMax hiện tại liệt kê Max ở 480P hoặc 768P, mặc định 768P, 24 khung mỗi giây và thời lượng nguyên từ 5 đến 15 giây. Quy trình Max được mô tả không cung cấp thiết lập 2K của hệ H3 gốc hoặc đầu ra bốn giây.

Từ lời nhắc đến cú máy

Mỗi lần tạo gồm yêu cầu văn bản không trống, đến 7,000 ký tự mỗi mục văn bản. Mô tả chủ thể, bố cục đầu, hành động và kết quả, rồi làm rõ hướng máy quay và âm thanh. Với hé lộ vật ngắn, xác định người xem cần thấy gì trước, vật đi vào tầm nhìn ra sao và cú nên kết thúc thế nào.

Yêu cầu năm giây hữu ích có thể mô tả cốc gốm trên bàn gỗ, tay đặt đĩa lót cạnh cốc, máy quay tiến nhẹ và tiếng gốm chạm gỗ. Giữ hành động đủ nhỏ cho thời lượng đã chọn và kiểm tra chuyển động cùng âm thanh trả về theo cùng sự kiện.

Sáng tạo theo hướng dẫn khung hình

Nhà sản xuất mô tả khung mở đầu, khung kết thúc hoặc cả hai. Ảnh đầu xác lập nơi đoạn bắt đầu; ảnh cuối xác lập trạng thái hình ảnh cuối. Giải thích chuyển động nối chúng, gồm đổi tư thế, vị trí vật, máy quay hoặc ánh sáng. Với chuyển tiếp hai khung, tránh yêu cầu đưa cảnh không tương thích vào giữa điểm biên.

Đầu ra theo khung lấy tỷ lệ từ ảnh đầu vào. Với tác vụ chỉ văn bản, chọn tỷ lệ cụ thể từ 21:9, 16:9, 4:3, 1:1, 3:4 hoặc 9:16. Tác vụ theo tham chiếu có thể dùng tỷ lệ thích ứng hoặc lựa chọn tường minh được mô tả. Bố trí tham chiếu hoặc mô tả cảnh bằng văn bản cho khung hình đích thay vì giả định cùng cách sắp xếp phù hợp ngang và dọc như nhau.

Tham chiếu đa phương thức

Schema tạo Max hiện tại của MiniMax còn mô tả ảnh, video và âm thanh tham chiếu. Nêu mỗi nguồn cần ảnh hưởng gì: danh tính nhân vật, môi trường, mẫu chuyển động, quỹ đạo máy quay, âm sắc giọng hoặc đặc tính âm thanh. Vai trò khung đầu/cuối và vai trò phương tiện tham chiếu loại trừ nhau trong giao diện đó.

Với cú nhân vật, xác định tham chiếu diện mạo và chuyển động riêng, rồi cung cấp hành động đích và câu nói. Tham chiếu giọng xác lập cách thể hiện khác sao chép toàn tín hiệu âm thanh. Giữ yêu cầu tường minh về đặc điểm cần giữ, thay đổi cần làm và xem đoạn hình–tiếng thực tế theo từng vai trò tham chiếu.

Mở rộng lời nhắc

Thiết lập mở rộng riêng Max cung cấp disabled, balanced và quality, mặc định balanced. Chọn disabled khi yêu cầu cung cấp cần đi qua không mở rộng; dùng chế độ mở rộng được mô tả khi muốn diễn giải thêm. Giữ yêu cầu gốc để phân biệt thay đổi do mở rộng với nội dung được yêu cầu.

Mô tả âm thanh là một phần cảnh. Xác định âm vật lý, âm nền và mọi lời nói, tách chúng khỏi nhạc nền chỉ dành khán giả. Cung cấp câu chính xác và người nói dự kiến thay vì yêu cầu hội thoại không xác định. Nghe cũng như xem kết quả; hình thuyết phục không xác lập câu nói hoặc thời điểm đúng.

Chuẩn bị đầu vào và giới hạn

Schema nhà sản xuất hiện tại nhận ảnh JPG, JPEG, PNG, WebP, HEIC hoặc HEIF, mỗi ảnh đến 30 MB, cạnh từ 256 đến 5,760 pixel và tỷ lệ từ 0.4 đến 2.5. Vai trò mở đầu và kết thúc mỗi loại cho một ảnh; chế độ tham chiếu cho đến chín ảnh. Giữ góc chủ thể rõ và chi tiết phải còn nhận ra.

Video tham chiếu cho đến ba đoạn MP4 hoặc MOV, mỗi đoạn 2–15 giây và tổng tối đa 15 giây, giới hạn 50 MB mỗi tệp. Tài liệu nêu video H.264 hoặc H.265, âm thanh AAC hoặc MP3, cạnh từ 256 đến 5,760 pixel, tỷ lệ từ 0.4 đến 2.5 và tốc độ khung từ 23.976 đến 60. Âm thanh tham chiếu cho đến ba đoạn WAV hoặc MP3, mỗi đoạn đến 15 MB và 2–15 giây, tổng tối đa 15 giây. Thân yêu cầu có giới hạn riêng 64 MB.

Chỉ dùng tham chiếu đóng góp cho cú và xác định từng đóng góp bằng văn bản. Đoạn chuyển động ngắn liên quan dễ dùng làm chỉ dẫn hơn tập dài sự kiện không liên quan. Giữ thời lượng và độ phân giải đầu ra dự kiến tường minh để so kết quả với cùng yêu cầu.

Kết quả hoàn thiện

Quy trình bất đồng bộ của nhà sản xuất trả danh tính tác vụ trước khi video hoàn tất có sẵn. Giao diện truy vấn lấy tác vụ trong bảy ngày trước. Lưu đoạn thực tế trả về và đặc tả để biên tập hoặc xem xét thêm; mã tác vụ không phải sản phẩm âm thanh–hình ảnh. Địa chỉ tải có hạn thời gian, nên giữ chính tệp khi lưu kết quả đã chọn.

Xem xét tính liên tục chủ thể, chuyển động, chữ nhìn thấy, hội thoại và thời điểm âm thanh ở kích thước đoạn sẽ dùng. Dùng phản hồi cụ thể cho yêu cầu sáng tạo khác: cử chỉ đã đổi, câu bị bỏ hoặc bố cục cần chỉnh. Kết quả hữu ích là cú ngắn có hình và tiếng gắn với nội dung cung cấp và quan hệ tham chiếu tường minh.

**Ailoot Ultra · Video** `POST /v1/videos` `minimax/hailuo-3-max`

[`minimax/hailuo-3-max`](https://ailoot.ai/models/vi/#m=minimax%2Fhailuo-3-max&route=Ultra&caller=minimax%2Fhailuo-3-max&fmt=videos)

MiniMax /`minimax/hailuo-3-max`

### Bắt đầu

MiniMax H3 Max là biến thể H3 được hậu huấn luyện để tạo nhanh video ngắn có âm thanh đồng bộ. Quy trình MiniMax được mô tả hỗ trợ văn bản, ảnh khung và tham chiếu đa phương thức, với đầu ra 480P hoặc 768P, thời lượng 5–15 giây và lựa chọn mở rộng lời nhắc riêng.

Đầu vào được chấp nhận

Văn bản · Ảnh

Kết quả

Video

### Có trên Ailoot · đầu vào & phương thức

**Ailoot Ultra · Video** `POST /v1/videos`

Đầu vào

`text`, `image`

Đầu ra

`video`

Định dạng đầu ra

byte MP4 gốc; không chuẩn hóa hoặc chuyển mã

| Trường | Loại | Yêu cầu | Giá trị & giới hạn | Mặc định |
| --- | --- | --- | --- | --- |
| Trường`model` | Loại`string` | Yêu cầuBắt buộc | Giá trị & giới hạn minimax/hailuo-3-max | Mặc định— |
| Trường`prompt` | Loại`string` | Yêu cầuBắt buộc | Giá trị & giới hạn | Mặc định— |
| Trường`duration` | Loại`integer` | Yêu cầuBắt buộc | Giá trị & giới hạn 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Tối thiểu: 1 Tối đa: 600 | Mặc định— |
| Trường`resolution` | Loại`string` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 768p, 480p | Mặc định— |
| Trường`aspect_ratio` | Loại`string` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Mặc định— |
| Trường`generate_audio` | Loại`boolean` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn false | Mặc định— |
| Trường`frame_images` | Loại`array` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Số mục tối thiểu: 1 Số mục tối đa: 2 Nội dung đầu vào: Mảng đối tượng khung hình. Mỗi đối tượng có type=image\_url, image\_url chứa url và frame\_type. Dùng URL ảnh HTTPS và đặt frame\_type thành first\_frame hoặc last\_frame. Mỗi vai trò khung hình xuất hiện tối đa một lần. Khóa chính xác: type, image\_url, frame\_type Điều kiện: Các khóa này mô tả từng đối tượng khung hình; image\_url chỉ chứa url. Bỏ frame\_images đối với yêu cầu chỉ có văn bản. | Mặc định— |
| Trường`input_references` | Loại`array` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |
| Trường`callback_url` | Loại`string` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Mẫu: ^https:// | Mặc định— |
| Trường`session_id` | Loại`string` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |
| Trường`trace` | Loại`object` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |
| Trường`user` | Loại`string` | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |

Tổ hợp tư liệu đầu vào

**Văn bản thành video** · Câu lệnh dạng văn bản. · Bắt buộc: model, prompt, duration

`Cung cấp prompt dạng văn bản và duration là số giây nguyên. Chọn độ phân giải được hỗ trợ và tỷ lệ khung hình nếu cần.`

`model`: Loại: string · minimax/hailuo-3-max

`prompt`: Loại: string · Số byte UTF-8 tối đa: 10.000 · Bắt buộc có ký tự không phải khoảng trắng: Có

**Ảnh thành video** · Câu lệnh dạng văn bản và ảnh khung hình đầu tiên. · Bắt buộc: model, prompt, duration, frame\_images

`frame_images là một mảng. Mỗi đối tượng khung hình có type, image_url và frame_type; image_url chứa url. Đặt type thành image_url. Dùng first_frame cùng last_frame tùy chọn. Mỗi vai trò khung hình xuất hiện tối đa một lần. Cung cấp URL ảnh HTTPS công khai cho mỗi khung hình. Chọn độ phân giải được hỗ trợ và tỷ lệ khung hình nếu cần.`

Khóa chính xác: type, image\_url, frame\_type

`model`: Loại: string · minimax/hailuo-3-max

`prompt`: Loại: string · Số byte UTF-8 tối đa: 10.000 · Bắt buộc có ký tự không phải khoảng trắng: Có

Tham số phương thức và vòng đời

| Tham số | Hợp đồng |
| --- | --- |
| Tham số`content_type` | Hợp đồngapplication/json |
| Tham số`required` | Hợp đồngmodel, prompt, duration |
| Tham số`material_types` | Hợp đồngtext, image |
| Tham số`additional_properties` | Hợp đồngfalse |
| Tham số`optional_controls` | Hợp đồngresolution, aspect\_ratio, generate\_audio, frame\_images, input\_references, callback\_url, session\_id, trace, user |

Vòng đời: `submit_once_poll_original`

`GET /v1/videos/{public_id}`

`GET /v1/videos/{public_id}/content`

### Bảng giá

##### Cách tính phí cuối cùng

Các đơn giá hiển thị dùng để ước tính chi phí trước khi tạo. Khoản phí cuối cùng được tính dựa trên chi phí ghi nhận cho lượt tạo gốc. Thời lượng đầu ra đo được và số lượng dự kiến không phải là số lượng cuối cùng dùng để tính phí.

Thông tin biểu giá không bổ sung tùy chọn yêu cầu. Các tham số được hỗ trợ nằm trong phương thức đã chọn.

Chế độ nhanh

Chưa chỉ định Khi chọn chế độ nhanh

Chế độ Flex

Chưa chỉ định Khi chọn chế độ flex

Mức độ suy luận tối đa

Chưa chỉ định Khi áp dụng mức điều chỉnh mặc định (default) cho mức độ suy luận tối đa

#### Mức phí ước tính để so sánh

#### Giá theo cấu hình

Đối chiếu từng khoản phí với điều kiện hiển thị. Dùng một mức phí cho mỗi nhóm cấu hình thay thế.

| Cấu hình | Biểu mức phí | Số lượng dự báo | Thành phần phí | Đơn vị tính phí | Điều kiện tính phí | Phí |
| --- | --- | --- | --- | --- | --- | --- |
| Cấu hìnhGiá cơ sở cho token | Biểu mức phíMức phí cơ bản | Số lượng dự báo— | Thành phần phí— | Đơn vị tính phí— | Điều kiện tính phí— | Phí Đầu vào · Token đầu vào · Ước tính chỉ để so sánh **—** / 1K token Đầu ra · Token đầu ra · Ước tính chỉ để so sánh **—** / 1K token Đầu vào · Đọc bộ nhớ đệm · Ước tính chỉ để so sánh **—** / 1K token Đầu vào · Ghi bộ nhớ đệm · Ước tính chỉ để so sánh **—** / 1K token Đầu vào · Ghi bộ nhớ đệm, 1 giờ · Ước tính chỉ để so sánh **—** / 1K token |
| Cấu hìnhVideo đầu ra · đơn giá tham chiếu | Biểu mức phí— | Số lượng dự báo— | Thành phần phí`reference_output_rate` | Đơn vị tính phímỗi giây đầu ra | Điều kiện tính phí— | Phí Đầu ra · Đơn giá tham chiếu cho mỗi giây video đầu ra · Ước tính chỉ để so sánh **$0.16** mỗi giây đầu ra |
| Cấu hìnhGiá video | Biểu mức phí— | Số lượng dự báo— | Thành phần phí— | Đơn vị tính phímỗi giây video | Điều kiện tính phíresolution: 480p | Phí Đầu ra · Giá video · Ước tính chỉ để so sánh **$0.1** mỗi giây video |
| Cấu hìnhGiá video | Biểu mức phí— | Số lượng dự báo— | Thành phần phí— | Đơn vị tính phímỗi giây video | Điều kiện tính phíresolution: 768p | Phí Đầu ra · Giá video · Ước tính chỉ để so sánh **$0.16** mỗi giây video |
| Cấu hìnhChi phí tạo ước tính | Biểu mức phí— | Số lượng dự báoước tính cho một lần tạo | Thành phần phí— | Đơn vị tính phí— | Điều kiện tính phí— | Phí Đầu ra · Chi phí tạo ước tính · Ước tính chỉ để so sánh **$0.5** ước tính trước khi tạo Ước tính này không phải là khoản phí bổ sung hay mức giá cố định cho lượt tạo đã hoàn tất. |

Ailoot tạm giữ một khoản ước tính trước yêu cầu. Sau khi có kết quả, phí cuối cùng được quyết toán theo mức sử dụng đo được. Việc quyết toán khi truyền luồng dùng bản ghi mức sử dụng cuối cùng. [Cách hoạt động của cơ chế tạm giữ và quyết toán →](https://ailoot.ai/docs/vi/billing/reserve/)

#### Chi tiết giá cước tham chiếu

Biểu tham chiếu cấp mô hình không thay đổi việc chọn phương thức, báo giá hoặc khoản phí. Khoản phí đang áp dụng dùng mức phí phương thức Ailoot đã chọn.

Tham chiếu giá theo cấu hình video

#### Giá theo cấu hình

Đối chiếu từng khoản phí với điều kiện hiển thị. Dùng một mức phí cho mỗi nhóm cấu hình thay thế.

| Cấu hình | Điều kiện tính phí | Phí |
| --- | --- | --- |
| Cấu hìnhGiá video | Điều kiện tính phíKhông có điều kiện bổ sung nào được khai báo trong khóa định giá này. | Phí Đầu ra · Giá video **$0.16** mỗi giây video Giá tham khảo được công bố cho cấu hình đang hiển thị. Khoản phí cuối cùng dựa trên cấu hình thực tế được ghi nhận khi tính phí. |
| Cấu hìnhGiá video | Điều kiện tính phíresolution: 480p | Phí Đầu ra · Giá video **$0.1** mỗi giây video Giá tham khảo được công bố cho cấu hình đang hiển thị. Khoản phí cuối cùng dựa trên cấu hình thực tế được ghi nhận khi tính phí. |
| Cấu hìnhGiá video | Điều kiện tính phíresolution: 768p | Phí Đầu ra · Giá video **$0.16** mỗi giây video Giá tham khảo được công bố cho cấu hình đang hiển thị. Khoản phí cuối cùng dựa trên cấu hình thực tế được ghi nhận khi tính phí. |

### Ví dụ yêu cầu

#### Ailoot Ultra · Video

curl · tạo video

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"minimax/hailuo-3-max","prompt":"A serene mountain landscape at sunset","resolution":"480p"}', encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
```

### Nhận và lưu kết quả

#### Ailoot Ultra · Video

các URL nội dung đã ký thuộc quyền sở hữu

- `GET /v1/videos/{public_id}`
- `GET /v1/videos/{public_id}/content`

##### Kiểm tra trạng thái tác vụ

GET trạng thái thao tác gốc

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
```

Lượt đọc nội dung khác

Lưu mọi đầu ra đã hoàn tất thuộc về bạn

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
    if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
    urls.append((str(i),u))
for label,path in urls:
    u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
    if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
    target=Path('owned-'+label+'.bin')
    subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
```

##### Lưu tất cả kết quả đã hoàn tất

Lưu mọi video đã hoàn tất hoặc tệp trả về; truy xuất từng URL tài nguyên thực tế được trả về.

Giữ lại mọi đầu ra thực tế thuộc quyền sở hữu và siêu dữ liệu đo lường được trả về.

##### Nếu cần kiểm tra phản hồi gốc

503 result\_pending\_check + id ban đầu + X-Should-Retry:false; tuyệt đối không gửi lại yêu cầu ban đầu

Trường phản hồi

| Trường | Loại | Ý nghĩa |
| --- | --- | --- |
| Trường`index` | Loạiinteger | Ý nghĩaVị trí bắt đầu từ không của video này trong danh sách outputs. |
| Trường`content_url` | Loạistring | Ý nghĩaURL tải xuống HTTPS đã ký cho video đã hoàn tất này. |
| Trường`sha256` | Loạistring \| null | Ý nghĩaGiá trị băm SHA-256 của các byte video gốc; null nếu không có dữ liệu. |
| Trường`size_bytes` | Loạiinteger \| null | Ý nghĩaDung lượng tệp video gốc tính bằng byte; null nếu không có dữ liệu. |
| Trường`duration_ms` | Loạiinteger \| null | Ý nghĩaThời lượng video đo được tính bằng mili giây; null nếu không có dữ liệu. |
| Trường`width` | Loạiinteger \| null | Ý nghĩaChiều rộng video tính bằng pixel; null nếu không có dữ liệu. |
| Trường`height` | Loạiinteger \| null | Ý nghĩaChiều cao video tính bằng pixel; null nếu không có dữ liệu. |
| Trường`video_codec` | Loạistring \| null | Ý nghĩaMã định danh codec video; null nếu chưa được ghi nhận. |
| Trường`has_audio` | Loạiboolean \| null | Ý nghĩaVideo có chứa bản âm thanh hay không; null nếu chưa được đo. |
| Trường`audio_codec` | Loạistring \| null | Ý nghĩaMã định danh codec âm thanh; null khi chưa ghi nhận mã định danh. |

Lỗi và bước tiếp theo

| Phản hồi | Điều kiện | Bước tiếp theo |
| --- | --- | --- |
| Phản hồi404 · `not_found_error` | Điều kiệnKhông thể truy cập video hoặc không tìm thấy ID video này. | Bước tiếp theoKiểm tra quyền truy cập video. Với video hiện có, dùng ID công khai ban đầu và cùng khóa API. |
| Phản hồi401 · `authentication_error` | Điều kiệnKhóa API không khớp với tài khoản đã xác thực. | Bước tiếp theoKiểm tra khóa API và quyền truy cập tài khoản trước khi gửi. |
| Phản hồi400 · `invalid_request_error` | Điều kiệnKhông thể đọc yêu cầu hoặc chỉ số tải xuống không hợp lệ. | Bước tiếp theoSửa nội dung yêu cầu. Để tải xuống, chọn một chỉ số đầu ra được tác vụ ban đầu trả về. |
| Phản hồi422 · `price_unavailable` | Điều kiệnKhông thể định giá cấu hình video đã chọn. | Bước tiếp theoChọn cấu hình video được hỗ trợ và điền đầy đủ các tùy chọn bắt buộc trước khi gửi yêu cầu đã sửa. |
| Phản hồi422 · `invalid_request_error` | Điều kiệnĐầu vào video hoặc tác vụ tiếp nối ban đầu không hợp lệ. | Bước tiếp theoDùng đầu vào HTTPS hợp lệ. Để tiếp nối, dùng ID video công khai ban đầu đã hoàn tất của bạn với cùng khóa API. |
| Phản hồi402 · `billing_error` | Điều kiệnSố dư khả dụng hoặc các giới hạn không cho phép giữ trước số tiền. | Bước tiếp theoKiểm tra số dư khả dụng và các giới hạn trước khi gửi yêu cầu mới. |
| Phản hồi503 · `server_error` | Điều kiệnTạm thời không thể xác minh video, lưu trữ hoặc truy cập dịch vụ. | Bước tiếp theoĐợi dịch vụ khả dụng. Nếu đã có ID video, kiểm tra tác vụ ban đầu đó thay vì tạo thêm video. |
| Phản hồi503 · `result_pending_check` | Điều kiệnKết quả video và khoản phí ban đầu cần được kiểm tra. | Bước tiếp theoGiữ lại ID video được trả về và kiểm tra tác vụ đó. Không gửi yêu cầu tạo thay thế trong khi tác vụ đang được kiểm tra. |
| Phản hồi503 · `owned_result_unavailable` | Điều kiệnTạm thời không thể tải xuống video hiện có. | Bước tiếp theoKiểm tra lại cùng tác vụ video sau và tải xuống đầu ra hiện có. Một lần tạo mới sẽ tạo thao tác riêng. |
| Phản hồi409 · `video_not_ready` | Điều kiệnNội dung video chưa được công bố. | Bước tiếp theoKiểm tra trạng thái tác vụ ban đầu. Tải xuống sau khi trạng thái là completed; nếu là failed, làm theo thông báo kiểm tra khoản phí. |

### Bí danh

#### Bí danh mô hình

**Ailoot Ultra** [`minimax/hailuo-3-max`](https://ailoot.ai/models/vi/#m=minimax%2Fhailuo-3-max&route=Ultra&caller=minimax%2Fhailuo-3-max&fmt=videos)

#### Bí danh đường dẫn phương thức

Dùng các đường dẫn phương thức hiển thị ở trên.

#### ID gọi liên quan

[`minimax/hailuo-3-max`](https://ailoot.ai/models/vi/#m=minimax%2Fhailuo-3-max&route=Ultra&caller=minimax%2Fhailuo-3-max&fmt=videos)

FAQ · MiniMax: H3 Max

Có những đầu vào và kết quả nào?

`POST /v1/videos` · `minimax/hailuo-3-max`: `text`, `image` → `video`

Yêu cầu sử dụng những trường nào?

`POST /v1/videos` · `minimax/hailuo-3-max`: `model`, `prompt`, `duration`, `resolution`, `aspect_ratio`, `generate_audio`, `frame_images`, `input_references`, `callback_url`, `session_id`, `trace`, `user`

Áp dụng những giới hạn nào?

`POST /v1/videos` · `minimax/hailuo-3-max`: `duration.minimum`: `1`; `duration.maximum`: `600`; `frame_images.max_items`: `2`; `frame_images.min_items`: `1`

Kết nối Ailoot với Claude Code, OpenCode, Hermes hoặc ứng dụng của bạn.

## Công ty và danh mục dự án của công ty

Công ty và danh mục dự án của công ty: hàng triệu khách hàng; doanh số hàng tỷ mỗi tháng.

## Mua token với giá ưu đãi.

Ưu đãi thuê bao cho nhu cầu thường xuyên. Mã khuyến mãi giảm đến 50% khi mua token.

Thuê bao

Chọn gói ưu đãi cho các yêu cầu thường xuyên của bạn.

Mã giảm đến 50%

Nhập mã khi mua. Giá được tính lại theo chương trình đang áp dụng.

Chi phí trong lịch sử

Mô hình, token và số tiền được lưu cho mỗi yêu cầu.

[Chọn gói thuê bao](https://ailoot.ai/docs/vi/billing/subscriptions/) · [Xem giá mô hình](https://ailoot.ai/models/vi/)

## Kết nối API vào sản phẩm bạn đang bán.

SaaS, ứng dụng và bot — theo đề nghị giao kết chính thức và thỏa thuận cấp phép Ailoot. Muốn bán lại, hãy yêu cầu giấy phép bán lại.

Ứng dụng thương mại

Tích hợp tạo văn bản, ảnh, video và âm thanh vào các tính năng trả phí của dịch vụ.

Giấy phép bán lại

Gửi mô tả dự án và cách cung cấp quyền truy cập. Yêu cầu điều khoản sử dụng và bán lại bằng văn bản.

Tài liệu trên website

Đề nghị giao kết, thỏa thuận cấp phép và chính sách xử lý dữ liệu có sẵn trước khi kết nối.

[Yêu cầu giấy phép bán lại](mailto:support@ailoot.ai) · [Đề nghị giao kết và thỏa thuận cấp phép](https://ailoot.ai/legal/offer?lang=vi)

## Ailoot · Công ty và danh mục dự án của công ty





Ailoot dựa trên kinh nghiệm vận hành tích lũy, cơ sở khách hàng lớn, dịch vụ ổn định và việc kiểm soát KPI liên tục.





Công ty và danh mục dự án của công ty: hàng triệu khách hàng; doanh số hàng tỷ mỗi tháng.





Ailoot áp dụng kinh nghiệm vận hành này để cung cấp quyền truy cập API vào các tính năng AI trong sản phẩm của khách hàng, tác tử, ứng dụng và quy trình tự động hóa.
