Hailuo 2.3 Fast
MiniMax Hailuo 2.3 Fast tạo chuyển động từ ảnh khung đầu bằng lời nhắc chuyển động ngắn. Chọn cấu hình chuyển ảnh thành video này cho cú máy sản phẩm, tư thế nhân vật hoặc ảnh tĩnh storyboard.
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.
MiniMax Hailuo 2.3 Fast là cấu hình Fast có tên cho tạo video từ ảnh. Bắt đầu bằng ảnh khung đầu đã bố cục và mô tả chủ thể hoặc máy quay nên chuyển động ra sao. Ảnh sản phẩm tĩnh, tư thế nhân vật hoặc khung storyboard cho cú máy điểm đầu hình ảnh cụ thể.
Chuẩn bị ảnh và yêu cầu chuyển động
Cung cấp ảnh PNG hoặc JPEG vuông qua URL HTTPS, với mỗi cạnh từ 300 đến 4,096 pixel. Tệp ảnh tải về không được lớn hơn 20,000,000 byte. Giữ lời nhắc từ 1 đến 199 ký tự, tập trung một hành động nhìn thấy và chuyển động quan trọng với cú máy.
Theo dõi đoạn đến khi hoàn tất
Cấu hình này được thiết lập cho một đoạn MP4 768 × 768 với thời lượng danh nghĩa sáu giây. Gửi yêu cầu một lần, lưu ID trả về và theo dõi yêu cầu gốc đó đến hoàn tất. Tải video trả về và lưu kích thước được báo cùng thời lượng đo được với kết quả. Nếu kết quả tạo chưa chắc chắn, tiếp tục kiểm tra yêu cầu gốc thay vì tạo lại.
Ailoot Ultra · Video POST /v1/videos MiniMax-Hailuo-2.3-Fast
MiniMax-Hailuo-2.3-FastBắt đầu
MiniMax Hailuo 2.3 Fast tạo chuyển động từ ảnh khung đầu bằng lời nhắc chuyển động ngắn. Chọn cấu hình chuyển ảnh thành video này cho cú máy sản phẩm, tư thế nhân vật hoặc ảnh tĩnh storyboard.
- Đầ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
- mp4
- Số đầu ra
- Tối đa 1 đầu ra
| Trường | Loại | Yêu cầu | Giá trị & giới hạn | Mặc định |
|---|---|---|---|---|
Trườngmodel | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn MiniMax-Hailuo-2.3-Fast | Mặc định— |
Trườngprompt | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn Độ dài tối thiểu: 1 Độ dài tối đa: 199 Đơn vị: ký tự Unicode | Mặc định— |
Trườngduration | Loạiinteger | Yêu cầuBắt buộc | Giá trị & giới hạn 6 Đơn vị: giây | Mặc định— |
Trườngresolution | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn 768P | Mặc định— |
Trườngfirst_frame_image | Loạihttps_url | Yêu cầuBắt buộc | Giá trị & giới hạn Số byte tối đa của tệp: 20.000.000 Loại MIME: image/png, image/jpeg Kích thước tối thiểu: 300 Kích thước tối đa: 4.096 Chỉ hình vuông: Có | Mặc định— |
Tổ hợp tư liệu đầu vào
Ảnh thành video · Bắt buộc: prompt, first_frame_image
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, resolution, first_frame_image |
Tham sốother_options | Hợp đồngfalse |
Tham sốduration | Hợp đồng6 |
Tham sốresolution | Hợp đồng768P |
Tham sốprompt_max_characters | Hợp đồng199 |
Tham sốfirst_frame_image | Hợp đồng{"type":"https_url","format":["png","jpeg"],"dimensions":"ảnh vuông 300..4096 pixel","full_image_validation_before_send":true,"maximum_file_bytes":20000000} |
Tham sốmaterial_types | Hợp đồngtext, image |
Tham sốadditional_properties | Hợp đồngfalse |
Bí danh phương thức: /v1/videos/generations, /videos, /videos/generations
Vòng đời: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
Tạo một lần và lưu ID được trả về.
Thăm dò trạng thái ban đầu; giữ lại mọi tài sản đã hoàn tất và thời lượng.
Bảng giá
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í Ailoot
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í | Thời lượng danh nghĩa của đoạn, giây | Độ phân giải | Đơn vị tính phí | Phí |
|---|---|---|---|---|---|
| Cấu hìnhGiá cơ sở cho token | Biểu mức phíMức phí cơ bản | Thời lượng danh nghĩa của đoạn, giây— | Độ phân giải— | Đơn vị tính phí— | Phí Đầu vào · Token đầu vào — / 1K token Đầu ra · Token đầu ra — / 1K token Đầu vào · Đọc bộ nhớ đệm — / 1K token Đầu vào · Ghi bộ nhớ đệm — / 1K token Đầu vào · Ghi bộ nhớ đệm, 1 giờ — / 1K token |
| Cấu hìnhUltra | Biểu mức phí— | Thời lượng danh nghĩa của đoạn, giây6 | Độ phân giải768P | Đơn vị tính phímỗi đoạn đầu ra có độ dài danh định 6s | Phí Đầu ra · Đoạn clip đầu ra danh định 6s $0.4 mỗi đoạn đầu ra có độ dài danh định 6s |
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 →
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.
MiniMax-Hailuo-2.3-Fast
Giá theo cấu hình
| Cấu hình | Điều kiện tính phí | Phí |
|---|---|---|
| Cấu hìnhMiniMax-Hailuo-2.3-Fast · Cấu hình mặc định | Điều kiện tính phíCấu hình mặc định | Phí Đầu vào · Đầu vào 0,00 US$ mỗi lần gọi Đầu ra · Đầu ra 0,40 US$ mỗi lần gọi |
MiniMax-Hailuo-2.3-Fast
Giá theo cấu hình
| Cấu hình | Điều kiện tính phí | Phí |
|---|---|---|
| Cấu hìnhMiniMax-Hailuo-2.3-Fast · Cấu hình mặc định | Điều kiện tính phíCấu hình mặc định | Phí Đầu vào · Đầu vào 0,00 US$ mỗi lần gọi Đầu ra · Đầu ra 0,80 US$ mỗi lần gọi |
MiniMax-Hailuo-2.3-Fast
Giá theo cấu hình
| Cấu hình | Điều kiện tính phí | Phí |
|---|---|---|
| Cấu hìnhMiniMax-Hailuo-2.3-Fast · Cấu hình mặc định | Điều kiện tính phíCấu hình mặc định | Phí Đầu vào · Đầu vào 0,00 US$ mỗi lần gọi Đầu ra · Đầu ra 0,80 US$ mỗi lần gọi |
Ví dụ yêu cầu
Ailoot Ultra · Video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_IMAGE_URL:?Set the actual HTTPS first-frame image URL}"
export AILOOT_IMAGE_URL
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "MiniMax-Hailuo-2.3-Fast", "prompt": "A cat in a spacesuit walking on the Moon", "duration": 6, "resolution": "768P"}')
from urllib.parse import urlsplit
u=os.environ["AILOOT_IMAGE_URL"]
z=urlsplit(u)
if z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Choose the actual HTTPS first-frame image URL")
p["first_frame_image"]=u
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
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
Nhận và lưu kết quả
Ailoot Ultra · Video
mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Kiểm tra trạng thái tác vụ
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
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ề.
data[] khi hoàn tất chứa tất cả URL nội dung đã ký thuộc quyền sở hữu. Truy xuất từng URL được trả về, hoặc dùng điểm cuối nội dung với index đặt thành một chỉ số đầu ra thực tế. Tác vụ gốc thất bại có thể trả về charge_pending_check; kiểm tra tác vụ gốc đó thay vì tạo lại.
Nếu cần kiểm tra phản hồi gốc
Đọc tác vụ gốc hiện có; tuyệt đối không gửi lại lần gửi chưa rõ kết quả.
Số đầu ra tối đa: 1.
Trường phản hồi
| Trường | Loại | Ý nghĩa |
|---|---|---|
Trườngid | Loạistring | Ý nghĩa— |
Trườngobject | Loạistring | Ý nghĩa— |
Trườngmodel | Loạistring | Ý nghĩa— |
Trườngstatus | Loạistring | Ý nghĩa— |
Trườngdata[] | Loạisigned content URL | Ý nghĩa— |
Trườngcharge_pending_check | Loạiboolean | Ý nghĩa— |
Trườngerror.code | Loạistring | Ý nghĩa— |
Trườngerror.message | Loạistring | Ý nghĩa— |
Trườngrequested_nominal_duration_seconds | Loạiinteger | Ý nghĩa— |
Trườngmeasured_duration_seconds | Loạinumber | Ý nghĩa— |
Trườngwidth | Loạiinteger | Ý nghĩa— |
Trườngheight | Loạiinteger | Ý nghĩa— |
Trườngoperation_id | Loạistring | Ý nghĩaĐược trả về khi status=unknown; ID thao tác video công khai ban đầu thực tế |
Trườngrequest_id | Loạistring | Ý nghĩaTùy chọn khi status=unknown; chỉ được trả về nếu tác vụ ban đầu có ID yêu cầu |
Lỗi và bước tiếp theo
| Phản hồi | Điều kiện | Bước tiếp theo |
|---|---|---|
Phản hồi400 · invalid_request_error | Điều kiệnKhông thể đọc nội dung yêu cầu thô trước khi phân tích hồ sơ video | Bước tiếp theoGiữ lại phản hồi được trả về và sửa nội dung yêu cầu không đọc được. |
Phản hồi422 · price_unavailable | Điều kiệnKhông thể phân tích hồ sơ video chính xác, hoặc hồ sơ đã phân tích đầy đủ chưa có bảng giá sẵn sàng áp dụng khớp chính xác với hồ sơ đó | Bước tiếp theoGiữ lại phản hồi; dùng hồ sơ đầy đủ, chính xác đã được cho phép và bảng giá đã công bố của hồ sơ đó. Nhánh này chạy trước khi gửi đến nhà cung cấp. |
Phản hồi409 · video_not_ready | Điều kiệnNội dung kết quả ban đầu chưa có sẵn | Bước tiếp theoThăm dò ID ban đầu được trả về và tuân thủ Retry-After. |
Phản hồiserver_error | Điều kiệnPhản hồi trả về cho biết thao tác hoặc kết quả cần được kiểm tra | Bước tiếp theoGiữ lại ID thao tác/tác vụ gốc đã trả về, các header của yêu cầu và toàn bộ phản hồi; tiếp tục truy xuất thao tác gốc đó bằng các phương thức được hỗ trợ. Không gửi lại yêu cầu tạo. |
Phản hồi200 · video_result_unverified | Điều kiệnKhông rõ trạng thái tác vụ Fast ban đầu; status=unknown và charge_pending_check=true | Bước tiếp theoGiữ lại id/operation_id thực tế được trả về và request_id tùy chọn; chỉ đọc tác vụ ban đầu. Tuyệt đối không gửi lại. |
Bí danh
Bí danh mô hình
Ailoot Ultra MiniMax-Hailuo-2.3-Fast
Bí danh đường dẫn phương thức
/v1/videos/generations, /videos, /videos/generations
ID gọi liên quan
FAQ · Hailuo 2.3 Fast
- Có những đầu vào và kết quả nào?
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:text,image→video- Yêu cầu sử dụng những trường nào?
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:model,prompt,duration,resolution,first_frame_image- Áp dụng những giới hạn nào?
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:prompt.maximum_length:199