Source: https://ailoot.ai/models/th/minimax-hailuo-2-3/
Canonical: https://ailoot.ai/models/th/minimax-hailuo-2-3/
Language: th

# MiniMax-Hailuo-2.3

[Markdown](https://ailoot.ai/models/th/minimax-hailuo-2-3/index.md) · [JSON](https://ailoot.ai/models/th/minimax-hailuo-2-3/facts.json)

## [MiniMax-Hailuo-2.3](https://ailoot.ai/models/th/minimax-hailuo-2-3/)

MiniMax Hailuo 2.3 สร้างวิดีโอจากข้อความหรือภาพเริ่ม พร้อมควบคุมการเคลื่อนไหวและกล้อง เลือกหกวินาทีที่ 768P หรือ 1080P หรือสิบวินาทีที่ 768P สำหรับการแสดงตัวละคร ฉากมีสไตล์ และช็อตสินค้าที่ตรวจและตัดต่อได้

- [**Ailoot · วิดีโอ** `POST /v1/videos/generations` `MiniMax-Hailuo-2.3`](https://ailoot.ai/models/th/minimax-hailuo-2-3/#method-0)
- [**Ailoot Ultra · วิดีโอ** `POST /v1/videos` `MiniMax-Hailuo-2.3`](https://ailoot.ai/models/th/minimax-hailuo-2-3/#method-1)

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

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

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

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

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

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

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

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

ภาพเริ่มรับ JPG, JPEG, PNG หรือ WebP ต้องเล็กกว่า 20 MB ด้านสั้นมากกว่า 300 พิกเซล และอัตราส่วนระหว่าง 2:5 กับ 5:2 ส่งผ่าน URL ภาพสาธารณะหรือ Base64 data URL เลือกภาพเปิดชัด แทนหวังให้แอนิเมชันซ่อมหน้าบังหรือการกระทำที่ครอปไปแล้ว

Hailuo 2.3 สร้างที่ 24 เฟรมต่อวินาที ช็อตหกวินาทีใช้ 768P หรือ 1080P ส่วนสิบวินาทีใช้ 768P ค่าเริ่มต้นหกวินาที 768P เลือกเวลาตามการกระทำ ปฏิกิริยาสั้นอาจใช้ช็อตสั้น ส่วนเคลื่อนช้าต้องมีที่ อ่านความกว้างสูงจริงเมื่อวางงานตัดต่อ เพราะชื่อความละเอียดไม่ใช่การกำหนดกรอบทั้งหมด

กำกับกล้องด้วยคำสั่งในวงเล็บเหลี่ยมได้ ครอบคลุมเลื่อนข้าง แพน ดันกล้อง ยกหรือลดระดับ เงยหรือก้ม ซูม สั่น แทร็ก และนิ่ง เช่น \[Push in\] กำกับเข้าหา คำสั่งในวงเล็บเดียวทำพร้อมกัน ส่วนเรียงวงเล็บเป็นลำดับ MiniMax แนะนำพร้อมกันไม่เกินสามคำสั่ง ให้กล้องเข้าการกระทำเพื่อเหตุการณ์หลักติดตามง่าย

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

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

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

**Ailoot · วิดีโอ** `POST /v1/videos/generations` `MiniMax-Hailuo-2.3`

[`MiniMax-Hailuo-2.3`](https://ailoot.ai/models/th/#m=MiniMax-Hailuo-2.3&route=Core&caller=MiniMax-Hailuo-2.3&fmt=videos)

MiniMax /`MiniMax-Hailuo-2.3`

### เริ่มต้น

MiniMax Hailuo 2.3 สร้างวิดีโอจากข้อความหรือภาพเริ่ม พร้อมควบคุมการเคลื่อนไหวและกล้อง เลือกหกวินาทีที่ 768P หรือ 1080P หรือสิบวินาทีที่ 768P สำหรับการแสดงตัวละคร ฉากมีสไตล์ และช็อตสินค้าที่ตรวจและตัดต่อได้

อินพุตที่รองรับ

ข้อความ · รูปภาพ

ผลลัพธ์

วิดีโอ

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

**Ailoot · วิดีโอ** `POST /v1/videos/generations`

ขาเข้า

`text`, `image`

ขาออก

`video`

รูปแบบเอาต์พุต

mp4

| ฟิลด์ | ประเภท | ข้อกำหนด | ค่าและข้อจำกัด | ค่าเริ่มต้น |
| --- | --- | --- | --- | --- |
| ฟิลด์`model` | ประเภท`string` | ข้อกำหนดจำเป็น | ค่าและข้อจำกัด MiniMax-Hailuo-2.3 | ค่าเริ่มต้น— |
| ฟิลด์`prompt` | ประเภท`string` | ข้อกำหนดจำเป็น | ค่าและข้อจำกัด ความยาวขั้นต่ำ: 1 ความยาวสูงสุด: 2,000 หน่วย: อักขระ Unicode | ค่าเริ่มต้น— |
| ฟิลด์`duration` | ประเภท`integer` | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด 6, 10 เงื่อนไข: ระยะเวลา 10 วินาทีต้องใช้ 768P หน่วย: วินาที | ค่าเริ่มต้น6 |
| ฟิลด์`resolution` | ประเภท`string` | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด 768P, 1080P เงื่อนไข: 1080P ต้องใช้ 6 วินาที | ค่าเริ่มต้น768P |
| ฟิลด์`first_frame_image` | ประเภท`https_url\|data_image_url` | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด จำนวนไบต์สูงสุดหลังถอดรหัส: 20,971,520 ประเภท MIME: image/jpeg, image/png, image/webp ขนาดขั้นต่ำแบบไม่รวมค่าขั้นต่ำ: 300 ช่วงอัตราส่วนภาพ: 2:5, 5:2 | ค่าเริ่มต้น— |
| ฟิลด์`prompt_optimizer` | ประเภท`boolean` | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด | ค่าเริ่มต้น— |
| ฟิลด์`fast_pretreatment` | ประเภท`boolean` | ข้อกำหนดไม่บังคับ | ค่าและข้อจำกัด | ค่าเริ่มต้น— |

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

**สร้างวิดีโอจากภาพ** · จำเป็น: prompt, first\_frame\_image

**สร้างวิดีโอจากข้อความ** · จำเป็น: prompt

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

| พารามิเตอร์ | ข้อกำหนด |
| --- | --- |
| พารามิเตอร์`material_types` | ข้อกำหนดtext, image |
| พารามิเตอร์`required` | ข้อกำหนดnull |
| พารามิเตอร์`optional_controls` | ข้อกำหนดnull |

วงจรการทำงาน: `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 ระบุอย่างแม่นยำ ความสามารถของผู้ให้บริการแยกจากการอนุญาตให้รับคำขอ

### ราคา

#### อัตราค่าบริการเมธอด Ailoot

ขาออก

US$0.28 *ต่อวิดีโอความยาว 6 วินาทีที่ความละเอียด 768p*

Ailoot กันยอดเงินประมาณการไว้ก่อนส่งคำขอ หลังได้ผลลัพธ์ จะคิดค่าบริการสุดท้ายตามการใช้งานที่วัดได้ การคิดค่าบริการแบบสตรีมใช้บันทึกการใช้งานสุดท้าย [วิธีกันยอดเงินและคิดค่าบริการสุดท้าย →](https://ailoot.ai/docs/th/billing/reserve/)

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

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

MiniMax-Hailuo-2.3

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

| การตั้งค่า | เงื่อนไขคิดค่าบริการ | ค่าบริการ |
| --- | --- | --- |
| การตั้งค่าMiniMax-Hailuo-2.3 · การตั้งค่าเริ่มต้น | เงื่อนไขคิดค่าบริการการตั้งค่าเริ่มต้น | ค่าบริการ ขาเข้า · ขาเข้า **US$0.00** ต่อการเรียก ขาออก · ขาออก **US$0.60** ต่อการเรียก |

MiniMax-Hailuo-2.3

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

| การตั้งค่า | เงื่อนไขคิดค่าบริการ | ค่าบริการ |
| --- | --- | --- |
| การตั้งค่าMiniMax-Hailuo-2.3 · การตั้งค่าเริ่มต้น | เงื่อนไขคิดค่าบริการการตั้งค่าเริ่มต้น | ค่าบริการ ขาเข้า · ขาเข้า **US$0.00** ต่อการเรียก ขาออก · ขาออก **US$1.20** ต่อการเรียก |

MiniMax-Hailuo-2.3

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

| การตั้งค่า | เงื่อนไขคิดค่าบริการ | ค่าบริการ |
| --- | --- | --- |
| การตั้งค่าMiniMax-Hailuo-2.3 · การตั้งค่าเริ่มต้น | เงื่อนไขคิดค่าบริการการตั้งค่าเริ่มต้น | ค่าบริการ ขาเข้า · ขาเข้า **US$0.00** ต่อการเรียก ขาออก · ขาออก **US$1.20** ต่อการเรียก |

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

#### Ailoot · วิดีโอ

ตัวอย่างวิดีโอ

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl https://api.ailoot.ai/v1/videos/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "MiniMax-Hailuo-2.3", "prompt": "A person walks slowly through a quiet garden as the camera tracks from the side.", "duration": 6, "resolution": "768P"}'
```

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

#### Ailoot · วิดีโอ

mp4

- `GET /v1/videos/{request_id}`
- `GET /v1/videos/generations/{request_id}`
- `GET /v1/videos/{request_id}/content`
- `GET /v1/videos/generations/{request_id}/content`

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

GET · ดูสถานะ

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id" \
  -H "Authorization: Bearer $AILOOT_API_KEY"
```

การอ่านเนื้อหาแบบอื่น

GET · ดึงเนื้อหา

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id/content" \
  -H "Authorization: Bearer $AILOOT_API_KEY" \
  --output video.mp4
```

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

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

เก็บข้อมูลทุกรายการ/ดัชนีผลลัพธ์ที่ส่งกลับ content\_url ระบุเฉพาะรายการแรก เรียกพาธเนื้อหา/แอสเซ็ตจริงทุกรายการ GET เนื้อหาโดยไม่มี index ไม่ได้ให้ผลลัพธ์ทั้งหมด

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

อ่านงานเดิมที่มีอยู่ ห้ามส่งซ้ำเมื่อไม่ทราบผลการส่ง

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

| ฟิลด์ | ประเภท |
| --- | --- |
| ฟิลด์`id` | ประเภทstring |
| ฟิลด์`object` | ประเภทstring |
| ฟิลด์`model` | ประเภทstring |
| ฟิลด์`status` | ประเภทstring |
| ฟิลด์`content_url` | ประเภทsigned URL |
| ฟิลด์`data[]` | ประเภทsigned URL |
| ฟิลด์`usage` | ประเภทobject |
| ฟิลด์`result_pending_check` | ประเภทboolean |

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

| การตอบกลับ | เงื่อนไข | ขั้นตอนถัดไป |
| --- | --- | --- |
| การตอบกลับ400 · `invalid_request_error` | เงื่อนไขฟิลด์จำเป็น รูปแบบการแทนข้อมูล หรือค่าพารามิเตอร์ไม่ถูกต้อง | ขั้นตอนถัดไปแก้ฟิลด์ที่ระบุก่อนส่งคำขอสร้างครั้งใหม่ |
| การตอบกลับ409 · `video_not_ready` | เงื่อนไขเนื้อหาผลลัพธ์เดิมยังไม่พร้อมใช้งาน | ขั้นตอนถัดไปตรวจสอบ ID เดิมที่ส่งกลับเป็นระยะ และปฏิบัติตาม Retry-After |
| การตอบกลับ`server_error` | เงื่อนไขการตอบกลับที่ได้รับระบุว่าต้องตรวจสอบการดำเนินการหรือผลลัพธ์ | ขั้นตอนถัดไปเก็บ ID การดำเนินการ/งานที่ส่งกลับมาแต่เดิม ส่วนหัวของคำขอ และการตอบกลับไว้ แล้วอ่านข้อมูลการดำเนินการเดิมนั้นต่อด้วยวิธีที่รองรับ ห้ามส่งคำขอสร้างซ้ำ |

### ชื่ออื่น

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

<strong>Ailoot</strong> [`MiniMax-Hailuo-2.3`](https://ailoot.ai/models/th/#m=MiniMax-Hailuo-2.3&route=Core&caller=MiniMax-Hailuo-2.3&fmt=videos)
**Ailoot Ultra** [`MiniMax-Hailuo-2.3`](https://ailoot.ai/models/th/#m=MiniMax-Hailuo-2.3&route=Ultra&caller=MiniMax-Hailuo-2.3&fmt=videos)

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

`/v1/videos/generations`, `/videos`, `/videos/generations`

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

[`MiniMax-Hailuo-2.3`](https://ailoot.ai/models/th/#m=MiniMax-Hailuo-2.3&route=Core&caller=MiniMax-Hailuo-2.3&fmt=videos), [`MiniMax-Hailuo-2.3`](https://ailoot.ai/models/th/#m=MiniMax-Hailuo-2.3&route=Ultra&caller=MiniMax-Hailuo-2.3&fmt=videos)

**Ailoot Ultra · วิดีโอ** `POST /v1/videos` `MiniMax-Hailuo-2.3`

[`MiniMax-Hailuo-2.3`](https://ailoot.ai/models/th/#m=MiniMax-Hailuo-2.3&route=Ultra&caller=MiniMax-Hailuo-2.3&fmt=videos)

MiniMax /`MiniMax-Hailuo-2.3`

### เริ่มต้น

MiniMax Hailuo 2.3 สร้างวิดีโอจากข้อความหรือภาพเริ่ม พร้อมควบคุมการเคลื่อนไหวและกล้อง เลือกหกวินาทีที่ 768P หรือ 1080P หรือสิบวินาทีที่ 768P สำหรับการแสดงตัวละคร ฉากมีสไตล์ และช็อตสินค้าที่ตรวจและตัดต่อได้

อินพุตที่รองรับ

ข้อความ

ผลลัพธ์

วิดีโอ

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

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

ขาเข้า

`text`

ขาออก

`video`

รูปแบบเอาต์พุต

mp4

จำนวนเอาต์พุต

ไม่เกิน 1 เอาต์พุต

| ฟิลด์ | ประเภท | ข้อกำหนด | ค่าและข้อจำกัด | ค่าเริ่มต้น |
| --- | --- | --- | --- | --- |
| ฟิลด์`model` | ประเภท`string` | ข้อกำหนดจำเป็น | ค่าและข้อจำกัด MiniMax-Hailuo-2.3 | ค่าเริ่มต้น— |
| ฟิลด์`prompt` | ประเภท`string` | ข้อกำหนดจำเป็น | ค่าและข้อจำกัด ความยาวขั้นต่ำ: 1 ความยาวสูงสุด: 2,000 เงื่อนไข: สำหรับ 768P: ไม่เกิน 2000 โค้ดพอยต์ Unicode สำหรับ 1080P: น้อยกว่า 200 โค้ดพอยต์ Unicode (สูงสุด 199) พรอมป์ต์ต้องมีข้อความที่ไม่ใช่อักขระช่องว่าง หน่วย: อักขระ Unicode | ค่าเริ่มต้น— |
| ฟิลด์`duration` | ประเภท`integer` | ข้อกำหนดจำเป็น | ค่าและข้อจำกัด 6 หน่วย: วินาที | ค่าเริ่มต้น— |
| ฟิลด์`resolution` | ประเภท`string` | ข้อกำหนดจำเป็น | ค่าและข้อจำกัด 768P, 1080P | ค่าเริ่มต้น— |

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

**สร้างวิดีโอจากข้อความ** · จำเป็น: prompt

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

| พารามิเตอร์ | ข้อกำหนด |
| --- | --- |
| พารามิเตอร์`content_type` | ข้อกำหนดapplication/json |
| พารามิเตอร์`required` | ข้อกำหนดmodel, prompt, duration, resolution |
| พารามิเตอร์`other_options` | ข้อกำหนดfalse |
| พารามิเตอร์`duration` | ข้อกำหนด6 |
| พารามิเตอร์`resolution` | ข้อกำหนด768P, 1080P |
| พารามิเตอร์`prompt_max_characters` | ข้อกำหนด2000 |
| พารามิเตอร์`material_types` | ข้อกำหนดtext |
| พารามิเตอร์`prompt_max_characters_by_resolution` | ข้อกำหนด{"768P":2000,"1080P":199} |

ชื่ออื่นของเมธอด: `/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 | ความละเอียด1080P | หน่วยคิดค่าบริการต่อคลิปเอาต์พุตที่มีความยาวตามที่ระบุ 6s | ค่าบริการ ขาออก · คลิปขาออกความยาวตามค่าระบุ 6s **$1.2** ต่อคลิปเอาต์พุตที่มีความยาวตามที่ระบุ 6s |
| การตั้งค่าUltra | ตารางอัตราค่าบริการ— | ความยาวคลิปตามที่ระบุ หน่วยวินาที6 | ความละเอียด768P | หน่วยคิดค่าบริการต่อคลิปเอาต์พุตที่มีความยาวตามที่ระบุ 6s | ค่าบริการ ขาออก · คลิปขาออกความยาวตามค่าระบุ 6s **$0.6** ต่อคลิปเอาต์พุตที่มีความยาวตามที่ระบุ 6s |

Ailoot กันยอดเงินประมาณการไว้ก่อนส่งคำขอ หลังได้ผลลัพธ์ จะคิดค่าบริการสุดท้ายตามการใช้งานที่วัดได้ การคิดค่าบริการแบบสตรีมใช้บันทึกการใช้งานสุดท้าย [วิธีกันยอดเงินและคิดค่าบริการสุดท้าย →](https://ailoot.ai/docs/th/billing/reserve/)

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

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

MiniMax-Hailuo-2.3

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

| การตั้งค่า | เงื่อนไขคิดค่าบริการ | ค่าบริการ |
| --- | --- | --- |
| การตั้งค่าMiniMax-Hailuo-2.3 · การตั้งค่าเริ่มต้น | เงื่อนไขคิดค่าบริการการตั้งค่าเริ่มต้น | ค่าบริการ ขาเข้า · ขาเข้า **US$0.00** ต่อการเรียก ขาออก · ขาออก **US$0.60** ต่อการเรียก |

MiniMax-Hailuo-2.3

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

| การตั้งค่า | เงื่อนไขคิดค่าบริการ | ค่าบริการ |
| --- | --- | --- |
| การตั้งค่าMiniMax-Hailuo-2.3 · การตั้งค่าเริ่มต้น | เงื่อนไขคิดค่าบริการการตั้งค่าเริ่มต้น | ค่าบริการ ขาเข้า · ขาเข้า **US$0.00** ต่อการเรียก ขาออก · ขาออก **US$1.20** ต่อการเรียก |

MiniMax-Hailuo-2.3

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

| การตั้งค่า | เงื่อนไขคิดค่าบริการ | ค่าบริการ |
| --- | --- | --- |
| การตั้งค่าMiniMax-Hailuo-2.3 · การตั้งค่าเริ่มต้น | เงื่อนไขคิดค่าบริการการตั้งค่าเริ่มต้น | ค่าบริการ ขาเข้า · ขาเข้า **US$0.00** ต่อการเรียก ขาออก · ขาออก **US$1.20** ต่อการเรียก |

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

#### Ailoot Ultra · วิดีโอ

curlcurl · 1080P / 6 วินาที

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "MiniMax-Hailuo-2.3", "prompt": "A cat in a spacesuit walking on the Moon", "duration": 6, "resolution": "768P"}')

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
```

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "MiniMax-Hailuo-2.3", "prompt": "A cat in a spacesuit walking on the Moon", "duration": 6, "resolution": "1080P"}')

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}/content`
- `GET /v1/videos/generations/{request_id}/content`

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

GET · ดูสถานะ

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_OPERATION_ID
operation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/$operation_id" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o status.json
python3 - <<'PY_STATUS'
import json
from pathlib import Path
r=json.loads(Path("status.json").read_text())
print(json.dumps(r))
if r.get("status")=="completed":
    for x in r.get("data",[]):print(x)
PY_STATUS
```

##### บันทึกไฟล์ที่สร้างเสร็จทั้งหมด

GET · ดึงไฟล์สื่อที่เสร็จสมบูรณ์ทั้งหมด

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"
export AILOOT_STATUS_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
from urllib.parse import urlsplit,urljoin
f=Path(os.environ["AILOOT_STATUS_FILE"])
if not f.is_file():raise SystemExit("Choose the actual completed status file")
r=json.loads(f.read_text())
if r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")
urls=[]
for x in r["data"]:
    if not isinstance(x,str) or "\n" in x or "\r" in x:raise SystemExit("Invalid asset path")
    u=urljoin("https://api.ailoot.ai",x)
    z=urlsplit(u)
    if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")
    urls.append(u)
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_REQUEST
index=0
while IFS= read -r asset_url; do
  curl --fail-with-body --silent --show-error "$asset_url" \
    -H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"
  index=$((index + 1))
done < asset-urls.txt
```

การอ่านเนื้อหาแบบอื่น

GET · ดึงเนื้อหา

```bash
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_OPERATION_ID
operation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/$operation_id/content" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4
```

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

บันทึกวิดีโอที่สร้างเสร็จหรือไฟล์ที่ส่งกลับมาทุกไฟล์ และดึงไฟล์สื่อจากทุก 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 |

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

| การตอบกลับ | เงื่อนไข | ขั้นตอนถัดไป |
| --- | --- | --- |
| การตอบกลับ400 · `invalid_request_error` | เงื่อนไขฟิลด์จำเป็น รูปแบบการแทนข้อมูล หรือค่าพารามิเตอร์ไม่ถูกต้อง | ขั้นตอนถัดไปแก้ฟิลด์ที่ระบุก่อนส่งคำขอสร้างครั้งใหม่ |
| การตอบกลับ409 · `video_not_ready` | เงื่อนไขเนื้อหาผลลัพธ์เดิมยังไม่พร้อมใช้งาน | ขั้นตอนถัดไปตรวจสอบ ID เดิมที่ส่งกลับเป็นระยะ และปฏิบัติตาม Retry-After |
| การตอบกลับ`server_error` | เงื่อนไขการตอบกลับที่ได้รับระบุว่าต้องตรวจสอบการดำเนินการหรือผลลัพธ์ | ขั้นตอนถัดไปเก็บ ID การดำเนินการ/งานที่ส่งกลับมาแต่เดิม ส่วนหัวของคำขอ และการตอบกลับไว้ แล้วอ่านข้อมูลการดำเนินการเดิมนั้นต่อด้วยวิธีที่รองรับ ห้ามส่งคำขอสร้างซ้ำ |

### ชื่ออื่น

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

<strong>Ailoot</strong> [`MiniMax-Hailuo-2.3`](https://ailoot.ai/models/th/#m=MiniMax-Hailuo-2.3&route=Core&caller=MiniMax-Hailuo-2.3&fmt=videos)
**Ailoot Ultra** [`MiniMax-Hailuo-2.3`](https://ailoot.ai/models/th/#m=MiniMax-Hailuo-2.3&route=Ultra&caller=MiniMax-Hailuo-2.3&fmt=videos)

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

`/v1/videos/generations`, `/videos`, `/videos/generations`

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

[`MiniMax-Hailuo-2.3`](https://ailoot.ai/models/th/#m=MiniMax-Hailuo-2.3&route=Core&caller=MiniMax-Hailuo-2.3&fmt=videos), [`MiniMax-Hailuo-2.3`](https://ailoot.ai/models/th/#m=MiniMax-Hailuo-2.3&route=Ultra&caller=MiniMax-Hailuo-2.3&fmt=videos)

FAQ · MiniMax-Hailuo-2.3

มีอินพุตและผลลัพธ์ใดบ้าง?

`POST /v1/videos/generations` · `MiniMax-Hailuo-2.3`: `text`, `image` → `video` `POST /v1/videos` · `MiniMax-Hailuo-2.3`: `text` → `video`

คำขอใช้ฟิลด์ใดบ้าง?

`POST /v1/videos/generations` · `MiniMax-Hailuo-2.3`: `model`, `prompt`, `duration`, `resolution`, `first_frame_image`, `prompt_optimizer`, `fast_pretreatment` `POST /v1/videos` · `MiniMax-Hailuo-2.3`: `model`, `prompt`, `duration`, `resolution`

มีข้อจำกัดใดบ้าง?

`POST /v1/videos/generations` · `MiniMax-Hailuo-2.3`: `prompt.maximum_length`: `2000` `POST /v1/videos` · `MiniMax-Hailuo-2.3`: `prompt.maximum_length`: `2000`

เชื่อม Ailoot กับ Claude Code, OpenCode, Hermes หรือแอปของคุณ

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

บริษัทและพอร์ตโฟลิโอโครงการของบริษัท: ลูกค้าหลายล้านราย; ยอดขายระดับหลายพันล้านต่อเดือน.

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

ส่วนลดสมาชิกสำหรับงานประจำ โค้ดโปรโมชั่นลดซื้อโทเคนสูงสุด 50%

สมาชิก

เลือกแพ็กเกจมีส่วนลดสำหรับคำขอประจำ

โค้ดลดสูงสุด 50%

ใส่โค้ดขณะซื้อ ราคาคำนวณใหม่ตามโปรโมชั่นที่ใช้

รายจ่ายในประวัติ

เก็บโมเดล โทเคน และยอดสำหรับทุกคำขอ

[เลือกสมาชิก](https://ailoot.ai/docs/th/billing/subscriptions/) · [ดูราคาโมเดล](https://ailoot.ai/models/th/)

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

SaaS แอป และบอต ตามข้อเสนอและสัญญาอนุญาต Ailoot หากขายต่อให้ขอใบอนุญาตรีเซลเลอร์

แอปเชิงพาณิชย์

ใส่การสร้างข้อความ ภาพ วิดีโอ และเสียงในฟีเจอร์เสียเงินของบริการคุณ

ใบอนุญาตรีเซลเลอร์

ส่งคำอธิบายโครงการและรูปแบบการเข้าถึง ขอเงื่อนไขใช้และขายต่อเป็นลายลักษณ์อักษร

เอกสารบนเว็บไซต์

อ่านข้อเสนอ สัญญาอนุญาต และนโยบายประมวลผลข้อมูลก่อนเชื่อมได้

[ขอใบอนุญาตขายต่อ](mailto:support@ailoot.ai) · [ข้อเสนอและสัญญาอนุญาต](https://ailoot.ai/legal/offer?lang=th)

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





Ailoot อาศัยประสบการณ์การดำเนินงานที่สั่งสม ฐานลูกค้าขนาดใหญ่ บริการที่เสถียร และการติดตาม KPI อย่างต่อเนื่อง





บริษัทและพอร์ตโฟลิโอโครงการของบริษัท: ลูกค้าหลายล้านราย; ยอดขายระดับหลายพันล้านต่อเดือน.





Ailoot นำประสบการณ์การดำเนินงานนี้มาใช้เพื่อให้เข้าถึงฟังก์ชัน AI ผ่าน API ในผลิตภัณฑ์ของลูกค้า เอเจนต์ แอปพลิเคชัน และระบบอัตโนมัติ