MiniMax-Hailuo-2.3
MiniMax Hailuo 2.3 tạo video từ văn bản hoặc ảnh bắt đầu, với điều khiển chuyển động và hướng máy quay. Chọn sáu giây ở 768P hoặc 1080P, hoặc mười giây ở 768P, cho diễn xuất nhân vật, cảnh cách điệu và cú sản phẩm có thể xem xét, biên tập.
- Ailoot · Tạo video
POST /v1/videos/generationsMiniMax-Hailuo-2.3 - Ailoot Ultra · Video
POST /v1/videosMiniMax-Hailuo-2.3
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 là mô hình tạo video với chế độ chuyển văn bản và ảnh thành video. Mô hình phát triển từ Hailuo 02, tập trung hành động vật lý, phong cách hình ảnh, vi biểu cảm nhân vật và phản hồi chỉ dẫn chuyển động. Cung cấp mô tả cảnh bằng văn bản để tạo cú máy từ đầu, hoặc dùng ảnh bắt đầu xác lập góc mở và mô tả chuyển động theo sau.
Diễn xuất vật lý là một mặt cải thiện chính của phiên bản. Hailuo 2.3 hướng đến chuyển động cơ thể mượt và có điều khiển hơn, gồm cảnh có máy quay chuyển động. Lên kế hoạch hành động quan trọng trước chi tiết trang trí. Nhân vật nhấc vật, quay sang người khác hoặc đi qua phòng tạo cho cú máy một sự kiện có thể quan sát để đánh giá. Quyết định chuyển động nào gánh câu chuyện rồi giữ chỉ dẫn xung quanh nhất quán với nó.
Cách điệu là trọng tâm khác. Mô hình hỗ trợ anime, minh họa và phong cách như tranh thủy mặc, CG game. Mô tả cách thể hiện mong muốn và giữ diện mạo mạch lạc với cảnh. Nếu ảnh bắt đầu đã xác lập phong cách vẽ, dùng văn bản hướng dẫn tạo chuyển động thay vì thêm mô tả thiết kế nhân vật cạnh tranh. Xem toàn đoạn để đánh giá cách thể hiện đó còn dễ đọc khi chuyển động.
Mô hình còn tập trung diễn xuất mặt và thay đổi biểu cảm tinh tế. Chuẩn bị cú nhân vật quanh phản ứng quan trọng: nhận thấy vật, tò mò hoặc đáp bằng nụ cười nhẹ. Góc cận giúp đánh giá thay đổi, còn chuỗi cử chỉ lớn có thể làm phân tâm. Kiểm tra mặt trước, trong và sau phản ứng thay vì chỉ đánh giá ảnh tĩnh đại diện.
Chuyển động vật hữu ích cho cảnh lấy sản phẩm làm trung tâm. Yêu cầu ban đầu có thể cho bình gốm nhỏ xoay trong ánh sáng ấm bên hông khi máy quay từ từ tiến gần. Xác định thuộc tính phải còn nhận ra như đường dáng, vành và bề mặt hoàn thiện. Xem các chi tiết qua chuyển động, vì không khí thuyết phục tự nó không xác lập góc sản phẩm trung thành.
Với chuyển văn bản thành video, mô tả bắt buộc có thể đến 2,000 ký tự. Nêu chủ thể, hành động, bối cảnh và phong cách theo thứ tự mạch lạc. Chuyển ảnh thành video đòi ảnh khung đầu, với mô tả tùy chọn đến 2,000 ký tự. Ảnh cố định bố cục mở, nên chuẩn bị chủ thể và bố cục trước yêu cầu chuyển động. Chừa khoảng nhìn thấy nơi tay, vật hoặc nhân vật cần đi qua.
Ảnh bắt đầu nhận JPG, JPEG, PNG hoặc WebP, phải nhỏ hơn 20 MB, cạnh ngắn lớn hơn 300 pixel và tỷ lệ từ 2:5 đến 5:2. Có thể cung cấp bằng URL ảnh công khai hoặc URL dữ liệu Base64. Chọn ảnh mở rõ thay vì dựa hoạt hình sửa mặt che khuất hoặc hành động đã bị cắt.
Hailuo 2.3 tạo ở 24 khung mỗi giây. Cú sáu giây có thể dùng 768P hoặc 1080P; cú mười giây dùng 768P. Mặc định là sáu giây và 768P. Chọn độ dài cho hành động cần thấy: phản ứng ngắn có thể vừa cú ngắn, chuyển động chậm cần thêm chỗ. Đọc chiều rộng và cao thực tế kết quả hoàn tất khi đặt vào bản biên tập, vì nhãn độ phân giải chưa phải toàn quyết định bố cục.
Chỉ đạo máy quay có thể dùng lệnh ngoặc vuông. Điều khiển có sẵn bao quát di chuyển ngang, lia, tiến máy, nâng hạ máy, ngửa cúi, zoom, rung, bám và cú tĩnh. Lệnh như [Push in] chỉ đạo tiến gần; lệnh gộp trong cùng ngoặc hoạt động cùng nhau, lệnh đặt theo thứ tự mô tả chuỗi. MiniMax khuyến nghị tối đa ba lệnh đồng thời. Giữ chuyển động máy quay tương thích hành động chủ thể để sự kiện chính dễ theo dõi.
Tối ưu lời nhắc tự động bật mặc định và có thể tắt để kiểm soát câu chữ cung cấp sát hơn. Tiền xử lý nhanh tùy chọn giảm thời gian tối ưu khi tối ưu được bật; đó là thiết lập riêng với chọn mô hình Hailuo 2.3 Fast. Hailuo 2.3 tiêu chuẩn hỗ trợ cả hai chế độ tạo, còn Fast là phiên bản chuyển ảnh thành video riêng. Chọn phiên bản theo dự án bắt đầu chỉ từ văn bản hay khung có sẵn.
Quy trình tạo trả mã tác vụ bất đồng bộ rồi báo chuẩn bị, xếp hàng, xử lý, thành công hoặc thất bại. Khi thành công, kết quả cung cấp mã tệp và kích thước video thực tế, video hoàn tất được truy xuất để tải. Lưu đoạn khi địa chỉ tải còn hiệu lực. Tham chiếu tải video hiện tại của nhà sản xuất cho URL tải trả về thời hạn một giờ. Với chuỗi được biên tập, giữ từng cú với lời nhắc và ảnh bắt đầu để hướng sáng tạo đã chọn còn truy vết được khi sửa.
Xem xét hành động, tính liên tục vật lý, chi tiết mặt hoặc sản phẩm, phong cách và hành vi máy quay trong đoạn đã lưu. Xem toàn cú rồi kiểm tra đầu, cuối nơi nối tư liệu khác. Nếu yêu cầu chứa quá nhiều chuyển động cạnh tranh, đơn giản hóa hành động chính; nếu thiết kế mở không rõ, cải thiện ảnh bắt đầu. Chọn cú truyền đạt sự kiện dự kiến rồi thêm thuyết minh, tiêu đề và chuyển cảnh trong quy trình biên tập.
Ailoot · Tạo video POST /v1/videos/generations MiniMax-Hailuo-2.3
MiniMax-Hailuo-2.3Bắt đầu
MiniMax Hailuo 2.3 tạo video từ văn bản hoặc ảnh bắt đầu, với điều khiển chuyển động và hướng máy quay. Chọn sáu giây ở 768P hoặc 1080P, hoặc mười giây ở 768P, cho diễn xuất nhân vật, cảnh cách điệu và cú sản phẩm có thể xem xét, biên tập.
- Đầ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 · Tạo video POST /v1/videos/generations
- Đầu vào
text,image- Đầu ra
video- Định dạng đầu ra
- mp4
| 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 | 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: 2.000 Đơn vị: ký tự Unicode | Mặc định— |
Trườngduration | Loạiinteger | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 6, 10 Điều kiện: 10 giây cần 768P Đơn vị: giây | Mặc định6 |
Trườngresolution | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 768P, 1080P Điều kiện: 1080P yêu cầu 6 giây | Mặc định768P |
Trườngfirst_frame_image | Loạihttps_url|data_image_url | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Số byte tối đa sau giải mã: 20.971.520 Loại MIME: image/jpeg, image/png, image/webp Kích thước tối thiểu (không gồm ngưỡng): 300 Khoảng tỷ lệ khung hình: 2:5, 5:2 | Mặc định— |
Trườngprompt_optimizer | Loạiboolean | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |
Trườngfast_pretreatment | Loạiboolean | 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
Ảnh thành video · Bắt buộc: prompt, first_frame_image
Văn bản thành video · Bắt buộc: prompt
Tham số phương thức và vòng đời
| Tham số | Hợp đồng |
|---|---|
Tham sốmaterial_types | Hợp đồngtext, image |
Tham sốrequired | Hợp đồngnull |
Tham sốoptional_controls | Hợp đồngnull |
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
Cấu trúc phương thức và ID là chính xác; khả năng của nhà cung cấp tách biệt với việc cho phép tiếp nhận yêu cầu.
Bảng giá
Mức phí phương thức Ailoot
POST /v1/videos/generations- Đầu ra
- 0,28 US$ mỗi video 6 s ở 768p
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
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 · 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,60 US$ mỗi lần gọi |
MiniMax-Hailuo-2.3
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 · 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 1,20 US$ mỗi lần gọi |
MiniMax-Hailuo-2.3
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 · 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 1,20 US$ mỗi lần gọi |
Ví dụ yêu cầu
Ailoot · Tạo video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl https://api.ailoot.ai/v1/videos/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "MiniMax-Hailuo-2.3", "prompt": "A person walks slowly through a quiet garden as the camera tracks from the side.", "duration": 6, "resolution": "768P"}'Nhận và lưu kết quả
Ailoot · Tạo 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}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id" \
-H "Authorization: Bearer $AILOOT_API_KEY"Lượt đọc nội dung khác
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id/content" \
-H "Authorization: Bearer $AILOOT_API_KEY" \
--output video.mp4Lư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 mục dữ liệu/chỉ số đầu ra được trả về. content_url chỉ là mục đầu tiên; truy xuất mọi đường dẫn nội dung/tài sản thực tế. GET nội dung không có index không trả về tất cả đầu ra.
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ả.
Trường phản hồi
| Trường | Loại |
|---|---|
Trườngid | Loạistring |
Trườngobject | Loạistring |
Trườngmodel | Loạistring |
Trườngstatus | Loạistring |
Trườngcontent_url | Loạisigned URL |
Trườngdata[] | Loạisigned URL |
Trườngusage | Loạiobject |
Trườngresult_pending_check | Loạiboolean |
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ệnTrường bắt buộc, cách biểu diễn tài liệu hoặc giá trị tham số không hợp lệ | Bước tiếp theoSửa các trường được chỉ ra trước khi gửi yêu cầu tạo mới. |
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. |
Bí danh
Bí danh mô hình
Ailoot MiniMax-Hailuo-2.3
Ailoot Ultra MiniMax-Hailuo-2.3
Bí danh đường dẫn phương thức
/v1/videos/generations, /videos, /videos/generations
ID gọi liên quan
Ailoot Ultra · Video POST /v1/videos MiniMax-Hailuo-2.3
MiniMax-Hailuo-2.3Bắt đầu
MiniMax Hailuo 2.3 tạo video từ văn bản hoặc ảnh bắt đầu, với điều khiển chuyển động và hướng máy quay. Chọn sáu giây ở 768P hoặc 1080P, hoặc mười giây ở 768P, cho diễn xuất nhân vật, cảnh cách điệu và cú sản phẩm có thể xem xét, biên tập.
- Đầu vào được chấp nhận
- Văn bản
- 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- Đầ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 | 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: 2.000 Điều kiện: Với 768P: tối đa 2000 điểm mã Unicode. Với 1080P: ít hơn 200 điểm mã Unicode (tối đa 199). Câu lệnh phải chứa văn bản không phải ký tự khoảng trắng. Đơ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, 1080P | Mặc định— |
Tổ hợp tư liệu đầu vào
Văn bản thành video · Bắt buộc: prompt
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 |
Tham sốother_options | Hợp đồngfalse |
Tham sốduration | Hợp đồng6 |
Tham sốresolution | Hợp đồng768P, 1080P |
Tham sốprompt_max_characters | Hợp đồng2000 |
Tham sốmaterial_types | Hợp đồngtext |
Tham sốprompt_max_characters_by_resolution | Hợp đồng{"768P":2000,"1080P":199} |
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ải1080P | Đơ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 $1.2 mỗi đoạn đầu ra có độ dài danh định 6s |
| 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.6 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
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 · 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,60 US$ mỗi lần gọi |
MiniMax-Hailuo-2.3
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 · 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 1,20 US$ mỗi lần gọi |
MiniMax-Hailuo-2.3
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 · 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 1,20 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}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "MiniMax-Hailuo-2.3", "prompt": "A cat in a spacesuit walking on the Moon", "duration": 6, "resolution": "768P"}')
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
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "MiniMax-Hailuo-2.3", "prompt": "A cat in a spacesuit walking on the Moon", "duration": 6, "resolution": "1080P"}')
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}"
: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_OPERATION_ID
operation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/$operation_id" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o status.json
python3 - <<'PY_STATUS'
import json
from pathlib import Path
r=json.loads(Path("status.json").read_text())
print(json.dumps(r))
if r.get("status")=="completed":
for x in r.get("data",[]):print(x)
PY_STATUS
Lưu tất cả tài nguyên đã hoàn tất
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"
export AILOOT_STATUS_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
from urllib.parse import urlsplit,urljoin
f=Path(os.environ["AILOOT_STATUS_FILE"])
if not f.is_file():raise SystemExit("Choose the actual completed status file")
r=json.loads(f.read_text())
if r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")
urls=[]
for x in r["data"]:
if not isinstance(x,str) or "\n" in x or "\r" in x:raise SystemExit("Invalid asset path")
u=urljoin("https://api.ailoot.ai",x)
z=urlsplit(u)
if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")
urls.append(u)
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_REQUEST
index=0
while IFS= read -r asset_url; do
curl --fail-with-body --silent --show-error "$asset_url" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"
index=$((index + 1))
done < asset-urls.txt
Lượt đọc nội dung khác
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_OPERATION_ID
operation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/$operation_id/content" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4
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 |
|---|---|
Trườngid | Loạistring |
Trườngobject | Loạistring |
Trườngmodel | Loạistring |
Trườngstatus | Loạistring |
Trườngdata[] | Loạisigned content URL |
Trườngcharge_pending_check | Loạiboolean |
Trườngerror.code | Loạistring |
Trườngerror.message | Loạistring |
Trườngrequested_nominal_duration_seconds | Loạiinteger |
Trườngmeasured_duration_seconds | Loạinumber |
Trườngwidth | Loạiinteger |
Trườngheight | Loạiinteger |
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ệnTrường bắt buộc, cách biểu diễn tài liệu hoặc giá trị tham số không hợp lệ | Bước tiếp theoSửa các trường được chỉ ra trước khi gửi yêu cầu tạo mới. |
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. |
Bí danh
Bí danh mô hình
Ailoot MiniMax-Hailuo-2.3
Ailoot Ultra MiniMax-Hailuo-2.3
Bí danh đường dẫn phương thức
/v1/videos/generations, /videos, /videos/generations
ID gọi liên quan
FAQ · MiniMax-Hailuo-2.3
- Có những đầu vào và kết quả nào?
POST /v1/videos/generations·MiniMax-Hailuo-2.3:text,image→videoPOST /v1/videos·MiniMax-Hailuo-2.3:text→video- Yêu cầu sử dụng những trường nào?
POST /v1/videos/generations·MiniMax-Hailuo-2.3:model,prompt,duration,resolution,first_frame_image,prompt_optimizer,fast_pretreatmentPOST /v1/videos·MiniMax-Hailuo-2.3:model,prompt,duration,resolution- Áp dụng những giới hạn nào?
POST /v1/videos/generations·MiniMax-Hailuo-2.3:prompt.maximum_length:2000POST /v1/videos·MiniMax-Hailuo-2.3:prompt.maximum_length:2000