MiniMax: H3

MiniMax H3 สร้างวิดีโอสั้นพร้อมเสียงสเตอริโอโดยตรงจากข้อความ ภาพเฟรม หรือสื่ออ้างอิงหลายรูปแบบ รองรับสร้างจากเฟรมแรก/ท้าย แก้ตามอ้างอิง และความสัมพันธ์การเคลื่อนหรือเสียง พร้อมเอาต์พุต 4–15 วินาทีและเวิร์กโฟลว์สร้างใหม่ 2K แยก

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

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

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

ผลภาพพร้อมเสียงเดียวจากบรีฟหลายรูปแบบ

MiniMax H3 เป็นระบบวิดีโอ omni-modal ของ MiniMax ตีความข้อความ ภาพ วิดีโอ และเสียงร่วมกัน แล้วสร้างวิดีโอพร้อมเสียงสเตอริโอโดยตรง ผู้ผลิตนำเสนอสำหรับงานสั้นสร้างสรรค์ เช่น ภาพสินค้า โฆษณา โปสเตอร์เคลื่อนไหว และแนวคิดชื่อภาพยนตร์ ที่ความสัมพันธ์ระหว่างสื่ออ้างอิงสำคัญพอ ๆ กับคำอธิบายฉาก

ระบบที่ระบุให้วิดีโอ 4–15 วินาทีที่ 24 เฟรมต่อวินาที เสียงสเตอริโอ 32 kHz H3-Base สร้างที่ 768p ส่วนเวิร์กโฟลว์ 2K เต็มสร้างผลนั้นใหม่ด้วยบริบทหลายรูปแบบเดิม มากกว่าการย่อขยายทั่วไป เพราะขั้นสองใช้โมเดลกับบริบทต้นทางอีกครั้งเพื่อคืนรายละเอียด H3 Max และ H3-Context-IR มีบทบาทและขีดจำกัดแยก

สร้างตามข้อความและเฟรม

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

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

สร้างและแก้ตามสื่ออ้างอิง

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

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

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

คำพูด เสียง และจังหวะช็อต

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

คู่มือเขียนพรอมป์ต์ใช้ภาษาอังกฤษในส่วนบรรยาย แต่รักษาบทสนทนาและข้อความที่เห็นเป็นภาษาต้นฉบับ เนื้อหาพูดใช้ <d>[Language] ...</d> โดยตัวตนผู้พูดกับคำอธิบายเสียงอยู่นอกบล็อก แยกคำพูดในฉากจากเสียงบรรยายนอกจอ และระบุเมื่อประโยคต่อข้ามคัตหรือถูกตัดเมื่อจบ รักษาข้อความที่เห็นตรงตัวด้วย ให้ปริมาณคำพอดีระยะเวลาและตรวจตัวอักษรที่เรนเดอร์กับประโยคได้ยินร่วมกัน

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

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

สคีมาปัจจุบันต้องมีข้อความไม่ว่างทุกโหมด สูงสุด 7,000 อักขระต่อรายการ ภาพใช้ 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 วินาที model card จำกัดสื่ออ้างอิงผสมที่ 12 ไฟล์ เนื้อหาคำขอไม่เกิน 64 MB แยกจากเพดานรายไฟล์

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

รูปทรงเอาต์พุตและระบบครบชุด

อินเทอร์เฟซ H3 มี 768P และ 2K ข้อความล้วนต้องเลือกสัดส่วนแน่นอน: 21:9, 16:9, 4:3, 1:1, 3:4 หรือ 9:16 การสร้างเฟรมแรก/ท้ายตามอัตราส่วนภาพอินพุต ส่วนอ้างอิงใช้แบบปรับตามหรือระบุชัด ความยาวจำนวนเต็ม 4–15 วินาที

model card แยก H3-Context-IR ที่ตีความและเพิ่มบรีฟ H3-Base ที่สร้างภาพพร้อมเสียง และ H3-Regenerate-2K ที่สร้างความละเอียดสูง เช็กพอยต์ฐานที่เผยแพร่แยกงานตามเฟรมกับ omni-reference องค์ประกอบบริบทและสร้างใหม่แยกจากน้ำหนักฐาน จึงใช้ชื่อเช็กพอยต์เปิดอย่างเดียวพิสูจน์พฤติกรรมทั้งระบบไม่ได้

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

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

minimax/hailuo-3

MiniMax /minimax/hailuo-3

เริ่มต้น

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

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

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

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

ฟิลด์	ประเภท	ข้อกำหนด	ค่าและข้อจำกัด	ค่าเริ่มต้น
ฟิลด์`model`	ประเภท`string`	ข้อกำหนดจำเป็น	ค่าและข้อจำกัด minimax/hailuo-3	ค่าเริ่มต้น—
ฟิลด์`prompt`	ประเภท`string`	ข้อกำหนดจำเป็น	ค่าและข้อจำกัด	ค่าเริ่มต้น—
ฟิลด์`duration`	ประเภท`integer`	ข้อกำหนดจำเป็น	ค่าและข้อจำกัด 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ขั้นต่ำ: 1 สูงสุด: 600	ค่าเริ่มต้น—
ฟิลด์`resolution`	ประเภท`string`	ข้อกำหนดไม่บังคับ	ค่าและข้อจำกัด 2K	ค่าเริ่มต้น—
ฟิลด์`aspect_ratio`	ประเภท`string`	ข้อกำหนดไม่บังคับ	ค่าและข้อจำกัด 21:9, 16:9, 4:3, 1:1, 3:4, 9:16	ค่าเริ่มต้น—
ฟิลด์`generate_audio`	ประเภท`boolean`	ข้อกำหนดไม่บังคับ	ค่าและข้อจำกัด false, true	ค่าเริ่มต้น—
ฟิลด์`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

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

Reference to video · พรอมป์ต์ข้อความและข้อมูลอ้างอิงภาพ วิดีโอ หรือเสียงที่รองรับ · จำเป็น: model, prompt, duration, input_references

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

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

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

พารามิเตอร์	ข้อกำหนด
พารามิเตอร์`content_type`	ข้อกำหนดapplication/json
พารามิเตอร์`required`	ข้อกำหนดmodel, prompt, duration
พารามิเตอร์`material_types`	ข้อกำหนดtext, image, audio, video
พารามิเตอร์`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 โทเค็น
การตั้งค่าราคาวิดีโอ	ตารางอัตราค่าบริการ—	ปริมาณคาดการณ์—	หน่วยคิดค่าบริการต่อวินาทีของวิดีโอ	เงื่อนไขคิดค่าบริการไม่มีการระบุเงื่อนไขเพิ่มเติมในคีย์ราคานี้	ค่าบริการ ขาออก · ราคาวิดีโอ · ประมาณการเพื่อเปรียบเทียบเท่านั้น $0.26 ต่อวินาทีของวิดีโอ
การตั้งค่าภาพอ้างอิง	ตารางอัตราค่าบริการ—	ปริมาณคาดการณ์—	หน่วยคิดค่าบริการต่อภาพอ้างอิง	เงื่อนไขคิดค่าบริการ—	ค่าบริการ ขาเข้า · ภาพอ้างอิง · ประมาณการเพื่อเปรียบเทียบเท่านั้น $0.08 ต่อภาพอ้างอิง
การตั้งค่าต้นทุนการสร้างโดยประมาณ	ตารางอัตราค่าบริการ—	ปริมาณคาดการณ์ค่าประมาณสำหรับการสร้างหนึ่งครั้ง	หน่วยคิดค่าบริการ—	เงื่อนไขคิดค่าบริการ—	ค่าบริการ ขาออก · ค่าใช้จ่ายในการสร้างโดยประมาณ · ประมาณการเพื่อเปรียบเทียบเท่านั้น $1.3 ประมาณการก่อนสร้าง ค่าประมาณนี้ไม่ใช่ค่าใช้จ่ายเพิ่มเติมหรืออัตราคงที่สำหรับการสร้างผลลัพธ์ที่เสร็จสมบูรณ์แล้ว

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

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

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

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

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

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

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

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","prompt":"A serene mountain landscape at sunset","resolution":"2K"}', 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

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

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

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

minimax/hailuo-3

FAQ · MiniMax: H3

มีอินพุตและผลลัพธ์ใดบ้าง?: POST /v1/videos · minimax/hailuo-3: text, image, audio, video → video
คำขอใช้ฟิลด์ใดบ้าง?: POST /v1/videos · minimax/hailuo-3: model, prompt, duration, resolution, aspect_ratio, generate_audio, frame_images, input_references, callback_url, session_id, trace, user
มีข้อจำกัดใดบ้าง?: POST /v1/videos · minimax/hailuo-3: duration.minimum: 1; duration.maximum: 600; frame_images.max_items: 2; frame_images.min_items: 1

MiniMax: H3

MiniMax: H3

เริ่มต้น

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

ราคา

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

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

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

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

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

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

Ailoot Ultra · วิดีโอ

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

Ailoot Ultra · วิดีโอ

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

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

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

ชื่ออื่น

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

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

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

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

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

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