MiniMax H3
สร้างวิดีโอ
MiniMax H3 APIMiniMax-H3 · API สร้างวิดีโอ · minimaxh3.video

MiniMax H3 API สำหรับการสร้างวิดีโอระดับโปรดักชัน

สร้างเวิร์กโฟลว์ข้อความเป็นวิดีโอ ควบคุมเฟรมแรก/สุดท้าย และอ้างอิงแบบครบวงจรบน MiniMax H3 API สัญญาการทำงานแบบอะซิงโครนัสส่งคืน task_id แล้วตามด้วย URL ดาวน์โหลด

เปิดตัวสร้างวิดีโออ่านคู่มือพรอมต์
POST /api/v1/video_generation200 · task_id
curl --request POST \
  --url https://minimaxh3.video/api/v1/video_generation \
  --header "Authorization: Bearer $MINIMAX_H3_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "MiniMax-H3",
    "content": [
      {
        "type": "text",
        "text": "นักปั่นจักรยานข้ามถนนในเมืองยามค่ำคืนที่เปียกฝน แสงนีออนสะท้อนบนยางมะตอยเปียก กล้องติดตามข้างจักรยาน"
      }
    ],
    "duration": 5,
    "resolution": "2K",
    "ratio": "16:9"
  }'
ปลายทาง API
POST /api/v1/video_generation
รหัสโมเดล
MiniMax-H3
เวิร์กโฟลว์
งานแบบอะซิงโครนัส
ผลลัพธ์
2K · 4–15s
การยืนยันตัวตน
คีย์ API แบบ Bearer
ขีดจำกัดพรอมต์
7,000 ตัวอักษร
ข้อกำหนด API สาธารณะ

ปลายทาง MiniMax H3 เพียงหนึ่งจุด รองรับสามโหมดสร้างสรรค์

MiniMax-H3 ใช้อาร์เรย์ content แบบมัลติโหมด บทบาทที่แนบมาจะกำหนดว่าคำขอเป็น text-to-video first/last-frame image-to-video หรือ reference-to-video

01content: text

ข้อความเป็นวิดีโอ (t2va)

ส่งรายการข้อความที่จำเป็นเพื่อสร้างช็อตเต็มรูปแบบ สำหรับการสร้างจากข้อความล้วน ต้องระบุ ratio และห้ามใช้ค่า adaptive

02content: text + images

เฟรมแรก / เฟรมสุดท้าย (i2va)

เพิ่มไอเทม image_url ด้วยบทบาท first_frame และ last_frame ตัวเลือกเพื่อควบคุมองค์ประกอบตอนเปิดและตอนจบ

03content: text + refs

การสร้างด้วยสื่ออ้างอิง (r2va)

กำหนดทิศทางตัวละคร การเคลื่อนไหว กล้อง สไตล์ หรือเสียงด้วยรูปภาพ วิดีโอ และเสียงอ้างอิง—โดยไม่ผสมบทบาท first/last-frame

ความสามารถของ API

ควบคุมฉาก การอ้างอิง และสัญญาผลลัพธ์

MiniMax H3 มีเอกสารเป็นโมเดลวิดีโอมัลติโหมดอเนกประสงค์แบบเปิด พื้นผิว V2 ออกแบบสำหรับแบ็กเอนด์ผลิตภัณฑ์ ไม่ใช่เครื่องมือทดลองครั้งเดียว

อินพุตมัลติโหมด

ข้อความ รูปภาพ วิดีโอ และเสียงในคำขอเดียว

แต่ละองค์ประกอบ content มีประเภทและสามารถมีบทบาทได้ การอ้างอิงเสียงต้องมาพร้อมอินพุตรูปภาพหรือวิดีโอ

ช่วงผลลัพธ์

2K ดั้งเดิมสำหรับ 4–15 วินาที

duration รับจำนวนเต็มตั้งแต่ 4 ถึง 15 วินาที รองรับอัตราส่วนภาพทั่วไป และใช้ค่า adaptive ได้เมื่อสื่อต้นทางกำหนดสัดส่วนภาพ

ขนาดพรอมต์

คำสั่งสูงสุด 7,000 ตัวอักษร

ใช้งบประมาณสำหรับโครงสร้างช็อต การเคลื่อนไหว เส้นทางกล้อง เจตนาบทสนทนา และการจับคู่อ้างอิง—ไม่ใช่การสแปมคำสำคัญ

ข้อกำหนดของบทบาท

First/last frame และการอ้างอิงแยกกันใช้ไม่ได้

หากมีบทบาท reference_* ใดปรากฏ first_frame และ last_frame ต้องไม่มี การออกแบบการตรวจสอบตามกฎนี้ป้องกัน 400 ที่หลีกเลี่ยงได้

ผลลัพธ์แบบอะซิงโครนัส

task_id → status → content.url

งานที่สำเร็จส่งคืน URL ดาวน์โหลดที่มีเวลาจำกัดโดยตรงบนการตอบกลับการคิวรี่ บันทึกตัวระบุและเก็บไฟล์หากความทนทานสำคัญ

การจัดการงาน

รายการ ยกเลิก และหน้าต่างหมดอายุ

V2 มีเอกสาร list cancel/delete และหน้าต่างคิวรี่สั้นๆ สำหรับงานล่าสุด—ถือว่าการสร้างเป็นงานที่จัดการ ไม่ใช่การเรียก HTTP ยาวครั้งเดียว

กรณีใช้งานของผลิตภัณฑ์

ทีมต่างๆ สร้างอะไรด้วย MiniMax H3 API

ใช้เวิร์กโฟลว์อะซิงโครนัสเดียวกันได้ทั้งกับผลงานชิ้นเดียว เครื่องมือสำหรับครีเอเตอร์ และไปป์ไลน์แบบแบตช์

ผลิตภัณฑ์สำหรับครีเอเตอร์

การสร้างช็อตในแอป

ให้ผู้ใช้ส่งพรอมต์หรือเฟรมแรก แสดงสถานะคิว และส่งคลิป 2K เมืานงานสำเร็จ

ระบบแบรนด์

แคมเปญที่มีการอ้างอิงกำหนดทิศทาง

ถ่ายทอดตัวละคร ผลิตภัณฑ์ การเคลื่อนไหว หรือการอ้างอิงเสียงข้ามช็อตสั้นๆ โดยไม่ต้องสร้างเอกลักษณ์ใหม่ทุกครั้ง

เครื่องมือบรรณาธิการ

การเปลี่ยนผ่านจากต้นจนจบ

กำกับเฟรมเปิดและปิดที่ควบคุมได้เมื่อความต่อเนื่องของสตอรี่บอร์ดสำคัญกว่าการสร้างสรรค์ล้วนๆ

ไปป์ไลน์โซเชียล

อัตราส่วนแนวตั้งและภาพยนตร์

สร้างฮุก 9:16 หรือมาสเตอร์ช็อต 16:9 จากพื้นผิวการเชื่อมต่อเดียวแล้วแยกเฉพาะตาม ratio และ duration

แบ็กเอนด์เอเจนต์

งานมัลติโหมดในคิว

เอเจนต์สามารถประกอบอาร์เรย์ content ตรวจสอบสถานะ และส่ง content.url ให้ขั้นตอนการจัดเก็บ กลั่นกรอง หรือตัดต่อ

สตูดิโอต้นแบบ

การทดสอบทิศทางอย่างรวดเร็ว

สำรวจการผสมผสานกล้อง การแสดง และการอ้างอิงก่อนตัดสินใจลงไปป์ไลน์โปรดักชันเต็มรูปแบบ

เวิร์กโฟลว์แบบอะซิงโครนัส

จาก API key สู่วิดีโอ MiniMax H3 ที่ดาวน์โหลดได้

การสร้างไม่จำเป็นต้องเปิดคำขอ HTTP ไว้ตลอด บันทึกตัวระบุและดำเนินตามขั้นตอน V2 ที่มีเอกสาร

01
สร้าง

ส่งงานสร้างวิดีโอ

POST model MiniMax-H3 อาร์เรย์ content duration resolution และ ratio เมื่อจำเป็น การตอบกลับที่สำเร็จส่งคืน task_id

POST /api/v1/video_generation
02
ติดตาม

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

ตรวจสอบงานจนกว่าจะเข้าสู่สถานะสุดท้าย โดย queued และ running เป็นสถานะระหว่างทางที่ปกติ

GET /api/v1/video_generation/{task_id}
03
รับผลลัพธ์

ดาวน์โหลด content.url

เมื่อ succeeded การตอบกลับรวม content.url URL มีเวลาจำกัด—คัดลอกไฟล์เข้าที่จัดเก็บที่คุณควบคุมหากต้องการความทนทาน

content.url · mp4
การออกแบบคำขอ

ฟิลด์ที่กำหนดคำขอ MiniMax-H3 ที่เชื่อถือได้

ทำให้คำขอสาธารณะชัดเจนและตรวจสอบการผสมผสานเฉพาะโหมดก่อนส่งงาน

จำเป็น

model

ใช้ตัวระบุที่มีเอกสารตรง MiniMax-H3 อย่าสร้างชื่อเล่นผลิตภัณฑ์เป็น model ID

ข้อมูลมัลติโหมดที่จำเป็น

content[]

อย่างน้อยหนึ่งไอเทม type=text เพิ่มไอเทม image_url video_url หรือ audio_url ด้วยบทบาทสำหรับโหมดควบคุม

จำนวนเต็ม 4–15 วินาที

duration

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

ผลลัพธ์ตามเอกสาร

resolution

MiniMax H3 มีเอกสารสำหรับผลลัพธ์ 2K ยืนยันค่า enum ปัจจุบันกับ API reference ที่ใช้งานจริงก่อน deploy

การควบคุมสัดส่วนภาพ

ratio

จำเป็นสำหรับ text-to-video ล้วนและต้องไม่ปรับตามอัตโนมัติในโหมดนั้น เวิร์กโฟลว์ที่นำโดยรูปภาพสามารถตามเรขาคณิตต้นทางได้

บทบาทสื่อที่เลือกใช้ได้

first_frame · last_frame · reference_*

บทบาทเปลี่ยนสัญญาการสร้างสรรค์ ตรวจสอบการแยกกันใช้และขีดจำกัดขนาดต่อแอสเซทตอนอัปโหลด

สถานะงาน

จัดการสถานะเป็นลำดับขั้น

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

สถานะความหมายการทำงานที่แนะนำสำหรับแอป
queuedรอความจุบันทึก task_id และถอยห่างระหว่างการ poll
runningกำลังสร้างแสดงงานให้เห็น หลีกเลี่ยงการส่งซ้ำ
succeededวิดีโอพร้อมอ่าน content.url และเก็บแอสเซท
failedสร้างไม่สำเร็จแสดงรหัส/ข้อความข้อผิดพลาดและอนุญาตให้ลองใหม่ตามใจ
cancelledงานถูกยกเลิกปิด UI งานและเก็บบันทึกการตรวจสอบ
expiredงานไม่พร้อมใช้แล้วอย่าตรวจสอบต่อไปไม่สิ้นสุด ให้สร้างงานใหม่เมื่อจำเป็น

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

ข้อจำกัดของอินพุต

ตรวจสอบสื่อก่อนถึง MiniMax H3

ขีดจำกัดที่มีเอกสารง่ายพอที่จะบังคับใช้ตอนอัปโหลด ป้องกันความล้มเหลวของงานที่หลีกเลี่ยงได้

รูปภาพ

JPG, JPEG, PNG, WEBP, HEIC, HEIF · ≤ 30 MB

กว้าง/สูงใน [256, 5760] อัตราส่วนภาพระหว่าง 2:5 ถึง 5:2 First frame ≤ 1 last frame ≤ 1 รูปภาพอ้างอิง ≤ 9

วิดีโอ

MP4/MOV ด้วย H.264/H.265 · ≤ 50 MB ต่อไฟล์

สูงสุด 3 คลิปอ้างอิง แต่ละอัน 2–15s รวม ≤ 15s เสียงในวิดีโออาจเป็น AAC หรือ MP3

เสียง

WAV หรือ MP3 · ≤ 15 MB ต่อไฟล์

สูงสุด 3 คลิป แต่ละอัน 2–15s รวม ≤ 15s เสียงส่งเดี่ยวไม่ได้—จับคู่กับการอ้างอิงรูปภาพหรือวิดีโอ

สื่ออ้างอิงแบบผสม

สูงสุด 12 ไฟล์สื่อในคำขอเดียว

body คำขอควรอยู่ ≤ 64 MB แนะนำ URL สาธารณะสำหรับแอสเซทขนาดใหญ่แทน Base64

โหมดที่ใช้ร่วมกันไม่ได้

อย่าผสม first/last frame กับบทบาทอ้างอิง

เลือกควบคุมองค์ประกอบ (first/last) หรือการสร้างอ้างอิงครบวงจร—ไม่ใช่ทั้งคู่ในอาร์เรย์ content เดียว

พรอมต์

เก็บทิศทางไว้ใต้ 7,000 ตัวอักษร

จับคู่อ้างอิงในข้อความเมื่อเอกลักษณ์ เสียง หรือการเคลื่อนไหวต้องตามแอสเซทเฉพาะ

ราคาอยู่ในหน้ากำหนดราคา

อัตราเครดิตและขีดจำกัดแผนอาจเปลี่ยน เชื่อมโยงไปหน้ากำหนดราคา MiniMax H3 ที่ใช้งานจริงแทนการฝังตัวเลขลงในการเชื่อมต่อ

ความเหมาะสมในการใช้งาน

เหมาะสำหรับการสร้าง MiniMax H3 แบบอะซิงโครนัส

เลือก V2 API เมื่อผลิตภัณฑ์สามารถสร้างงานและรอแอสเซทที่สร้าง

เหมาะกับ

บริการแบ็กเอนด์และเครื่องมือครีเอเตอร์

การสร้างในคิว ที่จัดเก็บทนทาน และ UI สถานะ map สะอาดกับเวิร์กโฟลว์ task_id

เหมาะกับ

การควบคุมสร้างสรรค์แบบมัลติโหมด

ช็อตที่ผสมคำสั่งจากพรอมต์กับเฟรมแรก เฟรมสุดท้าย หรือสื่ออ้างอิง

ข้อจำกัด

ไม่ใช่ซ็อกเก็ตสตรีมมิงวิดีโอแบบเรียลไทม์

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

ขอบเขต

ออกแบบสำหรับงาน ไม่ใช่ซ็อกเก็ตเปิด

เก็บการสร้างระยะยาวในคิวแบ็กเอนด์และแสดงสถานะใน UI ผลิตภัณฑ์

คำถามเกี่ยวกับ API

คำถามเกี่ยวกับ MiniMax H3 API

คำตอบเชิงปฏิบัติก่อนเชื่อมต่อคำขอโปรดักชันแรก

MiniMax-H3 คือ model ID สำหรับ API นี้หรือไม่

ใช่ ส่ง model MiniMax-H3 บน endpoint การสร้างวิดีโอ MiniMax H3 เมื่อสร้างงาน

ควรเรียกปลายทาง API ใด

สร้างงานด้วย POST https://minimaxh3.video/api/v1/video_generation แล้วคิวรี่ GET https://minimaxh3.video/api/v1/video_generation/{task_id} เมื่อสำเร็จ ดาวน์โหลด mp4 จาก content.url

MiniMax H3 ต่างจากการเชื่อมต่อ Hailuo 2.3 อย่างไร

H3 เป็นโมเดลมัลติโหมดอเนกประสงค์ปัจจุบันด้วยสัญญา content[] ผลลัพธ์ 2K ที่มีเอกสาร duration 4–15s และการอ้างอิงครบวงจร Hailuo 2.3 ยังคงเป็นตระกูลโมเดลก่อนหน้าด้วยรูปแบบคำขอที่ต่างกัน

ใช้การควบคุมเฟรมแรกร่วมกับเสียงอ้างอิงได้หรือไม่

ไม่ได้ในคำขอเดียวกัน บทบาท first/last-frame และ reference_* แยกกันใช้ไม่ได้ เลือกโหมดที่ตรงกับการควบคุมที่ต้องการ

ต้องยืนยันตัวตนอย่างไร

ส่ง Bearer API key ใน header Authorization สร้างและจัดการคีย์จากการตั้งค่าบัญชี MiniMax H3 หลังได้รับสิทธิ์

ควรยืนยันราคาปัจจุบันที่ใด

ใช้หน้ากำหนดราคาของไซต์สำหรับแผนผลิตภัณฑ์และเครดิต การใช้งาน API ปฏิบัติตามกฎกระเป๋าเครดิตเดียวกันที่เผยแพร่ที่นั่น

พร้อมเชื่อมต่อ MiniMax H3

สร้างต้นแบบช็อต ส่งคำขอ API

กำหนดทิศทางสร้างสรรค์ในตัวสร้าง แล้วเรียก MiniMax H3 API บน minimaxh3.video ด้วยคีย์ของคุณ

เปิดตัวสร้างวิดีโออ่านคู่มือพรอมต์