Hailuo 2.3 Fast
MiniMax Hailuo 2.3 Fast menganimasikan gambar bingkai pertama dari prompt gerak singkat. Pilih profil gambar ke video ini untuk shot produk, pose karakter, atau gambar diam storyboard.
Tentang model
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
MiniMax Hailuo 2.3 Fast adalah profil bernama Fast untuk generasi gambar ke video. Mulailah dengan gambar bingkai pertama yang sudah dikomposisikan dan jelaskan bagaimana subjek atau kamera harus bergerak. Gambar produk, pose karakter, atau bingkai storyboard memberikan titik awal visual yang konkret bagi shot.
Siapkan gambar dan arahan gerak
Berikan gambar PNG atau JPEG persegi melalui URL HTTPS, dengan setiap sisi antara 300 dan 4.096 piksel. Berkas gambar yang diunduh tidak boleh lebih besar dari 20.000.000 byte. Pertahankan prompt antara 1 dan 199 karakter, berfokus pada satu tindakan visual dan gerakan yang penting bagi shot.
Ikuti klip hingga selesai
Profil ini dikonfigurasi untuk satu klip MP4 768 × 768 dengan durasi nominal enam detik. Kirim permintaan sekali, simpan ID yang dikembalikan, dan ikuti permintaan asli itu hingga selesai. Unduh video yang dikembalikan dan simpan dimensi yang dilaporkan serta durasi terukur bersama hasil. Jika hasil pembuatan tidak pasti, lanjutkan memeriksa permintaan asli, alih-alih membuatnya lagi.
Ailoot Ultra · Video POST /v1/videos MiniMax-Hailuo-2.3-Fast
MiniMax-Hailuo-2.3-FastMulai
MiniMax Hailuo 2.3 Fast menganimasikan gambar bingkai pertama dari prompt gerak singkat. Pilih profil gambar ke video ini untuk shot produk, pose karakter, atau gambar diam storyboard.
- Masukan yang diterima
- Teks · Gambar
- Hasil
- Video
Tersedia di Ailoot · masukan & metode
Ailoot Ultra · Video POST /v1/videos
- Masukan
text,image- Keluaran
video- Format keluaran
- mp4
- Jumlah keluaran
- Hingga 1 keluaran
| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan MiniMax-Hailuo-2.3-Fast | Bawaan— |
Kolomprompt | Jenisstring | PersyaratanWajib | Nilai & batasan Panjang minimum: 1 Panjang maksimum: 199 Satuan: karakter Unicode | Bawaan— |
Kolomduration | Jenisinteger | PersyaratanWajib | Nilai & batasan 6 Satuan: detik | Bawaan— |
Kolomresolution | Jenisstring | PersyaratanWajib | Nilai & batasan 768P | Bawaan— |
Kolomfirst_frame_image | Jenishttps_url | PersyaratanWajib | Nilai & batasan Ukuran berkas maksimum dalam byte: 20.000.000 Jenis MIME: image/png, image/jpeg Dimensi minimum: 300 Dimensi maksimum: 4.096 Hanya persegi: Ya | Bawaan— |
Kombinasi bahan masukan
Gambar ke video · Wajib: prompt, first_frame_image
Parameter metode dan siklus hidup
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, prompt, duration, resolution, first_frame_image |
Parameterother_options | Kontrakfalse |
Parameterduration | Kontrak6 |
Parameterresolution | Kontrak768P |
Parameterprompt_max_characters | Kontrak199 |
Parameterfirst_frame_image | Kontrak{"type":"https_url","format":["png","jpeg"],"dimensions":"persegi 300..4096 piksel","full_image_validation_before_send":true,"maximum_file_bytes":20000000} |
Parametermaterial_types | Kontraktext, image |
Parameteradditional_properties | Kontrakfalse |
Alias metode: /v1/videos/generations, /videos, /videos/generations
Siklus hidup: 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
Buat sekali dan simpan ID yang dikembalikan.
Periksa status awal secara berkala; simpan setiap aset yang selesai beserta durasinya.
Paket
Referensi tarif tidak menambah opsi permintaan. Parameter yang didukung tercantum pada metode yang dipilih.
- Mode Fast
- Tidak ditentukan Saat mode fast dipilih
- Mode Flex
- Tidak ditentukan Saat mode flex dipilih
- Upaya penalaran maksimum
- Tidak ditentukan Saat upaya penalaran maksimum menggunakan penyesuaian default
Tarif Ailoot
Harga menurut konfigurasi
Cocokkan setiap biaya dengan kondisi yang ditampilkan. Gunakan satu tarif untuk setiap kelompok konfigurasi alternatif.
| Konfigurasi | Jadwal tarif | Durasi nominal klip, detik | Resolusi | Satuan penagihan | Biaya |
|---|---|---|---|---|---|
| KonfigurasiTarif dasar token | Jadwal tarifTarif dasar | Durasi nominal klip, detik— | Resolusi— | Satuan penagihan— | Biaya Masukan · Token masukan — / 1K token Keluaran · Token keluaran — / 1K token Masukan · Pembacaan cache — / 1K token Masukan · Penulisan cache — / 1K token Masukan · Penulisan cache, 1 jam — / 1K token |
| KonfigurasiUltra | Jadwal tarif— | Durasi nominal klip, detik6 | Resolusi768P | Satuan penagihanper klip keluaran nominal 6s | Biaya Keluaran · klip keluaran dengan durasi nominal 6s $0.4 per klip keluaran nominal 6s |
Ailoot mencadangkan perkiraan dana sebelum permintaan. Setelah hasil diterima, tagihan akhir diselesaikan berdasarkan penggunaan yang terukur. Penyelesaian tagihan streaming menggunakan catatan penggunaan akhir. Cara kerja cadangan dan penyelesaian tagihan →
Detail tarif referensi
Jadwal referensi tingkat model tidak mengubah pemilihan metode, estimasi harga, atau biaya. Biaya aktif menggunakan tarif metode Ailoot yang dipilih.
MiniMax-Hailuo-2.3-Fast
Harga menurut konfigurasi
| Konfigurasi | Kondisi penagihan | Biaya |
|---|---|---|
| KonfigurasiMiniMax-Hailuo-2.3-Fast · Konfigurasi bawaan | Kondisi penagihanKonfigurasi bawaan | Biaya Masukan · Masukan US$0,00 per pemanggilan Keluaran · Keluaran US$0,40 per pemanggilan |
MiniMax-Hailuo-2.3-Fast
Harga menurut konfigurasi
| Konfigurasi | Kondisi penagihan | Biaya |
|---|---|---|
| KonfigurasiMiniMax-Hailuo-2.3-Fast · Konfigurasi bawaan | Kondisi penagihanKonfigurasi bawaan | Biaya Masukan · Masukan US$0,00 per pemanggilan Keluaran · Keluaran US$0,80 per pemanggilan |
MiniMax-Hailuo-2.3-Fast
Harga menurut konfigurasi
| Konfigurasi | Kondisi penagihan | Biaya |
|---|---|---|
| KonfigurasiMiniMax-Hailuo-2.3-Fast · Konfigurasi bawaan | Kondisi penagihanKonfigurasi bawaan | Biaya Masukan · Masukan US$0,00 per pemanggilan Keluaran · Keluaran US$0,80 per pemanggilan |
Contoh permintaan
Ailoot Ultra · Video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_IMAGE_URL:?Set the actual HTTPS first-frame image URL}"
export AILOOT_IMAGE_URL
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "MiniMax-Hailuo-2.3-Fast", "prompt": "A cat in a spacesuit walking on the Moon", "duration": 6, "resolution": "768P"}')
from urllib.parse import urlsplit
u=os.environ["AILOOT_IMAGE_URL"]
z=urlsplit(u)
if z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Choose the actual HTTPS first-frame image URL")
p["first_frame_image"]=u
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}/contentGET /v1/videos/generations/{request_id}/content
Periksa status tugas
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
Pembacaan konten lain
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
Simpan semua hasil yang selesai
Simpan setiap video yang selesai atau berkas yang dikembalikan; ambil setiap URL aset yang benar-benar dikembalikan.
data[] yang selesai memuat semua URL konten bertanda tangan milik Ailoot. Ambil setiap URL yang dikembalikan, atau gunakan endpoint konten dengan index yang diatur ke indeks keluaran aktual. Tugas awal yang gagal dapat mengembalikan charge_pending_check; periksa tugas awal itu alih-alih membuatnya lagi.
Jika respons asli perlu diperiksa
Baca tugas awal yang sudah ada; jangan pernah kirim ulang pengiriman yang statusnya tidak diketahui.
Keluaran maksimum: 1.
Kolom respons
| Kolom | Jenis | Arti |
|---|---|---|
Kolomid | Jenisstring | Arti— |
Kolomobject | Jenisstring | Arti— |
Kolommodel | Jenisstring | Arti— |
Kolomstatus | Jenisstring | Arti— |
Kolomdata[] | Jenissigned content URL | Arti— |
Kolomcharge_pending_check | Jenisboolean | Arti— |
Kolomerror.code | Jenisstring | Arti— |
Kolomerror.message | Jenisstring | Arti— |
Kolomrequested_nominal_duration_seconds | Jenisinteger | Arti— |
Kolommeasured_duration_seconds | Jenisnumber | Arti— |
Kolomwidth | Jenisinteger | Arti— |
Kolomheight | Jenisinteger | Arti— |
Kolomoperation_id | Jenisstring | ArtiDikembalikan ketika status=unknown; ID operasi video publik awal yang aktual |
Kolomrequest_id | Jenisstring | ArtiOpsional saat status=unknown; hanya dikembalikan jika tugas awal memiliki ID permintaan |
Kesalahan dan langkah berikutnya
| Respons | Kondisi | Langkah berikutnya |
|---|---|---|
Respons400 · invalid_request_error | KondisiPembacaan isi permintaan mentah gagal sebelum penguraian profil video | Langkah berikutnyaSimpan respons yang dikembalikan dan perbaiki isi permintaan yang tidak dapat dibaca. |
Respons422 · price_unavailable | KondisiPenguraian profil video persis gagal, atau profil lengkap yang telah diurai tidak memiliki kartu harga persis yang siap digunakan | Langkah berikutnyaSimpan respons; gunakan profil lengkap dan persis yang diizinkan beserta kartu harga yang dipublikasikan untuknya. Cabang ini dijalankan sebelum pengiriman ke penyedia. |
Respons409 · video_not_ready | KondisiKonten hasil awal belum tersedia | Langkah berikutnyaPeriksa ID awal yang dikembalikan secara berkala dan patuhi Retry-After. |
Responsserver_error | KondisiRespons yang dikembalikan menyatakan bahwa operasi atau hasil perlu diperiksa | Langkah berikutnyaSimpan ID operasi/tugas asli yang dikembalikan, header permintaan, dan respons; lanjutkan pembacaan yang didukung untuk operasi asli tersebut. Jangan kirim ulang permintaan pembuatan. |
Respons200 · video_result_unverified | KondisiStatus tugas Fast awal tidak diketahui; status=unknown dan charge_pending_check=true | Langkah berikutnyaSimpan id/operation_id aktual yang dikembalikan dan request_id opsional; baca hanya tugas awal. Jangan pernah kirim ulang. |
Alias
Alias model
Ailoot Ultra MiniMax-Hailuo-2.3-Fast
Alias jalur metode
/v1/videos/generations, /videos, /videos/generations
ID pemanggil terkait
FAQ · Hailuo 2.3 Fast
- Input dan hasil apa yang tersedia?
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:text,image→video- Kolom apa yang digunakan permintaan?
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:model,prompt,duration,resolution,first_frame_image- Batasan apa yang berlaku?
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:prompt.maximum_length:199