MiniMax: H3 Max

MiniMax H3 Max เป็น H3 รุ่นผ่านการฝึกเพิ่มเติมที่เน้นความเร็ว สำหรับวิดีโอสั้นพร้อมเสียงตรงภาพ โฟลว์ MiniMax รองรับข้อความ ภาพเฟรม และสื่ออ้างอิงหลายรูปแบบ พร้อมเอาต์พุต 480P หรือ 768P ความยาว 5–15 วินาที และตัวเลือกขยายพรอมป์ต์ของตนเอง

Ailoot Ultra · วิดีโอ POST /v1/videos minimax/hailuo-3-max

เกี่ยวกับโมเดล

คำอธิบายนี้ครอบคลุมความสามารถของโมเดล อินพุต เอาต์พุต และตัวเลือกที่ใช้ได้ใน Ailoot แสดงด้านล่างตามเมธอดที่เลือก

H3 รุ่นผ่านการฝึกเพิ่มเติมที่เน้นความเร็ว

MiniMax H3 Max เป็นรุ่นผ่าน post-training ของโมเดลฐาน MiniMax H3 ปรับเพื่อสร้างเร็วขึ้น ทำตามพรอมป์ต์ และคุณภาพภาพพร้อมเสียง พัฒนาโดย fal Research ผ่าน post-training ยังคงบริบทหลายรูปแบบแบบรวมและภาพกับเสียงที่ตรงกันโดยตรง ความเร็วเป็นเป้าหมายออกแบบ ไม่ใช่เวลาเสร็จตายตัวสำหรับทุกพรอมป์ต์ ระยะเวลา หรือแอป

แยก Max จากระบบ H3 เดิมและ Max Turbo อีกตัว อินเทอร์เฟซ MiniMax ปัจจุบันระบุ Max ที่ 480P หรือ 768P โดยเริ่มต้น 768P, 24 เฟรมต่อวินาที และความยาวจำนวนเต็ม 5–15 วินาที โฟลว์ Max ที่ระบุไม่มี 2K ของระบบ H3 เดิมหรือเอาต์พุตสี่วินาที

จากพรอมป์ต์สู่ช็อต

ทุกการสร้างต้องมีบรีฟข้อความไม่ว่าง สูงสุด 7,000 อักขระต่อรายการข้อความ บรรยายตัวแบบ องค์ประกอบเริ่ม การกระทำ และผล แล้วกำกับกล้องกับเสียงให้ชัด การเผยวัตถุสั้นให้บอกผู้ชมเห็นอะไรก่อน วัตถุเข้าสู่ภาพอย่างไร และจบช็อตอย่างไร

บรีฟห้าวินาทีอาจเป็นถ้วยเซรามิกบนโต๊ะไม้ มือวางจานรองข้าง ๆ กล้องดันเข้าเล็กน้อย และเสียงเซรามิกกระทบไม้ ให้การกระทำพอดีระยะเวลาและตรวจว่าเสียงกับการเคลื่อนตามเหตุการณ์เดียวกัน

สร้างตามเฟรมกำกับ

ผู้ผลิตระบุใช้เฟรมเปิด เฟรมจบ หรือทั้งคู่ ภาพแรกกำหนดจุดเริ่ม ภาพท้ายกำหนดสภาพภาพสุดท้าย อธิบายการเคลื่อนเชื่อม รวมท่า ตำแหน่งวัตถุ กล้อง หรือแสงที่เปลี่ยน สำหรับช่วงเปลี่ยนสองเฟรม อย่าใส่ฉากกลางที่ไม่เข้าจุดปลาย

เอาต์พุตตามเฟรมใช้อัตราส่วนภาพอินพุต งานข้อความล้วนเลือกอัตราส่วนแน่นอนจาก 21:9, 16:9, 4:3, 1:1, 3:4 หรือ 9:16 งานตามอ้างอิงใช้อัตราส่วนปรับตามหรือค่าชัดที่ระบุได้ จัดภาพอ้างอิงหรือฉากข้อความตามกรอบเป้าหมาย แทนถือว่าองค์ประกอบเดียวเหมาะแนวตั้งและนอนเท่ากัน

สื่ออ้างอิงหลายรูปแบบ

สคีมาสร้าง Max ปัจจุบันระบุภาพ วิดีโอ และเสียงอ้างอิงด้วย บอกแต่ละแหล่งกำกับอะไร เช่น อัตลักษณ์ตัวละคร สถานที่ แบบการเคลื่อน เส้นทางกล้อง เนื้อเสียง หรือลักษณะเสียง บทบาทเฟรมแรก/ท้ายกับสื่ออ้างอิงใช้ร่วมกันไม่ได้ในอินเทอร์เฟซนั้น

ช็อตตัวละครให้แยกภาพรูปลักษณ์กับสื่อการเคลื่อน แล้วให้การกระทำและประโยคเป้าหมาย สื่อเสียงกำกับการพูดต่างจากคัดลอกสัญญาณเสียงทั้งหมด ระบุคุณสมบัติที่รักษากับการเปลี่ยนให้ชัด แล้วตรวจคลิปจริงเทียบแต่ละบทบาท

ขยายพรอมป์ต์

การขยายเฉพาะ Max มี disabled, balanced และ quality โดยเริ่มต้น balanced เลือก disabled เมื่อจะส่งบรีฟเดิมไม่ขยาย หรือโหมดที่ระบุเมื่อต้องการตีความเพิ่ม เก็บบรีฟต้นฉบับเพื่อแยกการเปลี่ยนจากการขยายออกจากเนื้อหาที่ขอ

บรรยายเสียงเป็นส่วนของฉาก ระบุเสียงกายภาพ บรรยากาศ และถ้อยคำ แยกจากเพลงพื้นหลังที่ผู้ชมเท่านั้นได้ยิน ให้ประโยคตรงและผู้พูด แทนขอบทสนทนาที่ไม่ระบุ ฟังพร้อมดู ภาพน่าเชื่อไม่พิสูจน์ว่าถ้อยคำหรือจังหวะถูก

เตรียมอินพุตและขีดจำกัด

สคีมาผู้ผลิตปัจจุบันรับภาพ JPG, JPEG, PNG, WebP, HEIC หรือ HEIF สูงสุด 30 MB ต่อภาพ ด้านละ 256–5,760 พิกเซล และสัดส่วน 0.4–2.5 บทบาทเปิดและจบรับภาพละหนึ่ง ส่วนโหมดอ้างอิงรับสูงสุดเก้าภาพ ให้ตัวแบบและรายละเอียดที่ต้องจำเห็นชัด

วิดีโออ้างอิงรับ MP4 หรือ MOV สูงสุดสามคลิป คลิปละ 2–15 วินาที รวมไม่เกิน 15 วินาที และไม่เกิน 50 MB ต่อไฟล์ ใช้ H.264 หรือ H.265 กับเสียง AAC หรือ MP3 ด้านละ 256–5,760 พิกเซล สัดส่วน 0.4–2.5 และเฟรมเรต 23.976–60 เสียงอ้างอิงรับ WAV หรือ MP3 สูงสุดสามคลิป ไม่เกิน 15 MB ต่อไฟล์ คลิปละ 2–15 วินาที รวมไม่เกิน 15 วินาที เนื้อหาคำขอมีเพดานแยก 64 MB

ใช้เฉพาะสื่อที่ช่วยช็อตและระบุสิ่งที่ให้ในข้อความ คลิปการเคลื่อนสั้นตรงงานกำกับง่ายกว่ารวมเหตุการณ์ไม่เกี่ยวกันยาว ๆ ระบุระยะเวลาและความละเอียดเป้าหมายเพื่อเทียบผลกับบรีฟเดียวกัน

ผลสำเร็จ

โฟลว์อะซิงโครนัสคืนรหัสงานก่อนวิดีโอเสร็จ อินเทอร์เฟซสอบถามเรียกงานย้อนหลังเจ็ดวันได้ เก็บคลิปที่คืนจริงกับข้อกำหนดไว้ตัดต่อหรือตรวจต่อ รหัสงานไม่ใช่ไฟล์ภาพพร้อมเสียง ที่อยู่ดาวน์โหลดมีอายุจำกัดจึงต้องเก็บไฟล์เองเมื่อเลือกผล

ตรวจตัวแบบต่อเนื่อง การเคลื่อน ข้อความที่เห็น บทสนทนา และจังหวะเสียงตามขนาดใช้ ให้ข้อเสนอแก้บรีฟถัดไปเป็นรูปธรรม เช่น ท่าที่เปลี่ยน ประโยคที่หาย หรือกรอบที่ต้องปรับ ผลที่มีประโยชน์คือช็อตภาพพร้อมเสียงสั้นที่ผูกกับเนื้อหาและความสัมพันธ์อ้างอิงชัดเจน

Ailoot Ultra · วิดีโอ POST /v1/videos minimax/hailuo-3-max

minimax/hailuo-3-max

MiniMax /minimax/hailuo-3-max

เริ่มต้น

อินพุตที่รองรับ: ข้อความ · รูปภาพ
ผลลัพธ์: วิดีโอ

ใช้งานได้ใน Ailoot · อินพุตและเมธอด

Ailoot Ultra · วิดีโอ POST /v1/videos

ขาเข้า: text, image
ขาออก: video
รูปแบบเอาต์พุต: ไบต์ MP4 ต้นฉบับ; ไม่ปรับมาตรฐานหรือแปลงรหัส

ฟิลด์	ประเภท	ข้อกำหนด	ค่าและข้อจำกัด	ค่าเริ่มต้น
ฟิลด์`model`	ประเภท`string`	ข้อกำหนดจำเป็น	ค่าและข้อจำกัด minimax/hailuo-3-max	ค่าเริ่มต้น—
ฟิลด์`prompt`	ประเภท`string`	ข้อกำหนดจำเป็น	ค่าและข้อจำกัด	ค่าเริ่มต้น—
ฟิลด์`duration`	ประเภท`integer`	ข้อกำหนดจำเป็น	ค่าและข้อจำกัด 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ขั้นต่ำ: 1 สูงสุด: 600	ค่าเริ่มต้น—
ฟิลด์`resolution`	ประเภท`string`	ข้อกำหนดไม่บังคับ	ค่าและข้อจำกัด 768p, 480p	ค่าเริ่มต้น—
ฟิลด์`aspect_ratio`	ประเภท`string`	ข้อกำหนดไม่บังคับ	ค่าและข้อจำกัด 21:9, 16:9, 4:3, 1:1, 3:4, 9:16	ค่าเริ่มต้น—
ฟิลด์`generate_audio`	ประเภท`boolean`	ข้อกำหนดไม่บังคับ	ค่าและข้อจำกัด false	ค่าเริ่มต้น—
ฟิลด์`frame_images`	ประเภท`array`	ข้อกำหนดไม่บังคับ	ค่าและข้อจำกัด จำนวนรายการขั้นต่ำ: 1 จำนวนรายการสูงสุด: 2 เนื้อหาอินพุต: อาร์เรย์ของออบเจ็กต์เฟรม แต่ละออบเจ็กต์มี type=image_url, image_url ซึ่งมี url และ frame_type ใช้ URL ภาพ HTTPS และกำหนด frame_type เป็น first_frame หรือ last_frame แต่ละบทบาทของเฟรมปรากฏได้ไม่เกินหนึ่งครั้ง ชื่อคีย์ที่แน่นอน: type, image_url, frame_type เงื่อนไข: คีย์เหล่านี้อธิบายออบเจ็กต์เฟรมแต่ละรายการ image_url มีเฉพาะ url ไม่ต้องระบุ frame_images สำหรับคำขอที่มีเฉพาะข้อความ	ค่าเริ่มต้น—
ฟิลด์`input_references`	ประเภท`array`	ข้อกำหนดไม่บังคับ	ค่าและข้อจำกัด	ค่าเริ่มต้น—
ฟิลด์`callback_url`	ประเภท`string`	ข้อกำหนดไม่บังคับ	ค่าและข้อจำกัด แพตเทิร์น: ^https://	ค่าเริ่มต้น—
ฟิลด์`session_id`	ประเภท`string`	ข้อกำหนดไม่บังคับ	ค่าและข้อจำกัด	ค่าเริ่มต้น—
ฟิลด์`trace`	ประเภท`object`	ข้อกำหนดไม่บังคับ	ค่าและข้อจำกัด	ค่าเริ่มต้น—
ฟิลด์`user`	ประเภท`string`	ข้อกำหนดไม่บังคับ	ค่าและข้อจำกัด	ค่าเริ่มต้น—

ชุดผสมของสื่ออินพุต

สร้างวิดีโอจากข้อความ · พรอมป์ต์ข้อความ · จำเป็น: model, prompt, duration

ระบุพรอมป์ต์เป็นข้อความและระยะเวลาเป็นวินาทีเต็ม เลือกความละเอียดที่รองรับและอัตราส่วนภาพหากจำเป็น

model: ประเภท: string · minimax/hailuo-3-max

prompt: ประเภท: string · จำนวนไบต์ UTF-8 สูงสุด: 10,000 · ต้องมีอักขระที่ไม่ใช่ช่องว่าง: ใช่

สร้างวิดีโอจากภาพ · พรอมป์ต์ข้อความและภาพเฟรมแรก · จำเป็น: model, prompt, duration, frame_images

frame_images เป็นอาร์เรย์ ออบเจ็กต์ของแต่ละเฟรมมี type, image_url และ frame_type โดย image_url มี url กำหนด type เป็น image_url ใช้ first_frame และเพิ่ม last_frame ได้หากต้องการ แต่ละบทบาทของเฟรมปรากฏได้ไม่เกินหนึ่งครั้ง ระบุ URL ภาพ HTTPS สาธารณะสำหรับแต่ละเฟรม เลือกความละเอียดที่รองรับและอัตราส่วนภาพหากจำเป็น

ชื่อคีย์ที่แน่นอน: type, image_url, frame_type

model: ประเภท: string · minimax/hailuo-3-max

พารามิเตอร์และวงจรการทำงานของเมธอด

พารามิเตอร์	ข้อกำหนด
พารามิเตอร์`content_type`	ข้อกำหนดapplication/json
พารามิเตอร์`required`	ข้อกำหนดmodel, prompt, duration
พารามิเตอร์`material_types`	ข้อกำหนดtext, image
พารามิเตอร์`additional_properties`	ข้อกำหนดfalse
พารามิเตอร์`optional_controls`	ข้อกำหนดresolution, aspect_ratio, generate_audio, frame_images, input_references, callback_url, session_id, trace, user

วงจรการทำงาน: submit_once_poll_original

GET /v1/videos/{public_id}

GET /v1/videos/{public_id}/content

ราคา

วิธีคำนวณค่าบริการสุดท้าย

อัตราที่แสดงใช้ประมาณการค่าใช้จ่ายก่อนการสร้างผลลัพธ์ ยอดเรียกเก็บสุดท้ายคำนวณจากค่าใช้จ่ายที่บันทึกไว้สำหรับการสร้างผลลัพธ์ครั้งเดิม ระยะเวลาของผลลัพธ์ที่วัดได้และปริมาณที่คาดการณ์ไว้ไม่ใช่ปริมาณสุดท้ายที่ใช้คิดค่าบริการ

ข้อมูลอัตราราคาไม่ได้เพิ่มตัวเลือกคำขอ พารามิเตอร์ที่รองรับระบุไว้สำหรับเมธอดที่เลือก

โหมดรวดเร็ว: ไม่ได้ระบุ เมื่อเลือกโหมดรวดเร็ว
โหมดยืดหยุ่น: ไม่ได้ระบุ เมื่อเลือกโหมด flex
ระดับการใช้เหตุผลสูงสุด: ไม่ได้ระบุ เมื่อใช้การปรับตามค่าเริ่มต้น (default) สำหรับระดับการใช้เหตุผลสูงสุด

อัตราประมาณการเพื่อเปรียบเทียบ

ราคาตามการตั้งค่า

เทียบค่าบริการแต่ละรายการกับเงื่อนไขที่แสดง เลือกใช้อัตราเดียวสำหรับแต่ละชุดการตั้งค่าที่เป็นตัวเลือกทดแทนกัน

การตั้งค่า	ตารางอัตราค่าบริการ	ปริมาณคาดการณ์	รายการค่าบริการ	หน่วยคิดค่าบริการ	เงื่อนไขคิดค่าบริการ	ค่าบริการ
การตั้งค่าอัตราค่าบริการโทเคนพื้นฐาน	ตารางอัตราค่าบริการอัตราพื้นฐาน	ปริมาณคาดการณ์—	รายการค่าบริการ—	หน่วยคิดค่าบริการ—	เงื่อนไขคิดค่าบริการ—	ค่าบริการ ขาเข้า · โทเค็นอินพุต · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น ขาออก · โทเค็นเอาต์พุต · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น ขาเข้า · การอ่านแคช · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น ขาเข้า · การเขียนแคช · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น ขาเข้า · การเขียนแคช, 1 ชั่วโมง · ประมาณการเพื่อเปรียบเทียบเท่านั้น — / 1K โทเค็น
การตั้งค่าวิดีโอขาออก · อัตราอ้างอิง	ตารางอัตราค่าบริการ—	ปริมาณคาดการณ์—	รายการค่าบริการ`reference_output_rate`	หน่วยคิดค่าบริการต่อวินาทีของเอาต์พุต	เงื่อนไขคิดค่าบริการ—	ค่าบริการ ขาออก · อัตราอ้างอิงต่อวินาทีของวิดีโอขาออก · ประมาณการเพื่อเปรียบเทียบเท่านั้น $0.16 ต่อวินาทีของเอาต์พุต
การตั้งค่าราคาวิดีโอ	ตารางอัตราค่าบริการ—	ปริมาณคาดการณ์—	รายการค่าบริการ—	หน่วยคิดค่าบริการต่อวินาทีของวิดีโอ	เงื่อนไขคิดค่าบริการresolution: 480p	ค่าบริการ ขาออก · ราคาวิดีโอ · ประมาณการเพื่อเปรียบเทียบเท่านั้น $0.1 ต่อวินาทีของวิดีโอ
การตั้งค่าราคาวิดีโอ	ตารางอัตราค่าบริการ—	ปริมาณคาดการณ์—	รายการค่าบริการ—	หน่วยคิดค่าบริการต่อวินาทีของวิดีโอ	เงื่อนไขคิดค่าบริการresolution: 768p	ค่าบริการ ขาออก · ราคาวิดีโอ · ประมาณการเพื่อเปรียบเทียบเท่านั้น $0.16 ต่อวินาทีของวิดีโอ
การตั้งค่าต้นทุนการสร้างโดยประมาณ	ตารางอัตราค่าบริการ—	ปริมาณคาดการณ์ค่าประมาณสำหรับการสร้างหนึ่งครั้ง	รายการค่าบริการ—	หน่วยคิดค่าบริการ—	เงื่อนไขคิดค่าบริการ—	ค่าบริการ ขาออก · ค่าใช้จ่ายในการสร้างโดยประมาณ · ประมาณการเพื่อเปรียบเทียบเท่านั้น $0.5 ประมาณการก่อนสร้าง ค่าประมาณนี้ไม่ใช่ค่าใช้จ่ายเพิ่มเติมหรืออัตราคงที่สำหรับการสร้างผลลัพธ์ที่เสร็จสมบูรณ์แล้ว

Ailoot กันยอดเงินประมาณการไว้ก่อนส่งคำขอ หลังได้ผลลัพธ์ จะคิดค่าบริการสุดท้ายตามการใช้งานที่วัดได้ การคิดค่าบริการแบบสตรีมใช้บันทึกการใช้งานสุดท้าย วิธีกันยอดเงินและคิดค่าบริการสุดท้าย →

รายละเอียดอัตราอ้างอิง

ตารางอัตราอ้างอิงระดับโมเดลไม่เปลี่ยนเมธอดที่เลือก ยอดประมาณการ หรือค่าบริการ การคิดค่าบริการจริงใช้อัตราของเมธอด Ailoot ที่เลือก

ข้อมูลอ้างอิงราคาตามการตั้งค่าวิดีโอ

ราคาตามการตั้งค่า

การตั้งค่า	เงื่อนไขคิดค่าบริการ	ค่าบริการ
การตั้งค่าราคาวิดีโอ	เงื่อนไขคิดค่าบริการไม่มีการระบุเงื่อนไขเพิ่มเติมในคีย์ราคานี้	ค่าบริการ ขาออก · ราคาวิดีโอ $0.16 ต่อวินาทีของวิดีโอ ราคาอ้างอิงที่ประกาศสำหรับการตั้งค่าที่แสดง ยอดเรียกเก็บสุดท้ายเป็นไปตามการตั้งค่าที่ใช้คิดค่าบริการจริง
การตั้งค่าราคาวิดีโอ	เงื่อนไขคิดค่าบริการresolution: 480p	ค่าบริการ ขาออก · ราคาวิดีโอ $0.1 ต่อวินาทีของวิดีโอ ราคาอ้างอิงที่ประกาศสำหรับการตั้งค่าที่แสดง ยอดเรียกเก็บสุดท้ายเป็นไปตามการตั้งค่าที่ใช้คิดค่าบริการจริง
การตั้งค่าราคาวิดีโอ	เงื่อนไขคิดค่าบริการresolution: 768p	ค่าบริการ ขาออก · ราคาวิดีโอ $0.16 ต่อวินาทีของวิดีโอ ราคาอ้างอิงที่ประกาศสำหรับการตั้งค่าที่แสดง ยอดเรียกเก็บสุดท้ายเป็นไปตามการตั้งค่าที่ใช้คิดค่าบริการจริง

ตัวอย่างคำขอ

Ailoot Ultra · วิดีโอ

curl · สร้างวิดีโอ

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

รับและบันทึกผลลัพธ์

Ailoot Ultra · วิดีโอ

URL เนื้อหาที่ลงลายเซ็นและเป็นของคุณ

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

ตรวจสอบสถานะงาน

GET · ดูสถานะของงานเดิม

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 ที่ส่งกลับมาจริง

เก็บผลลัพธ์จริงที่เป็นของคุณทุกรายการ พร้อมเมทาดาทาที่วัดได้ซึ่งส่งกลับมา

เมื่อต้องตรวจสอบการตอบกลับต้นฉบับ

503 result_pending_check + id เดิม + X-Should-Retry:false ห้ามส่งคำขอเดิมซ้ำ

ฟิลด์การตอบกลับ

ฟิลด์	ประเภท	ความหมาย
ฟิลด์`index`	ประเภทinteger	ความหมายตำแหน่งของวิดีโอนี้ในรายการผลลัพธ์ โดยเริ่มนับจากศูนย์
ฟิลด์`content_url`	ประเภทstring	ความหมายURL ดาวน์โหลด HTTPS ที่ลงลายเซ็นสำหรับวิดีโอที่เสร็จสมบูรณ์นี้
ฟิลด์`sha256`	ประเภทstring \| null	ความหมายค่าแฮช SHA-256 ของไบต์วิดีโอต้นฉบับ เป็น null หากไม่มีข้อมูล
ฟิลด์`size_bytes`	ประเภทinteger \| null	ความหมายขนาดไฟล์วิดีโอต้นฉบับเป็นไบต์ เป็น null หากไม่มีข้อมูล
ฟิลด์`duration_ms`	ประเภทinteger \| null	ความหมายระยะเวลาวิดีโอที่วัดได้เป็นมิลลิวินาที เป็น null หากไม่มีข้อมูล
ฟิลด์`width`	ประเภทinteger \| null	ความหมายความกว้างวิดีโอเป็นพิกเซล เป็น null หากไม่มีข้อมูล
ฟิลด์`height`	ประเภทinteger \| null	ความหมายความสูงวิดีโอเป็นพิกเซล เป็น null หากไม่มีข้อมูล
ฟิลด์`video_codec`	ประเภทstring \| null	ความหมายตัวระบุตัวแปลงสัญญาณวิดีโอ เป็น null หากไม่ได้บันทึกไว้
ฟิลด์`has_audio`	ประเภทboolean \| null	ความหมายระบุว่าวิดีโอมีแทร็กเสียงหรือไม่ เป็น null หากไม่ได้วัด
ฟิลด์`audio_codec`	ประเภทstring \| null	ความหมายตัวระบุตัวแปลงสัญญาณเสียง เป็น null เมื่อไม่มีการบันทึกตัวระบุ

ข้อผิดพลาดและขั้นตอนถัดไป

การตอบกลับ	เงื่อนไข	ขั้นตอนถัดไป
การตอบกลับ404 · `not_found_error`	เงื่อนไขไม่สามารถเข้าถึงวิดีโอ หรือไม่พบ ID วิดีโอนี้	ขั้นตอนถัดไปตรวจสอบสิทธิ์เข้าถึงวิดีโอ สำหรับวิดีโอที่มีอยู่ ให้ใช้ ID สาธารณะเดิมและคีย์ API เดิม
การตอบกลับ401 · `authentication_error`	เงื่อนไขคีย์ API ไม่ตรงกับบัญชีที่ยืนยันตัวตน	ขั้นตอนถัดไปตรวจสอบคีย์ API และสิทธิ์เข้าถึงบัญชีของคุณก่อนส่ง
การตอบกลับ400 · `invalid_request_error`	เงื่อนไขไม่สามารถอ่านคำขอ หรือดัชนีดาวน์โหลดไม่ถูกต้อง	ขั้นตอนถัดไปแก้ไขเนื้อหาคำขอ สำหรับการดาวน์โหลด ให้เลือกดัชนีผลลัพธ์ที่งานเดิมส่งกลับ
การตอบกลับ422 · `price_unavailable`	เงื่อนไขไม่สามารถคิดราคาการตั้งค่าวิดีโอที่เลือกได้	ขั้นตอนถัดไปเลือกการตั้งค่าวิดีโอที่รองรับและระบุตัวเลือกที่จำเป็นให้ครบก่อนส่งคำขอที่แก้ไขแล้ว
การตอบกลับ422 · `invalid_request_error`	เงื่อนไขข้อมูลขาเข้าวิดีโอหรืองานต้นฉบับสำหรับการต่อเนื่องไม่ถูกต้อง	ขั้นตอนถัดไปใช้ข้อมูลขาเข้า HTTPS ที่ถูกต้อง สำหรับการต่อเนื่อง ให้ใช้ ID วิดีโอสาธารณะเดิมที่เสร็จสมบูรณ์ของคุณพร้อมคีย์ API เดิม
การตอบกลับ402 · `billing_error`	เงื่อนไขยอดคงเหลือหรือขีดจำกัดที่ใช้ได้ไม่เพียงพอสำหรับการกันวงเงิน	ขั้นตอนถัดไปตรวจสอบยอดคงเหลือและขีดจำกัดที่ใช้ได้ก่อนส่งคำขอใหม่
การตอบกลับ503 · `server_error`	เงื่อนไขการตรวจสอบวิดีโอ ที่เก็บข้อมูล หรือการเข้าถึงบริการไม่พร้อมใช้งานชั่วคราว	ขั้นตอนถัดไปรอให้บริการพร้อมใช้งาน หากมี ID วิดีโอแล้ว ให้ตรวจสอบงานเดิมนั้นแทนการสร้างวิดีโออีกครั้ง
การตอบกลับ503 · `result_pending_check`	เงื่อนไขต้องตรวจสอบผลลัพธ์วิดีโอเดิมและยอดเรียกเก็บ	ขั้นตอนถัดไปเก็บ ID วิดีโอที่ส่งกลับและตรวจสอบงานนั้น อย่าส่งคำขอสร้างทดแทนระหว่างที่กำลังตรวจสอบ
การตอบกลับ503 · `owned_result_unavailable`	เงื่อนไขการดาวน์โหลดวิดีโอที่มีอยู่ไม่พร้อมใช้งานชั่วคราว	ขั้นตอนถัดไปตรวจสอบงานวิดีโอเดิมในภายหลังและดาวน์โหลดผลลัพธ์ที่มีอยู่ การสร้างใหม่จะสร้างการดำเนินการแยกต่างหาก
การตอบกลับ409 · `video_not_ready`	เงื่อนไขเนื้อหาวิดีโอยังไม่เผยแพร่	ขั้นตอนถัดไปตรวจสอบสถานะงานเดิม ดาวน์โหลดหลังรายงาน completed หากรายงาน failed ให้ทำตามข้อความแจ้งตรวจสอบยอดเรียกเก็บ

ชื่ออื่น

ชื่ออื่นของโมเดล

Ailoot Ultra minimax/hailuo-3-max

ชื่อพาธเมธอดอื่น

ใช้พาธเมธอดที่แสดงด้านบน

ID ที่เกี่ยวข้องสำหรับเรียกใช้โมเดล

minimax/hailuo-3-max

FAQ · MiniMax: H3 Max

มีอินพุตและผลลัพธ์ใดบ้าง?: POST /v1/videos · minimax/hailuo-3-max: text, image → video
คำขอใช้ฟิลด์ใดบ้าง?: 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
มีข้อจำกัดใดบ้าง?: POST /v1/videos · minimax/hailuo-3-max: duration.minimum: 1; duration.maximum: 600; frame_images.max_items: 2; frame_images.min_items: 1

MiniMax: H3 Max

MiniMax: H3 Max

เริ่มต้น

ใช้งานได้ใน Ailoot · อินพุตและเมธอด

ราคา

วิธีคำนวณค่าบริการสุดท้าย

อัตราประมาณการเพื่อเปรียบเทียบ

ราคาตามการตั้งค่า

รายละเอียดอัตราอ้างอิง

ราคาตามการตั้งค่า

ตัวอย่างคำขอ

Ailoot Ultra · วิดีโอ

รับและบันทึกผลลัพธ์

Ailoot Ultra · วิดีโอ

ตรวจสอบสถานะงาน

เก็บผลลัพธ์ที่เสร็จสมบูรณ์ทั้งหมด

เมื่อต้องตรวจสอบการตอบกลับต้นฉบับ

ชื่ออื่น

ชื่ออื่นของโมเดล

ชื่อพาธเมธอดอื่น

ID ที่เกี่ยวข้องสำหรับเรียกใช้โมเดล

บริษัทและพอร์ตโฟลิโอโครงการของบริษัท

ซื้อโทเคนพร้อมส่วนลด

เชื่อม API กับผลิตภัณฑ์ ที่คุณขาย