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

# MiniMax-Hailuo-2.3

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

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

MiniMax Hailuo 2.3 mencipta video daripada teks atau imej permulaan, dengan kawalan gerakan dan arah kamera. Pilih enam saat pada 768P atau 1080P, atau sepuluh saat pada 768P, untuk persembahan watak, adegan bergaya dan syot produk yang boleh disemak serta disunting.

- [**Ailoot · Penjanaan video** `POST /v1/videos/generations` `MiniMax-Hailuo-2.3`](https://ailoot.ai/models/ms/minimax-hailuo-2-3/#method-0)
- [**Ailoot Ultra · Video** `POST /v1/videos` `MiniMax-Hailuo-2.3`](https://ailoot.ai/models/ms/minimax-hailuo-2-3/#method-1)

Tentang model

Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.

MiniMax Hailuo 2.3 ialah model penjanaan video dengan mod teks-ke-video dan imej-ke-video. Ia mengembangkan Hailuo 02 dengan fokus pada tindakan fizikal, gaya visual, mikroekspresi watak dan respons terhadap arahan gerakan. Bekalkan adegan bertulis untuk mencipta syot dari awal, atau gunakan imej permulaan untuk menetapkan pandangan pembukaan dan terangkan pergerakan berikutnya.

Persembahan fizikal ialah salah satu bidang utama penambahbaikan edisi ini. Hailuo 2.3 bertujuan menjadikan gerakan badan lebih lancar dan terkawal, termasuk adegan dengan kamera bergerak. Rancang tindakan penting sebelum menambah butiran hiasan. Watak mengangkat objek, berpaling ke arah orang lain atau bergerak melalui bilik memberikan syot peristiwa visual untuk dinilai. Tentukan pergerakan yang membawa cerita, kemudian pastikan arahan sekeliling konsisten dengannya.

Penggayaan ialah fokus lain. Model menyokong kerja anime dan ilustrasi serta gaya seperti lukisan dakwat cair dan CG permainan. Terangkan olahan visual yang dikehendaki dan pastikan rupa koheren dengan adegan. Jika imej permulaan sudah menetapkan gaya lukisan, gunakan teks untuk membimbing animasi, bukannya memperkenalkan penerangan reka bentuk watak yang bersaing. Semak seluruh klip untuk melihat sama ada olahan itu kekal jelas semasa pergerakan.

Model turut menumpukan pada persembahan wajah dan perubahan ekspresi halus. Sediakan syot watak berdasarkan reaksi yang penting: menyedari objek, menjadi ingin tahu atau membalas dengan senyuman kecil. Pandangan dekat boleh memudahkan penilaian perubahan itu, manakala urutan gerak isyarat yang besar mungkin mengalih perhatian daripadanya. Periksa wajah sebelum, semasa dan selepas reaksi, bukannya menilai satu bingkai pegun wakil sahaja.

Gerakan objek berguna untuk adegan berpusatkan produk. Taklimat asal boleh menunjukkan pasu seramik kecil berpusing dalam cahaya sisi hangat sementara kamera mendekatinya secara beransur-ansur. Kenal pasti sifat yang mesti kekal dapat dikenali, seperti siluet, bibir dan kemasan permukaan. Semak butiran itu sepanjang pergerakan, kerana suasana yang meyakinkan sahaja tidak membuktikan pandangan produk yang setia.

Untuk teks-ke-video, penerangan wajib boleh mengandungi sehingga 2,000 aksara. Nyatakan subjek, tindakan, latar dan gaya visual dalam susunan koheren. Imej-ke-video memerlukan imej bingkai permulaan, dengan penerangan pilihan sehingga 2,000 aksara. Imej menetapkan komposisi pembukaan, jadi sediakan subjek dan pembingkaian sebelum meminta gerakan. Tinggalkan ruang yang kelihatan di tempat lengan, objek atau watak perlu bergerak.

Imej permulaan menerima JPG, JPEG, PNG atau WebP, mesti lebih kecil daripada 20 MB, memerlukan sisi pendek melebihi 300 piksel dan mesti mempunyai nisbah aspek antara 2:5 dengan 5:2. Ia boleh dibekalkan sebagai URL imej awam atau URL data Base64. Pilih gambar pembukaan jelas, bukannya bergantung pada animasi untuk membaiki wajah terlindung atau tindakan yang sudah terpangkas.

Hailuo 2.3 menjana pada 24 bingkai sesaat. Syot enam saat boleh menggunakan 768P atau 1080P; syot sepuluh saat menggunakan 768P. Lalainya ialah enam saat dan 768P. Pilih panjang untuk tindakan yang ingin dilihat: reaksi ringkas mungkin muat dalam syot pendek, manakala gerakan lebih perlahan memerlukan lebih ruang. Baca lebar dan tinggi sebenar hasil lengkap apabila meletakkan klip dalam suntingan, kerana label resolusi sahaja bukan keputusan pembingkaian penuh.

Arahan kamera boleh menggunakan perintah dalam kurungan siku. Kawalan yang tersedia merangkumi trucking, pan, tolakan masuk, gerakan pedestal, tilt, zum, gegaran, penjejakan dan syot statik. Perintah seperti \[Push in\] mengarahkan pendekatan; perintah yang dikumpulkan dalam satu kurungan bertindak bersama, manakala perintah yang diletakkan mengikut urutan menerangkan jujukan. MiniMax mengesyorkan maksimum tiga perintah serentak. Pastikan gerak kamera serasi dengan tindakan subjek supaya peristiwa utama kekal mudah diikuti.

Pengoptimuman prompt automatik didayakan secara lalai dan boleh dinyahdayakan untuk kawalan lebih rapat terhadap susunan kata yang dibekalkan. Prapemprosesan pantas pilihan mengurangkan masa pengoptimuman apabila pengoptimuman itu didayakan; ia tetapan berasingan daripada pemilihan model Hailuo 2.3 Fast. Hailuo 2.3 standard menyokong kedua-dua mod penciptaan, manakala Fast ialah edisi imej-ke-video yang berbeza. Pilih edisi berdasarkan sama ada projek bermula dengan teks sahaja atau bingkai sedia ada.

Aliran kerja penjanaan memulangkan pengecam tugas tak segerak, kemudian melaporkan persediaan, barisan menunggu, pemprosesan, kejayaan atau kegagalan. Apabila berjaya, hasil membekalkan pengecam fail dan dimensi video sebenar, dan video lengkap diperoleh untuk muat turun. Simpan klip semasa alamat muat turunnya sah. Rujukan muat turun video semasa pembuat memberikan URL muat turun yang dipulangkan jangka hayat satu jam. Untuk urutan suntingan, simpan setiap syot bersama prompt dan imej permulaannya supaya arah kreatif terpilih kekal dapat dijejak semasa semakan.

Semak tindakan, kesinambungan fizikal, butiran wajah atau produk, gaya visual dan tingkah laku kamera dalam klip tersimpan. Tonton seluruh syot, kemudian periksa awal dan akhirnya di tempat ia akan disambungkan dengan bahan lain. Jika permintaan mengandungi terlalu banyak pergerakan bersaing, mudahkan tindakan utama; jika reka bentuk pembukaan tidak jelas, perbaik imej permulaan. Pilih syot yang menyampaikan peristiwa yang dimaksudkan, kemudian tambah narasi, tajuk dan peralihan dalam aliran kerja penyuntingan.

**Ailoot · Penjanaan video** `POST /v1/videos/generations` `MiniMax-Hailuo-2.3`

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

MiniMax /`MiniMax-Hailuo-2.3`

### Pengenalan

MiniMax Hailuo 2.3 mencipta video daripada teks atau imej permulaan, dengan kawalan gerakan dan arah kamera. Pilih enam saat pada 768P atau 1080P, atau sepuluh saat pada 768P, untuk persembahan watak, adegan bergaya dan syot produk yang boleh disemak serta disunting.

Input yang diterima

Teks · Imej

Hasil

Video

### Tersedia di Ailoot · input & kaedah

**Ailoot · Penjanaan video** `POST /v1/videos/generations`

Input

`text`, `image`

Output

`video`

Format output

mp4

| Medan | Jenis | Keperluan | Nilai & had | Lalai |
| --- | --- | --- | --- | --- |
| Medan`model` | Jenis`string` | KeperluanDiperlukan | Nilai & had MiniMax-Hailuo-2.3 | Lalai— |
| Medan`prompt` | Jenis`string` | KeperluanDiperlukan | Nilai & had Panjang minimum: 1 Panjang maksimum: 2,000 Unit: aksara Unicode | Lalai— |
| Medan`duration` | Jenis`integer` | KeperluanPilihan | Nilai & had 6, 10 Syarat: 10 saat memerlukan 768P Unit: saat | Lalai6 |
| Medan`resolution` | Jenis`string` | KeperluanPilihan | Nilai & had 768P, 1080P Syarat: 1080P memerlukan 6 saat | Lalai768P |
| Medan`first_frame_image` | Jenis`https_url\|data_image_url` | KeperluanPilihan | Nilai & had Bait ternyahkod maksimum: 20,971,520 Jenis MIME: image/jpeg, image/png, image/webp Dimensi minimum (tidak termasuk): 300 Julat nisbah aspek: 2:5, 5:2 | Lalai— |
| Medan`prompt_optimizer` | Jenis`boolean` | KeperluanPilihan | Nilai & had | Lalai— |
| Medan`fast_pretreatment` | Jenis`boolean` | KeperluanPilihan | Nilai & had | Lalai— |

Gabungan bahan input

**Imej kepada video** · Diperlukan: prompt, first\_frame\_image

**Teks kepada video** · Diperlukan: prompt

Parameter kaedah dan kitar hayat

| Parameter | Kontrak |
| --- | --- |
| Parameter`material_types` | Kontraktext, image |
| Parameter`required` | Kontraknull |
| Parameter`optional_controls` | Kontraknull |

Kitar hayat: `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`

Struktur kaedah dan ID adalah tepat; keupayaan pembekal berasingan daripada penerimaan permintaan.

### Pelan harga

#### Kadar kaedah Ailoot

Output

USD 0.28 *bagi setiap video 6 s pada 768p*

Ailoot merizabkan anggaran amaun sebelum permintaan. Selepas hasil diterima, caj akhir diselesaikan berdasarkan penggunaan terukur. Penyelesaian caj penstriman menggunakan rekod penggunaan akhir. [Cara rizab dan penyelesaian caj berfungsi →](https://ailoot.ai/docs/ms/billing/reserve/)

#### Butiran tarif rujukan

Jadual rujukan peringkat model tidak mengubah pemilihan kaedah, sebut harga atau caj. Caj aktif menggunakan kadar kaedah Ailoot yang dipilih.

MiniMax-Hailuo-2.3

#### Harga mengikut konfigurasi

| Konfigurasi | Syarat pengebilan | Caj |
| --- | --- | --- |
| KonfigurasiMiniMax-Hailuo-2.3 · Konfigurasi lalai | Syarat pengebilanKonfigurasi lalai | Caj Input · Input **USD 0.00** bagi setiap panggilan Output · Output **USD 0.60** bagi setiap panggilan |

MiniMax-Hailuo-2.3

#### Harga mengikut konfigurasi

| Konfigurasi | Syarat pengebilan | Caj |
| --- | --- | --- |
| KonfigurasiMiniMax-Hailuo-2.3 · Konfigurasi lalai | Syarat pengebilanKonfigurasi lalai | Caj Input · Input **USD 0.00** bagi setiap panggilan Output · Output **USD 1.20** bagi setiap panggilan |

MiniMax-Hailuo-2.3

#### Harga mengikut konfigurasi

| Konfigurasi | Syarat pengebilan | Caj |
| --- | --- | --- |
| KonfigurasiMiniMax-Hailuo-2.3 · Konfigurasi lalai | Syarat pengebilanKonfigurasi lalai | Caj Input · Input **USD 0.00** bagi setiap panggilan Output · Output **USD 1.20** bagi setiap panggilan |

### Contoh permintaan

#### Ailoot · Penjanaan video

Contoh video

```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"}'
```

### Terima dan simpan hasil

#### Ailoot · Penjanaan video

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`

##### Semak status tugas

GET status

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

Pembacaan kandungan lain

GET kandungan

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

##### Simpan semua hasil yang selesai

Simpan setiap video yang selesai atau fail yang dikembalikan; dapatkan setiap URL aset yang benar-benar dikembalikan.

Kekalkan setiap item data/indeks output yang dikembalikan. content\_url hanya merujuk yang pertama; dapatkan setiap laluan kandungan/aset sebenar. GET kandungan tanpa index tidak merangkumi semua output.

##### Jika respons asal perlu disemak

Baca tugas asal yang sedia ada; jangan sekali-kali hantar semula penghantaran yang tidak diketahui hasilnya.

Medan respons

| Medan | Jenis |
| --- | --- |
| Medan`id` | Jenisstring |
| Medan`object` | Jenisstring |
| Medan`model` | Jenisstring |
| Medan`status` | Jenisstring |
| Medan`content_url` | Jenissigned URL |
| Medan`data[]` | Jenissigned URL |
| Medan`usage` | Jenisobject |
| Medan`result_pending_check` | Jenisboolean |

Ralat dan langkah seterusnya

| Respons | Syarat | Langkah seterusnya |
| --- | --- | --- |
| Respons400 · `invalid_request_error` | SyaratMedan wajib, perwakilan bahan atau nilai parameter tidak sah | Langkah seterusnyaBetulkan medan yang ditunjukkan sebelum permintaan penciptaan baharu. |
| Respons409 · `video_not_ready` | SyaratKandungan hasil asal belum tersedia | Langkah seterusnyaSemak ID asal yang dikembalikan secara berkala dan patuhi Retry-After. |
| Respons`server_error` | SyaratRespons yang dikembalikan menyatakan bahawa operasi atau hasil memerlukan semakan | Langkah seterusnyaSimpan ID operasi/tugas asal yang dikembalikan, pengepala permintaan dan respons; teruskan pembacaan yang disokong bagi operasi asal tersebut. Jangan hantar semula permintaan penciptaan. |

### Alias

#### Alias model

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

#### Alias laluan kaedah

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

#### ID pemanggil berkaitan

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

**Ailoot Ultra · Video** `POST /v1/videos` `MiniMax-Hailuo-2.3`

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

MiniMax /`MiniMax-Hailuo-2.3`

### Pengenalan

MiniMax Hailuo 2.3 mencipta video daripada teks atau imej permulaan, dengan kawalan gerakan dan arah kamera. Pilih enam saat pada 768P atau 1080P, atau sepuluh saat pada 768P, untuk persembahan watak, adegan bergaya dan syot produk yang boleh disemak serta disunting.

Input yang diterima

Teks

Hasil

Video

### Tersedia di Ailoot · input & kaedah

**Ailoot Ultra · Video** `POST /v1/videos`

Input

`text`

Output

`video`

Format output

mp4

Bilangan output

Sehingga 1 output

| Medan | Jenis | Keperluan | Nilai & had | Lalai |
| --- | --- | --- | --- | --- |
| Medan`model` | Jenis`string` | KeperluanDiperlukan | Nilai & had MiniMax-Hailuo-2.3 | Lalai— |
| Medan`prompt` | Jenis`string` | KeperluanDiperlukan | Nilai & had Panjang minimum: 1 Panjang maksimum: 2,000 Syarat: Untuk 768P: paling banyak 2000 titik kod Unicode. Untuk 1080P: kurang daripada 200 titik kod Unicode (maksimum 199). Prompt mesti mengandungi teks yang bukan aksara ruang putih. Unit: aksara Unicode | Lalai— |
| Medan`duration` | Jenis`integer` | KeperluanDiperlukan | Nilai & had 6 Unit: saat | Lalai— |
| Medan`resolution` | Jenis`string` | KeperluanDiperlukan | Nilai & had 768P, 1080P | Lalai— |

Gabungan bahan input

**Teks kepada video** · Diperlukan: prompt

Parameter kaedah dan kitar hayat

| Parameter | Kontrak |
| --- | --- |
| Parameter`content_type` | Kontrakapplication/json |
| Parameter`required` | Kontrakmodel, prompt, duration, resolution |
| Parameter`other_options` | Kontrakfalse |
| Parameter`duration` | Kontrak6 |
| Parameter`resolution` | Kontrak768P, 1080P |
| Parameter`prompt_max_characters` | Kontrak2000 |
| Parameter`material_types` | Kontraktext |
| Parameter`prompt_max_characters_by_resolution` | Kontrak{"768P":2000,"1080P":199} |

Alias kaedah: `/v1/videos/generations`, `/videos`, `/videos/generations`

Kitar hayat: `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`

Cipta sekali dan simpan ID yang dikembalikan.

Semak status asal secara berkala; simpan setiap aset siap berserta tempohnya.

### Pelan harga

Rujukan tarif tidak menambah pilihan permintaan. Parameter yang disokong disenaraikan untuk kaedah yang dipilih.

Mod pantas

Tidak dinyatakan Apabila mod pantas dipilih

Mod flex

Tidak dinyatakan Apabila mod flex dipilih

Usaha penaakulan maksimum

Tidak dinyatakan Apabila usaha penaakulan maksimum menggunakan pelarasan default

#### Kadar Ailoot

#### Harga mengikut konfigurasi

Padankan setiap caj dengan syarat yang dipaparkan. Gunakan satu kadar bagi setiap set konfigurasi alternatif.

| Konfigurasi | Jadual kadar | Tempoh nominal klip, saat | Resolusi | Unit pengebilan | Caj |
| --- | --- | --- | --- | --- | --- |
| KonfigurasiKadar asas token | Jadual kadarKadar asas | Tempoh nominal klip, saat— | Resolusi— | Unit pengebilan— | Caj Input · Token input **—** / 1K token Output · Token output **—** / 1K token Input · Bacaan cache **—** / 1K token Input · Penulisan cache **—** / 1K token Input · Penulisan cache, 1 jam **—** / 1K token |
| KonfigurasiUltra | Jadual kadar— | Tempoh nominal klip, saat6 | Resolusi1080P | Unit pengebilanbagi setiap klip keluaran nominal 6s | Caj Output · klip keluaran dengan tempoh nominal 6s **$1.2** bagi setiap klip keluaran nominal 6s |
| KonfigurasiUltra | Jadual kadar— | Tempoh nominal klip, saat6 | Resolusi768P | Unit pengebilanbagi setiap klip keluaran nominal 6s | Caj Output · klip keluaran dengan tempoh nominal 6s **$0.6** bagi setiap klip keluaran nominal 6s |

Ailoot merizabkan anggaran amaun sebelum permintaan. Selepas hasil diterima, caj akhir diselesaikan berdasarkan penggunaan terukur. Penyelesaian caj penstriman menggunakan rekod penggunaan akhir. [Cara rizab dan penyelesaian caj berfungsi →](https://ailoot.ai/docs/ms/billing/reserve/)

#### Butiran tarif rujukan

Jadual rujukan peringkat model tidak mengubah pemilihan kaedah, sebut harga atau caj. Caj aktif menggunakan kadar kaedah Ailoot yang dipilih.

MiniMax-Hailuo-2.3

#### Harga mengikut konfigurasi

| Konfigurasi | Syarat pengebilan | Caj |
| --- | --- | --- |
| KonfigurasiMiniMax-Hailuo-2.3 · Konfigurasi lalai | Syarat pengebilanKonfigurasi lalai | Caj Input · Input **USD 0.00** bagi setiap panggilan Output · Output **USD 0.60** bagi setiap panggilan |

MiniMax-Hailuo-2.3

#### Harga mengikut konfigurasi

| Konfigurasi | Syarat pengebilan | Caj |
| --- | --- | --- |
| KonfigurasiMiniMax-Hailuo-2.3 · Konfigurasi lalai | Syarat pengebilanKonfigurasi lalai | Caj Input · Input **USD 0.00** bagi setiap panggilan Output · Output **USD 1.20** bagi setiap panggilan |

MiniMax-Hailuo-2.3

#### Harga mengikut konfigurasi

| Konfigurasi | Syarat pengebilan | Caj |
| --- | --- | --- |
| KonfigurasiMiniMax-Hailuo-2.3 · Konfigurasi lalai | Syarat pengebilanKonfigurasi lalai | Caj Input · Input **USD 0.00** bagi setiap panggilan Output · Output **USD 1.20** bagi setiap panggilan |

### Contoh permintaan

#### Ailoot Ultra · Video

curlcurl · 1080P / 6 saat

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

### Terima dan simpan hasil

#### Ailoot Ultra · Video

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`

##### Semak status tugas

GET status

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

##### Simpan semua aset yang selesai

GET semua aset yang selesai

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

Pembacaan kandungan lain

GET kandungan

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

##### Simpan semua hasil yang selesai

Simpan setiap video yang selesai atau fail yang dikembalikan; dapatkan setiap URL aset yang benar-benar dikembalikan.

data\[\] yang lengkap mengandungi semua URL kandungan bertandatangan milik anda. Dapatkan setiap URL yang dikembalikan, atau gunakan titik akhir kandungan dengan index ditetapkan kepada indeks output sebenar. Tugas asal yang gagal mungkin mengembalikan charge\_pending\_check; semak tugas asal tersebut dan jangan ciptakannya semula.

##### Jika respons asal perlu disemak

Baca tugas asal yang sedia ada; jangan sekali-kali hantar semula penghantaran yang tidak diketahui hasilnya.

Output maksimum: 1.

Medan respons

| Medan | Jenis |
| --- | --- |
| Medan`id` | Jenisstring |
| Medan`object` | Jenisstring |
| Medan`model` | Jenisstring |
| Medan`status` | Jenisstring |
| Medan`data[]` | Jenissigned content URL |
| Medan`charge_pending_check` | Jenisboolean |
| Medan`error.code` | Jenisstring |
| Medan`error.message` | Jenisstring |
| Medan`requested_nominal_duration_seconds` | Jenisinteger |
| Medan`measured_duration_seconds` | Jenisnumber |
| Medan`width` | Jenisinteger |
| Medan`height` | Jenisinteger |

Ralat dan langkah seterusnya

| Respons | Syarat | Langkah seterusnya |
| --- | --- | --- |
| Respons400 · `invalid_request_error` | SyaratMedan wajib, perwakilan bahan atau nilai parameter tidak sah | Langkah seterusnyaBetulkan medan yang ditunjukkan sebelum permintaan penciptaan baharu. |
| Respons409 · `video_not_ready` | SyaratKandungan hasil asal belum tersedia | Langkah seterusnyaSemak ID asal yang dikembalikan secara berkala dan patuhi Retry-After. |
| Respons`server_error` | SyaratRespons yang dikembalikan menyatakan bahawa operasi atau hasil memerlukan semakan | Langkah seterusnyaSimpan ID operasi/tugas asal yang dikembalikan, pengepala permintaan dan respons; teruskan pembacaan yang disokong bagi operasi asal tersebut. Jangan hantar semula permintaan penciptaan. |

### Alias

#### Alias model

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

#### Alias laluan kaedah

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

#### ID pemanggil berkaitan

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

FAQ · MiniMax-Hailuo-2.3

Apakah input dan hasil yang tersedia?

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

Apakah medan yang digunakan oleh permintaan?

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

Apakah had yang terpakai?

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

Sambungkan Ailoot kepada Claude Code, OpenCode, Hermes atau aplikasi anda.

## Syarikat dan portfolio projeknya

Syarikat dan portfolio projeknya: jutaan pelanggan; jualan bernilai berbilion setiap bulan.

## Beli token dengan diskaun.

Diskaun langganan untuk penggunaan berkala. Kod promosi — sehingga 50% bagi pembelian token.

Langganan

Pilih pelan berdiskaun untuk permintaan berkala anda.

Kod promosi sehingga 50%

Masukkan kod semasa pembelian. Harga dikira semula mengikut promosi semasa.

Perbelanjaan dalam sejarah

Model, token dan jumlah disimpan bagi setiap permintaan.

[Pilih langganan](https://ailoot.ai/docs/ms/billing/subscriptions/) · [Lihat harga model](https://ailoot.ai/models/ms/)

## Sambungkan API kepada produk yang anda jual.

SaaS, aplikasi dan bot — di bawah tawaran rasmi serta perjanjian lesen Ailoot. Untuk jualan semula, mohon lesen penjual semula.

Aplikasi komersial

Tambahkan penjanaan teks, imej, video dan audio pada ciri berbayar perkhidmatan anda.

Lesen penjual semula

Hantar keterangan projek dan susunan akses. Minta terma penggunaan serta jualan semula secara bertulis.

Dokumen pada laman

Tawaran, perjanjian lesen dan dasar pemprosesan data tersedia sebelum sambungan.

[Mohon lesen penjual semula](mailto:support@ailoot.ai) · [Tawaran dan perjanjian lesen](https://ailoot.ai/legal/offer?lang=ms)

## Ailoot · Syarikat dan portfolio projeknya





Ailoot berteraskan pengalaman operasi yang mantap, pangkalan pelanggan yang besar, perkhidmatan yang stabil dan pemantauan KPI berterusan.





Syarikat dan portfolio projeknya: jutaan pelanggan; jualan bernilai berbilion setiap bulan.





Ailoot menggunakan pengalaman operasi ini untuk akses API kepada ciri AI dalam produk pelanggan, ejen, aplikasi dan automasi.