Hailuo 2.3 Fast
MiniMax Hailuo 2.3 Fast ทำภาพเฟรมแรกให้เคลื่อนไหวจากพรอมป์ต์การเคลื่อนสั้น เลือกโปรไฟล์ภาพสู่วิดีโอนี้สำหรับช็อตสินค้า ท่าตัวละคร หรือภาพนิ่งสตอรีบอร์ด
เกี่ยวกับโมเดล
คำอธิบายนี้ครอบคลุมความสามารถของโมเดล อินพุต เอาต์พุต และตัวเลือกที่ใช้ได้ใน Ailoot แสดงด้านล่างตามเมธอดที่เลือก
MiniMax Hailuo 2.3 Fast เป็นโปรไฟล์ Fast ที่ระบุชื่อสำหรับการสร้างภาพสู่วิดีโอ เริ่มด้วยภาพเฟรมแรกที่จัดองค์ประกอบแล้ว และบอกตัวแบบหรือกล้องควรเคลื่อนอย่างไร ภาพสินค้า ท่าตัวละคร หรือเฟรมสตอรีบอร์ดให้จุดเริ่มภาพที่ชัด
เตรียมภาพและบรีฟการเคลื่อน
ส่งภาพสี่เหลี่ยมจัตุรัส PNG หรือ JPEG ผ่าน HTTPS URL แต่ละด้านระหว่าง 300 และ 4,096 พิกเซล ไฟล์ภาพที่ดาวน์โหลดต้องไม่เกิน 20,000,000 ไบต์ ให้พรอมป์ต์ยาว 1–199 อักขระ เน้นการกระทำที่เห็นหนึ่งอย่างและการเคลื่อนที่สำคัญต่อช็อต
ติดตามคลิปจนเสร็จ
โปรไฟล์นี้ตั้งไว้สำหรับ MP4 หนึ่งคลิปขนาด 768 × 768 ความยาวตามกำหนดหกวินาที ส่งคำขอครั้งเดียว เก็บ ID ที่คืน และติดตามคำขอเดิมจนเสร็จ ดาวน์โหลดวิดีโอและเก็บขนาดที่รายงานกับความยาวที่วัดจริงร่วมผล หากไม่แน่ใจว่าการสร้างเกิดผลหรือไม่ ให้ตรวจคำขอเดิมต่อแทนสร้างซ้ำ
Ailoot Ultra · วิดีโอ POST /v1/videos MiniMax-Hailuo-2.3-Fast
MiniMax-Hailuo-2.3-Fastเริ่มต้น
MiniMax Hailuo 2.3 Fast ทำภาพเฟรมแรกให้เคลื่อนไหวจากพรอมป์ต์การเคลื่อนสั้น เลือกโปรไฟล์ภาพสู่วิดีโอนี้สำหรับช็อตสินค้า ท่าตัวละคร หรือภาพนิ่งสตอรีบอร์ด
- อินพุตที่รองรับ
- ข้อความ · รูปภาพ
- ผลลัพธ์
- วิดีโอ
ใช้งานได้ใน Ailoot · อินพุตและเมธอด
Ailoot Ultra · วิดีโอ POST /v1/videos
- ขาเข้า
text,image- ขาออก
video- รูปแบบเอาต์พุต
- mp4
- จำนวนเอาต์พุต
- ไม่เกิน 1 เอาต์พุต
| ฟิลด์ | ประเภท | ข้อกำหนด | ค่าและข้อจำกัด | ค่าเริ่มต้น |
|---|---|---|---|---|
ฟิลด์model | ประเภทstring | ข้อกำหนดจำเป็น | ค่าและข้อจำกัด MiniMax-Hailuo-2.3-Fast | ค่าเริ่มต้น— |
ฟิลด์prompt | ประเภทstring | ข้อกำหนดจำเป็น | ค่าและข้อจำกัด ความยาวขั้นต่ำ: 1 ความยาวสูงสุด: 199 หน่วย: อักขระ Unicode | ค่าเริ่มต้น— |
ฟิลด์duration | ประเภทinteger | ข้อกำหนดจำเป็น | ค่าและข้อจำกัด 6 หน่วย: วินาที | ค่าเริ่มต้น— |
ฟิลด์resolution | ประเภทstring | ข้อกำหนดจำเป็น | ค่าและข้อจำกัด 768P | ค่าเริ่มต้น— |
ฟิลด์first_frame_image | ประเภทhttps_url | ข้อกำหนดจำเป็น | ค่าและข้อจำกัด ขนาดไฟล์สูงสุด หน่วยไบต์: 20,000,000 ประเภท MIME: image/png, image/jpeg ขนาดขั้นต่ำ: 300 ขนาดสูงสุด: 4,096 สี่เหลี่ยมจัตุรัสเท่านั้น: ใช่ | ค่าเริ่มต้น— |
ชุดผสมของสื่ออินพุต
สร้างวิดีโอจากภาพ · จำเป็น: prompt, first_frame_image
พารามิเตอร์และวงจรการทำงานของเมธอด
| พารามิเตอร์ | ข้อกำหนด |
|---|---|
พารามิเตอร์content_type | ข้อกำหนดapplication/json |
พารามิเตอร์required | ข้อกำหนดmodel, prompt, duration, resolution, first_frame_image |
พารามิเตอร์other_options | ข้อกำหนดfalse |
พารามิเตอร์duration | ข้อกำหนด6 |
พารามิเตอร์resolution | ข้อกำหนด768P |
พารามิเตอร์prompt_max_characters | ข้อกำหนด199 |
พารามิเตอร์first_frame_image | ข้อกำหนด{"type":"https_url","format":["png","jpeg"],"dimensions":"สี่เหลี่ยมจัตุรัส 300..4096 พิกเซล","full_image_validation_before_send":true,"maximum_file_bytes":20000000} |
พารามิเตอร์material_types | ข้อกำหนดtext, image |
พารามิเตอร์additional_properties | ข้อกำหนดfalse |
ชื่ออื่นของเมธอด: /v1/videos/generations, /videos, /videos/generations
วงจรการทำงาน: 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
สร้างเพียงครั้งเดียวและบันทึก ID ที่ส่งกลับ
ตรวจสอบสถานะเดิมเป็นระยะ เก็บแอสเซ็ตที่เสร็จสมบูรณ์ทุกชิ้นและระยะเวลา
ราคา
ข้อมูลอัตราราคาไม่ได้เพิ่มตัวเลือกคำขอ พารามิเตอร์ที่รองรับระบุไว้สำหรับเมธอดที่เลือก
- โหมดรวดเร็ว
- ไม่ได้ระบุ เมื่อเลือกโหมดรวดเร็ว
- โหมดยืดหยุ่น
- ไม่ได้ระบุ เมื่อเลือกโหมด flex
- ระดับการใช้เหตุผลสูงสุด
- ไม่ได้ระบุ เมื่อใช้การปรับตามค่าเริ่มต้น (default) สำหรับระดับการใช้เหตุผลสูงสุด
อัตราค่าบริการ Ailoot
ราคาตามการตั้งค่า
เทียบค่าบริการแต่ละรายการกับเงื่อนไขที่แสดง เลือกใช้อัตราเดียวสำหรับแต่ละชุดการตั้งค่าที่เป็นตัวเลือกทดแทนกัน
| การตั้งค่า | ตารางอัตราค่าบริการ | ความยาวคลิปตามที่ระบุ หน่วยวินาที | ความละเอียด | หน่วยคิดค่าบริการ | ค่าบริการ |
|---|---|---|---|---|---|
| การตั้งค่าอัตราค่าบริการโทเคนพื้นฐาน | ตารางอัตราค่าบริการอัตราพื้นฐาน | ความยาวคลิปตามที่ระบุ หน่วยวินาที— | ความละเอียด— | หน่วยคิดค่าบริการ— | ค่าบริการ ขาเข้า · โทเค็นอินพุต — / 1K โทเค็น ขาออก · โทเค็นเอาต์พุต — / 1K โทเค็น ขาเข้า · การอ่านแคช — / 1K โทเค็น ขาเข้า · การเขียนแคช — / 1K โทเค็น ขาเข้า · การเขียนแคช, 1 ชั่วโมง — / 1K โทเค็น |
| การตั้งค่าUltra | ตารางอัตราค่าบริการ— | ความยาวคลิปตามที่ระบุ หน่วยวินาที6 | ความละเอียด768P | หน่วยคิดค่าบริการต่อคลิปเอาต์พุตที่มีความยาวตามที่ระบุ 6s | ค่าบริการ ขาออก · คลิปขาออกความยาวตามค่าระบุ 6s $0.4 ต่อคลิปเอาต์พุตที่มีความยาวตามที่ระบุ 6s |
Ailoot กันยอดเงินประมาณการไว้ก่อนส่งคำขอ หลังได้ผลลัพธ์ จะคิดค่าบริการสุดท้ายตามการใช้งานที่วัดได้ การคิดค่าบริการแบบสตรีมใช้บันทึกการใช้งานสุดท้าย วิธีกันยอดเงินและคิดค่าบริการสุดท้าย →
รายละเอียดอัตราอ้างอิง
ตารางอัตราอ้างอิงระดับโมเดลไม่เปลี่ยนเมธอดที่เลือก ยอดประมาณการ หรือค่าบริการ การคิดค่าบริการจริงใช้อัตราของเมธอด Ailoot ที่เลือก
MiniMax-Hailuo-2.3-Fast
ราคาตามการตั้งค่า
| การตั้งค่า | เงื่อนไขคิดค่าบริการ | ค่าบริการ |
|---|---|---|
| การตั้งค่าMiniMax-Hailuo-2.3-Fast · การตั้งค่าเริ่มต้น | เงื่อนไขคิดค่าบริการการตั้งค่าเริ่มต้น | ค่าบริการ ขาเข้า · ขาเข้า US$0.00 ต่อการเรียก ขาออก · ขาออก US$0.40 ต่อการเรียก |
MiniMax-Hailuo-2.3-Fast
ราคาตามการตั้งค่า
| การตั้งค่า | เงื่อนไขคิดค่าบริการ | ค่าบริการ |
|---|---|---|
| การตั้งค่าMiniMax-Hailuo-2.3-Fast · การตั้งค่าเริ่มต้น | เงื่อนไขคิดค่าบริการการตั้งค่าเริ่มต้น | ค่าบริการ ขาเข้า · ขาเข้า US$0.00 ต่อการเรียก ขาออก · ขาออก US$0.80 ต่อการเรียก |
MiniMax-Hailuo-2.3-Fast
ราคาตามการตั้งค่า
| การตั้งค่า | เงื่อนไขคิดค่าบริการ | ค่าบริการ |
|---|---|---|
| การตั้งค่าMiniMax-Hailuo-2.3-Fast · การตั้งค่าเริ่มต้น | เงื่อนไขคิดค่าบริการการตั้งค่าเริ่มต้น | ค่าบริการ ขาเข้า · ขาเข้า US$0.00 ต่อการเรียก ขาออก · ขาออก US$0.80 ต่อการเรียก |
ตัวอย่างคำขอ
Ailoot Ultra · วิดีโอ
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
รับและบันทึกผลลัพธ์
Ailoot Ultra · วิดีโอ
mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
ตรวจสอบสถานะงาน
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
การอ่านเนื้อหาแบบอื่น
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
เก็บผลลัพธ์ที่เสร็จสมบูรณ์ทั้งหมด
บันทึกวิดีโอที่สร้างเสร็จหรือไฟล์ที่ส่งกลับมาทุกไฟล์ และดึงไฟล์สื่อจากทุก URL ที่ส่งกลับมาจริง
data[] ที่เสร็จสมบูรณ์มี URL เนื้อหาที่ลงลายเซ็นและเป็นของคุณทั้งหมด เรียก URL แต่ละรายการที่ส่งกลับ หรือใช้เอนด์พอยต์เนื้อหาโดยกำหนด index เป็นดัชนีผลลัพธ์จริง งานเดิมที่ล้มเหลวอาจส่งกลับ charge_pending_check ให้ตรวจสอบงานเดิมนั้นแทนการสร้างซ้ำ
เมื่อต้องตรวจสอบการตอบกลับต้นฉบับ
อ่านงานเดิมที่มีอยู่ ห้ามส่งซ้ำเมื่อไม่ทราบผลการส่ง
จำนวนเอาต์พุตสูงสุด: 1.
ฟิลด์การตอบกลับ
| ฟิลด์ | ประเภท | ความหมาย |
|---|---|---|
ฟิลด์id | ประเภทstring | ความหมาย— |
ฟิลด์object | ประเภทstring | ความหมาย— |
ฟิลด์model | ประเภทstring | ความหมาย— |
ฟิลด์status | ประเภทstring | ความหมาย— |
ฟิลด์data[] | ประเภทsigned content URL | ความหมาย— |
ฟิลด์charge_pending_check | ประเภทboolean | ความหมาย— |
ฟิลด์error.code | ประเภทstring | ความหมาย— |
ฟิลด์error.message | ประเภทstring | ความหมาย— |
ฟิลด์requested_nominal_duration_seconds | ประเภทinteger | ความหมาย— |
ฟิลด์measured_duration_seconds | ประเภทnumber | ความหมาย— |
ฟิลด์width | ประเภทinteger | ความหมาย— |
ฟิลด์height | ประเภทinteger | ความหมาย— |
ฟิลด์operation_id | ประเภทstring | ความหมายส่งกลับเมื่อ status=unknown เป็น ID การดำเนินการวิดีโอสาธารณะเดิมจริง |
ฟิลด์request_id | ประเภทstring | ความหมายไม่จำเป็นเมื่อ status=unknown ส่งกลับเฉพาะเมื่องานเดิมมี ID คำขอ |
ข้อผิดพลาดและขั้นตอนถัดไป
| การตอบกลับ | เงื่อนไข | ขั้นตอนถัดไป |
|---|---|---|
การตอบกลับ400 · invalid_request_error | เงื่อนไขอ่านเนื้อหาคำขอดิบไม่สำเร็จก่อนแยกวิเคราะห์โปรไฟล์วิดีโอ | ขั้นตอนถัดไปเก็บการตอบกลับที่ส่งกลับและแก้ไขเนื้อหาคำขอที่อ่านไม่ได้ |
การตอบกลับ422 · price_unavailable | เงื่อนไขแยกวิเคราะห์โปรไฟล์วิดีโอที่ตรงตามที่กำหนดไม่สำเร็จ หรือโปรไฟล์ที่แยกวิเคราะห์ครบแล้วไม่มีรายการราคาที่ตรงกันและพร้อมใช้งาน | ขั้นตอนถัดไปเก็บการตอบกลับไว้ ใช้โปรไฟล์ที่ตรงตามข้ออนุญาตและครบถ้วน พร้อมรายการราคาที่เผยแพร่ สาขาการทำงานนี้เกิดก่อนส่งคำขอไปยังผู้ให้บริการ |
การตอบกลับ409 · video_not_ready | เงื่อนไขเนื้อหาผลลัพธ์เดิมยังไม่พร้อมใช้งาน | ขั้นตอนถัดไปตรวจสอบ ID เดิมที่ส่งกลับเป็นระยะ และปฏิบัติตาม Retry-After |
การตอบกลับserver_error | เงื่อนไขการตอบกลับที่ได้รับระบุว่าต้องตรวจสอบการดำเนินการหรือผลลัพธ์ | ขั้นตอนถัดไปเก็บ ID การดำเนินการ/งานที่ส่งกลับมาแต่เดิม ส่วนหัวของคำขอ และการตอบกลับไว้ แล้วอ่านข้อมูลการดำเนินการเดิมนั้นต่อด้วยวิธีที่รองรับ ห้ามส่งคำขอสร้างซ้ำ |
การตอบกลับ200 · video_result_unverified | เงื่อนไขสถานะงาน Fast เดิมไม่ทราบแน่ชัด status=unknown และ charge_pending_check=true | ขั้นตอนถัดไปเก็บ id/operation_id จริงที่ส่งกลับและ request_id หากมี อ่านเฉพาะงานเดิม ห้ามส่งซ้ำ |
ชื่ออื่น
ชื่ออื่นของโมเดล
Ailoot Ultra MiniMax-Hailuo-2.3-Fast
ชื่อพาธเมธอดอื่น
/v1/videos/generations, /videos, /videos/generations
ID ที่เกี่ยวข้องสำหรับเรียกใช้โมเดล
FAQ · Hailuo 2.3 Fast
- มีอินพุตและผลลัพธ์ใดบ้าง?
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:text,image→video- คำขอใช้ฟิลด์ใดบ้าง?
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:model,prompt,duration,resolution,first_frame_image- มีข้อจำกัดใดบ้าง?
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:prompt.maximum_length:199