MiniMax: I2V 01
I2V 01 làm ảnh khung đầu được cung cấp chuyển động, với yêu cầu văn bản mô tả hành động là tùy chọn. Chuẩn bị bố cục mở đầu, chỉ dẫn chuyển động nhìn thấy và kiểm tra clip hoàn chỉnh về tính liên tục của chủ thể và khuôn hình.
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.
I2V 01 là phiên bản tạo video từ ảnh của MiniMax để phát triển chuyển động từ khung đầu được cung cấp. Ảnh xác lập chủ thể và bố cục mở đầu; prompt viết tùy chọn mô tả hành động tiếp theo. Dùng bản này khi hình ảnh khởi đầu đã có dưới dạng ảnh chụp, ảnh được tạo hoặc cảnh được chuẩn bị, và nhiệm vụ là biến hình đó thành chuỗi video ngắn.
Chọn khung đầu theo chuyển động muốn thể hiện. Ảnh sản phẩm cần cho thấy hình dạng và bề mặt phải tiếp tục nhận ra được. Ảnh chân dung cần rõ khuôn mặt và đủ chỗ cho cử chỉ được yêu cầu. Với môi trường, xác định yếu tố mang chuyển động như lá, nước hoặc người đi qua cảnh. Chuẩn bị bố cục trước khi tạo để hành động có điểm bắt đầu hữu ích.
Yêu cầu ảnh của nhà sản xuất là JPG, JPEG, PNG hoặc WebP, dưới 20 MB, cạnh ngắn lớn hơn 300 pixel. Tỷ lệ khung chấp nhận từ 2:5 đến 5:2. Trong quy trình của nhà sản xuất, có thể cung cấp khung đầu qua URL ảnh truy cập được hoặc dữ liệu ảnh mã hóa. Giữ tệp ảnh thực tế cùng bản ghi yêu cầu để bảo toàn điểm bắt đầu thị giác cho đối chiếu sau này.
Dùng mô tả văn bản để nêu chuyển động nhìn thấy, nhịp của nó và trạng thái kết thúc dự kiến. Chẳng hạn, cốc gốm trên bàn có thể giữ nguyên chỗ trong khi hơi nước bốc lên và rèm phía sau chuyển động nhẹ. Người có thể quay về phía cửa sổ rồi dừng. Cho chủ thể một hành động rõ ràng và giải thích đặc điểm nào cần nhìn thấy trong suốt hành động đó.
Prompt cho phép tối đa 2 000 ký tự. Viết chi tiết hữu ích theo thứ tự tự nhiên: chủ thể, hành động, bối cảnh và góc nhìn. Khi ảnh đã xác lập cảnh, dùng văn bản để làm rõ chuyển động thay vì nhắc lại từng vật thể nhìn thấy. Chỉ dẫn ngắn về hướng và mức độ cử chỉ có thể hữu ích hơn nhiều tính từ chung về chất lượng điện ảnh.
Bảng tạo video từ ảnh đời trước của nhà sản xuất liệt kê 720P là mặc định cho I2V 01 và không liệt kê lựa chọn mười giây cho phiên bản này. Giữ thiết lập đầu ra đã chọn gắn với clip và đánh giá thời gian thực tế của kết quả. Chuẩn bị cảnh quay có hành động chính hiểu được như một chuỗi ngắn, với trạng thái mở đầu và kết thúc hữu ích cho bản dựng dự kiến.
Tối ưu prompt tự động bật mặc định trong quy trình được nhà sản xuất tài liệu hóa. Ghi lại có sử dụng nó hay không khi so sánh bản sửa. Giữ ảnh cố định khi thử mô tả hành động khác, hoặc giữ mô tả cố định khi so sánh bố cục mở đầu khác. Nhờ đó dễ nhận biết thay đổi sáng tạo nào ảnh hưởng đến kết quả.
Xem video hoàn chỉnh từ đầu đến cuối. Kiểm tra chủ thể có tiếp tục nhận ra được không, chuyển động có tôn trọng cấu trúc nhìn thấy của nguồn không và chi tiết quan trọng có ở trong khung không. Với cảnh sản phẩm, kiểm tra đường biên và diện mạo vật liệu khi chuyển động; với chân dung, kiểm tra tính liên tục của khuôn mặt và cử chỉ. Lưu clip thực tế cùng ảnh nguồn và prompt, rồi sửa vấn đề chuyển động hoặc khuôn hình cụ thể còn lại.
Ailoot Ultra · Tạo video POST /v1/videos minimaxi-i2v-01
minimaxi-i2v-01Bắt đầu
I2V 01 làm ảnh khung đầu được cung cấp chuyển động, với yêu cầu văn bản mô tả hành động là tùy chọn. Chuẩn bị bố cục mở đầu, chỉ dẫn chuyển động nhìn thấy và kiểm tra clip hoàn chỉnh về tính liên tục của chủ thể và khuôn hình.
- Đầ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 · Tạo video POST /v1/videos
- Đầu vào
text,image- Đầu ra
video
| 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 minimaxi-i2v-01 Điều kiện: Dùng bộ chọn mô hình Ailoot chính xác. | Mặc định— |
Trườngprompt | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn Điều kiện: Mô tả cảnh và chuyển động. | Mặc định— |
Trườngend_image | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Điều kiện: Khung hình kết thúc chỉ áp dụng trong chế độ đầu vào ảnh được hỗ trợ. | Mặc định— |
Trườngimage | Loạistring or array<string> | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Điều kiện: Dùng URL ảnh thực tế có thể truy cập công khai hoặc chuỗi ảnh base64; không khẳng định số ảnh tối đa ở đây. | Mặc định— |
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 |
Tham sốoptional | Hợp đồngend_image, image |
Tham sốmaterial_types | Hợp đồngtext, image |
Tham sốconditions | Hợp đồngDùng bộ chọn mô hình Ailoot chính xác., Mô tả cảnh và chuyển động., Khung hình kết thúc chỉ áp dụng trong chế độ đầu vào ảnh được hỗ trợ., Dùng URL ảnh thực tế có thể truy cập công khai hoặc chuỗi ảnh base64; không khẳng định số ảnh tối đa ở đây. |
Bí danh phương thức: /v1/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/media/assets
GET /v1/media/assets/{asset_id}
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 | Lượng dùng để 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— | Lượng dùng để 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ìnhMỗi yêu cầu | Biểu mức phí— | Số lượng dự báo— | Lượng dùng để tính phímột yêu cầu | Phí Đầu vào · Ước tính chỉ để so sánh $1 mỗi yêu cầu |
| 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 | Lượng dùng để tính phí— | Phí Đầu ra · Chi phí tạo ước tính · Ước tính chỉ để so sánh $1 ướ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 →
Ví dụ yêu cầu
Ailoot Ultra · Tạo video
# Replace YOUR_ACCESSIBLE_IMAGE_URL with your actual reachable reference image URL.
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
"model": "minimaxi-i2v-01",
"prompt": "A cat is walking on grass.",
"image": "YOUR_ACCESSIBLE_IMAGE_URL"
}
JSON
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
# Create once; retain id, polling_url, original task identifiers and every header.
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_STATUS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
u=urljoin("https://api.ailoot.ai",r["polling_url"])
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:
raise SystemExit("Unexpected returned polling URL; preserve the response")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True)
# Read this same original polling_url again while pending.
# Preserve unknown/result_pending_check; do not repeat creation.
PY_STATUS
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())
roles={}
def visit(v,path=""):
if isinstance(v,dict):
for k,x in v.items(): visit(x,path+"/"+k)
elif isinstance(v,list):
for i,x in enumerate(v): visit(x,path+"/"+str(i))
elif isinstance(v,str):
u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)
if p.scheme=="https" and p.netloc=="api.ailoot.ai" and not p.username and not p.password and p.path.startswith("/v1/media/assets/") and p.path.endswith("/content"):
roles.setdefault(u,[]).append(path)
visit(r)
if not roles: raise SystemExit("No completed owned assets; retain the original status")
manifest=[]
for i,(u,paths) in enumerate(roles.items()):
target=Path(f"asset-{i}.bin")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)
raw=target.read_bytes()
if not raw: raise SystemExit("Empty asset; retain original status and metadata")
ext="glb" if raw[:4]==b"glTF" else "png" if raw[:8]==b"\x89PNG\r\n\x1a\n" else "jpg" if raw[:3]==b"\xff\xd8\xff" else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "mp4" if raw[4:8]==b"ftyp" else "bin"
name=f"asset-{i}.{ext}"
if target.name!=name: target.rename(name)
manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})
Path("asset-manifest.json").write_text(json.dumps(manifest,indent=2))
print("Saved",len(manifest),"unique owned assets; every response role retained")
PY_ASSETS
Nhận và lưu kết quả
Ailoot Ultra · Tạo video
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
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 toàn bộ phản hồi và tiêu đề, các mã định danh gốc, mọi đầu ra thực tế và tất cả trường mức sử dụng/hạch toán. Lưu từng tài sản duy nhất thuộc quyền sở hữu và giữ lại mọi vai trò tham chiếu đến tài sản đó.
Nếu cần kiểm tra phản hồi gốc
Giữ lại id tác vụ hoặc thao tác công khai được trả về và tất cả tiêu đề. Chỉ đọc tác vụ ban đầu; unknown hoặc result_pending_check không cho phép tạo thêm tác vụ.
Trường phản hồi
| Trường | Loại |
|---|---|
Trườngid | Loạistring |
Trườngpolling_url | Loạistring |
Trườngprovider_task_id | Loạistring |
Trườngtask_id | Loạistring |
Trườngstatus | Loạistring |
Trườngvideo_url | Loạistring |
Bí danh
Bí danh mô hình
Ailoot Ultra minimaxi-i2v-01
Bí danh đường dẫn phương thức
/v1/videos/generations
ID gọi liên quan
FAQ · MiniMax: I2V 01
- Có những đầu vào và kết quả nào?
POST /v1/videos·minimaxi-i2v-01:text,image→video- Yêu cầu sử dụng những trường nào?
POST /v1/videos·minimaxi-i2v-01:model,prompt,end_image,image