Hailuo 2.3 Fast
MiniMax Hailuo 2.3 Fast menganimasikan imej bingkai pertama daripada prompt gerakan ringkas. Pilih profil imej-ke-video ini untuk syot produk, pose watak atau imej pegun papan cerita.
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 Fast ialah profil Fast bernama untuk penjanaan imej-ke-video. Mulakan dengan imej bingkai pertama yang telah dikomposisikan dan terangkan cara subjek atau kamera patut bergerak. Imej pegun produk, pose watak atau bingkai papan cerita memberikan syot titik permulaan visual yang konkrit.
Sediakan imej dan taklimat gerakan
Sediakan imej PNG atau JPEG segi empat sama melalui URL HTTPS, dengan setiap sisi antara 300 dengan 4,096 piksel. Fail imej yang dimuat turun tidak boleh melebihi 20,000,000 bait. Pastikan prompt antara 1 dengan 199 aksara, tertumpu pada satu tindakan yang kelihatan dan pergerakan yang penting kepada syot.
Ikuti klip hingga selesai
Profil ini dikonfigurasikan untuk satu klip MP4 768 × 768 dengan tempoh nominal enam saat. Hantar permintaan sekali, simpan ID yang dipulangkan dan ikuti permintaan asal itu sehingga selesai. Muat turun video yang dipulangkan dan simpan dimensi yang dilaporkan serta tempoh yang diukur bersama hasil. Jika hasil penciptaan tidak pasti, teruskan memeriksa permintaan asal, bukannya menciptanya semula.
Ailoot Ultra · Video POST /v1/videos MiniMax-Hailuo-2.3-Fast
MiniMax-Hailuo-2.3-FastPengenalan
MiniMax Hailuo 2.3 Fast menganimasikan imej bingkai pertama daripada prompt gerakan ringkas. Pilih profil imej-ke-video ini untuk syot produk, pose watak atau imej pegun papan cerita.
- Input yang diterima
- Teks · Imej
- Hasil
- Video
Tersedia di Ailoot · input & kaedah
Ailoot Ultra · Video POST /v1/videos
- Input
text,image- Output
video- Format output
- mp4
- Bilangan output
- Sehingga 1 output
| Medan | Jenis | Keperluan | Nilai & had | Lalai |
|---|---|---|---|---|
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had MiniMax-Hailuo-2.3-Fast | Lalai— |
Medanprompt | Jenisstring | KeperluanDiperlukan | Nilai & had Panjang minimum: 1 Panjang maksimum: 199 Unit: aksara Unicode | Lalai— |
Medanduration | Jenisinteger | KeperluanDiperlukan | Nilai & had 6 Unit: saat | Lalai— |
Medanresolution | Jenisstring | KeperluanDiperlukan | Nilai & had 768P | Lalai— |
Medanfirst_frame_image | Jenishttps_url | KeperluanDiperlukan | Nilai & had Saiz fail maksimum dalam bait: 20,000,000 Jenis MIME: image/png, image/jpeg Dimensi minimum: 300 Dimensi maksimum: 4,096 Segi empat sama sahaja: Ya | Lalai— |
Gabungan bahan input
Imej kepada video · Diperlukan: prompt, first_frame_image
Parameter kaedah dan kitar hayat
| 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":"segi empat sama 300..4096 piksel","full_image_validation_before_send":true,"maximum_file_bytes":20000000} |
Parametermaterial_types | Kontraktext, image |
Parameteradditional_properties | Kontrakfalse |
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 | Resolusi768P | Unit pengebilanbagi setiap klip keluaran nominal 6s | Caj Output · klip keluaran dengan tempoh nominal 6s $0.4 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 →
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-Fast
Harga mengikut konfigurasi
| Konfigurasi | Syarat pengebilan | Caj |
|---|---|---|
| KonfigurasiMiniMax-Hailuo-2.3-Fast · Konfigurasi lalai | Syarat pengebilanKonfigurasi lalai | Caj Input · Input USD 0.00 bagi setiap panggilan Output · Output USD 0.40 bagi setiap panggilan |
MiniMax-Hailuo-2.3-Fast
Harga mengikut konfigurasi
| Konfigurasi | Syarat pengebilan | Caj |
|---|---|---|
| KonfigurasiMiniMax-Hailuo-2.3-Fast · Konfigurasi lalai | Syarat pengebilanKonfigurasi lalai | Caj Input · Input USD 0.00 bagi setiap panggilan Output · Output USD 0.80 bagi setiap panggilan |
MiniMax-Hailuo-2.3-Fast
Harga mengikut konfigurasi
| Konfigurasi | Syarat pengebilan | Caj |
|---|---|---|
| KonfigurasiMiniMax-Hailuo-2.3-Fast · Konfigurasi lalai | Syarat pengebilanKonfigurasi lalai | Caj Input · Input USD 0.00 bagi setiap panggilan Output · Output USD 0.80 bagi setiap panggilan |
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
Semak 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 kandungan 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 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 | Maksud |
|---|---|---|
Medanid | Jenisstring | Maksud— |
Medanobject | Jenisstring | Maksud— |
Medanmodel | Jenisstring | Maksud— |
Medanstatus | Jenisstring | Maksud— |
Medandata[] | Jenissigned content URL | Maksud— |
Medancharge_pending_check | Jenisboolean | Maksud— |
Medanerror.code | Jenisstring | Maksud— |
Medanerror.message | Jenisstring | Maksud— |
Medanrequested_nominal_duration_seconds | Jenisinteger | Maksud— |
Medanmeasured_duration_seconds | Jenisnumber | Maksud— |
Medanwidth | Jenisinteger | Maksud— |
Medanheight | Jenisinteger | Maksud— |
Medanoperation_id | Jenisstring | MaksudDikembalikan apabila status=unknown; ID operasi video awam asal yang sebenar |
Medanrequest_id | Jenisstring | MaksudPilihan apabila status=unknown; dikembalikan hanya jika tugas asal mempunyai ID permintaan |
Ralat dan langkah seterusnya
| Respons | Syarat | Langkah seterusnya |
|---|---|---|
Respons400 · invalid_request_error | SyaratPembacaan badan permintaan mentah gagal sebelum profil video dihuraikan | Langkah seterusnyaSimpan respons yang dikembalikan dan betulkan badan permintaan yang tidak dapat dibaca. |
Respons422 · price_unavailable | SyaratProfil video tepat gagal dihuraikan, atau profil penuh yang telah dihuraikan tidak mempunyai kad harga tepat yang sedia digunakan | Langkah seterusnyaSimpan respons; gunakan profil lengkap dan tepat yang dibenarkan berserta kadnya yang diterbitkan. Cabang ini berjalan sebelum penghantaran kepada pembekal. |
Respons409 · video_not_ready | SyaratKandungan hasil asal belum tersedia | Langkah seterusnyaSemak ID asal yang dikembalikan secara berkala dan patuhi Retry-After. |
Responsserver_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. |
Respons200 · video_result_unverified | SyaratKeadaan tugas Fast asal tidak diketahui; status=unknown dan charge_pending_check=true | Langkah seterusnyaSimpan id/operation_id sebenar yang dikembalikan dan request_id pilihan; baca tugas asal sahaja. Jangan sekali-kali hantar semula. |
Alias
Alias model
Ailoot Ultra MiniMax-Hailuo-2.3-Fast
Alias laluan kaedah
/v1/videos/generations, /videos, /videos/generations
ID pemanggil berkaitan
FAQ · Hailuo 2.3 Fast
- Apakah input dan hasil yang tersedia?
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:text,image→video- Apakah medan yang digunakan oleh permintaan?
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:model,prompt,duration,resolution,first_frame_image- Apakah had yang terpakai?
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:prompt.maximum_length:199