MiniMax-Hailuo-2.3

MiniMax Hailuo 2.3 matn yoki boshlang‘ich rasmdan harakat va kamera yo‘nalishi boshqaruvlari bilan video yaratadi. Tekshirish va tahrirlash mumkin bo‘lgan qahramon ijrolari, uslublashtirilgan sahnalar va mahsulot kadrlari uchun 768P yoki 1080P da olti soniya, yoxud 768P da o‘n soniyani tanlang.

Ailoot · Video yaratish POST /v1/videos/generations MiniMax-Hailuo-2.3
Ailoot Ultra · Video POST /v1/videos MiniMax-Hailuo-2.3

Model haqida

Bu tavsif model imkoniyatlarini yoritadi. Ailoot da tanlangan usul uchun mavjud kirish, chiqish va parametrlar quyida keltirilgan.

MiniMax Hailuo 2.3 — matndan video va rasmdan video rejimlariga ega video yaratish modeli. U Hailuo 02 asosida jismoniy harakat, vizual uslub, qahramon mikroifodalari va harakat ko‘rsatmalariga javobga e’tibor beradi. Kadrni noldan yaratish uchun yozma sahna bering yoki boshlang‘ich ko‘rinishni belgilash uchun rasmdan foydalanib, keyingi harakatni tasvirlang.

Jismoniy ijro ushbu nashrning asosiy yaxshilanish sohalaridan biri. Hailuo 2.3 tana harakatlarini, jumladan harakatlanuvchi kamerali sahnalarda, ravonroq va boshqariladigan qilishni maqsad qiladi. Bezak detallarini qo‘shishdan oldin muhim harakatni rejalang. Buyumni ko‘tarayotgan, boshqa shaxsga burilayotgan yoki xona bo‘ylab yurgan qahramon kadrga baholanadigan ko‘rinadigan voqea beradi. Qaysi harakat hikoyani olib borishini hal qiling, keyin atrof ko‘rsatmalarini unga mos tuting.

Uslublashtirish ham boshqa yo‘nalish. Model anime va illyustratsiya, shuningdek siyohli yuvma rangtasvir va o‘yin CG si kabi uslublarda ishni qo‘llab-quvvatlaydi. Kerakli vizual ishlovni tasvirlang va ko‘rinishni sahnaga yaxlit moslang. Boshlang‘ich rasm chizish uslubini allaqachon belgilasa, qahramon dizaynining raqobatlashuvchi tavsifini kiritmay, matn bilan animatsiyani yo‘naltiring. Harakat davomida shu ishlov ravshan qolishini butun klipda tekshiring.

Model yuz ijrosi va nozik ifoda o‘zgarishlariga ham e’tibor beradi. Qahramon kadrini muhim reaksiya atrofida tayyorlang: buyumni payqash, qiziqish uyg‘onishi yoki kichik tabassum bilan javob berish. Yaqin ko‘rinish shu o‘zgarishni baholashni osonlashtirishi, imo-ishoralarning katta ketma-ketligi esa chalg‘itishi mumkin. Faqat xos bir statik kadrni baholamay, yuzni reaksiyadan oldin, davomida va keyin tekshiring.

Buyum harakati mahsulotga yo‘naltirilgan sahnalarda foydali. Asl topshiriq kamera asta yaqinlashayotganda iliq yon yorug‘likda burilayotgan kichik keramik vazani ko‘rsatishi mumkin. Siluet, og‘iz qirrasi va sirt ishlovi kabi qaysi xususiyatlar tanib bo‘ladigan qolishi kerakligini belgilang. Shu detallarni harakat davomida tekshiring, chunki faqat ishonarli muhit mahsulotning sodiq ko‘rinishini isbotlamaydi.

Matndan video uchun talab qilinadigan tavsif 2,000 tagacha belgidan iborat bo‘lishi mumkin. Obyekt, harakat, joy va vizual uslubni yaxlit tartibda ayting. Rasmdan video boshlang‘ich kadr rasmini talab qiladi, unga 2,000 tagacha belgili ixtiyoriy tavsif qo‘shilishi mumkin. Rasm ochilish kompozitsiyasini mahkamlaydi, shuning uchun harakat so‘rashdan oldin obyekt va kadr tuzilishini tayyorlang. Qo‘l, buyum yoki qahramon harakatlanishi kerak bo‘lgan joyda ko‘rinadigan bo‘shliq qoldiring.

Boshlang‘ich rasm JPG, JPEG, PNG yoki WebP ni qabul qiladi, 20 MB dan kichik, qisqa qirrasi 300 pikseldan katta va tomonlar nisbati 2:5 bilan 5:2 orasida bo‘lishi kerak. U ochiq rasm URL yoki Base64 data URL sifatida berilishi mumkin. Animatsiya to‘silgan yuz yoki allaqachon kesilgan harakatni tuzatishiga tayanmay, aniq boshlang‘ich rasmni tanlang.

Hailuo 2.3 soniyasiga 24 kadrda yaratadi. Olti soniyalik kadr 768P yoki 1080P ishlatishi mumkin; o‘n soniyalik kadr 768P ishlatadi. Standartlar olti soniya va 768P. Uzunlikni ko‘rmoqchi bo‘lgan harakatga tanlang: qisqa reaksiya qisqa kadrga sig‘ishi mumkin, sekinroq harakatga esa ko‘proq joy kerak. Klipni montajga joylaganda tugallangan natijaning haqiqiy eni va bo‘yini o‘qing, chunki aniqlik yorlig‘ining o‘zi to‘liq kadr tuzilishi qarori emas.

Kamera yo‘nalishi kvadrat qavsli buyruqlardan foydalanishi mumkin. Mavjud boshqaruvlar yonlama siljish, pan, yaqinlashish, tik ko‘tarilish/tushish, egilish, zum, silkinish, kuzatish va statik kadrni qamraydi. [Push in] kabi buyruq yaqinlashishni yo‘naltiradi; bitta qavs ichida guruhlangan buyruqlar birga ishlaydi, tartib bilan qo‘yilgan buyruqlar esa ketma-ketlikni tasvirlaydi. MiniMax bir vaqtda ko‘pi bilan uchta buyruqni tavsiya qiladi. Asosiy voqeani oson kuzatish uchun kamera harakatini obyekt harakatiga mos tuting.

Ko‘rsatmani avtomatik optimallashtirish standart holatda yoqilgan; berilgan so‘zlar ustidan yaqinroq nazorat uchun o‘chirilishi mumkin. Ixtiyoriy tez oldindan qayta ishlash optimallashtirish yoqilganda uning vaqtini kamaytiradi; bu Hailuo 2.3 Fast modelini tanlashdan alohida sozlama. Standart Hailuo 2.3 ikkala yaratish rejimini qo‘llab-quvvatlaydi, Fast esa alohida rasmdan video nashri. Nashrni loyiha faqat matndanmi yoki mavjud kadrdanmi boshlanishiga qarab tanlang.

Yaratish jarayoni asinxron vazifa identifikatorini qaytaradi, keyin tayyorlash, navbat, qayta ishlash, muvaffaqiyat yoki xatoni bildiradi. Muvaffaqiyatda natija fayl identifikatori va haqiqiy video o‘lchamlarini beradi, tayyor video esa yuklash uchun olinadi. Yuklash manzili amalda turganda klipni saqlang. Yaratuvchining joriy video yuklash ma’lumotnomasi qaytarilgan yuklash URL iga bir soatlik umr beradi. Tahrirlangan ketma-ketlikda tanlangan ijodiy yo‘nalish tuzatish paytida kuzatilishi uchun har bir kadrni ko‘rsatmasi va boshlang‘ich rasmi bilan saqlang.

Saqlangan klipda harakat, jismoniy izchillik, yuz yoki mahsulot detallari, vizual uslub va kamera xatti-harakatini tekshiring. Butun kadrni ko‘ring, keyin boshqa materialga ulanadigan boshi va oxirini tekshiring. So‘rovda raqobatlashuvchi harakatlar ko‘p bo‘lsa, asosiy harakatni soddalashtiring; boshlang‘ich dizayn noaniq bo‘lsa, boshlang‘ich rasmni yaxshilang. Kerakli voqeani yetkazadigan kadrni tanlang, keyin tahrirlash jarayonida bayon, sarlavhalar va o‘tishlarni qo‘shing.

Ailoot · Video yaratish POST /v1/videos/generations MiniMax-Hailuo-2.3

MiniMax-Hailuo-2.3

MiniMax /MiniMax-Hailuo-2.3

Boshlash

Qabul qilinadigan kirish ma’lumotlari: Matn · Rasmlar
Natijalar: Video

Ailoot da mavjud · kirish ma’lumotlari va usullar

Ailoot · Video yaratish POST /v1/videos/generations

Kirish: text, image
Chiqish: video
Chiqish formati: mp4

Maydon	Tur	Talab	Qiymatlar va cheklovlar	Standart
Maydon`model`	Tur`string`	TalabMajburiy	Qiymatlar va cheklovlar MiniMax-Hailuo-2.3	Standart—
Maydon`prompt`	Tur`string`	TalabMajburiy	Qiymatlar va cheklovlar Eng kam uzunlik: 1 Eng ko‘p uzunlik: 2 000 Birlik: Unicode belgilari	Standart—
Maydon`duration`	Tur`integer`	TalabIxtiyoriy	Qiymatlar va cheklovlar 6, 10 Shartlar: 10 soniya uchun 768P talab etiladi Birlik: soniya	Standart6
Maydon`resolution`	Tur`string`	TalabIxtiyoriy	Qiymatlar va cheklovlar 768P, 1080P Shartlar: 1080P uchun 6 soniya talab qilinadi	Standart768P
Maydon`first_frame_image`	Tur`https_url\|data_image_url`	TalabIxtiyoriy	Qiymatlar va cheklovlar Dekodlangan baytlarning eng ko‘p soni: 20 971 520 MIME turlari: image/jpeg, image/png, image/webp Eng kichik o‘lcham (chegara kirmaydi): 300 Tomonlar nisbati oralig‘i: 2:5, 5:2	Standart—
Maydon`prompt_optimizer`	Tur`boolean`	TalabIxtiyoriy	Qiymatlar va cheklovlar	Standart—
Maydon`fast_pretreatment`	Tur`boolean`	TalabIxtiyoriy	Qiymatlar va cheklovlar	Standart—

Kirish materiallari birikmalari

Rasmdan video · Majburiy: prompt, first_frame_image

Matndan video · Majburiy: prompt

Usul parametrlari va hayot sikli

Parametr	Parametr talablari
Parametr`material_types`	Parametr talablaritext, image
Parametr`required`	Parametr talablarinull
Parametr`optional_controls`	Parametr talablarinull

Hayot sikli: 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

Metod tuzilishlari va IDlari aniq; yetkazib beruvchining imkoniyati so‘rovni qabul qilishga ruxsatdan alohida.

Tariflar

Ailoot usullari tariflari

Ailoot Video yaratishPOST /v1/videos/generations

Chiqish: 0,28 US$ 768p aniqlikdagi 6 s video uchun

Ailoot so‘rovdan oldin taxminiy summani band qiladi. Natijadan keyin o‘lchangan sarf asosidagi yakuniy to‘lovni yechadi. Oqimli javob bo‘yicha yakuniy hisob-kitob yakuniy sarf yozuviga asoslanadi. Summani band qilish va to‘lovni hisoblash tartibi →

Ma’lumot uchun tarif tafsilotlari

Modelning ma’lumot jadvallari usul tanlash, narx hisobi yoki to‘lovlarni o‘zgartirmaydi. Amaldagi to‘lovlar tanlangan Ailoot usuli tariflari bo‘yicha hisoblanadi.

MiniMax-Hailuo-2.3

Sozlamalar bo‘yicha narxlar

Sozlama	To‘lovni hisoblash shartlari	To‘lov
SozlamaMiniMax-Hailuo-2.3 · Standart sozlama	To‘lovni hisoblash shartlariStandart konfiguratsiya	To‘lov Kirish · Kirish 0,00 US$ har chaqiruv uchun Chiqish · Chiqish 0,60 US$ har chaqiruv uchun

MiniMax-Hailuo-2.3

Sozlamalar bo‘yicha narxlar

Sozlama	To‘lovni hisoblash shartlari	To‘lov
SozlamaMiniMax-Hailuo-2.3 · Standart sozlama	To‘lovni hisoblash shartlariStandart konfiguratsiya	To‘lov Kirish · Kirish 0,00 US$ har chaqiruv uchun Chiqish · Chiqish 1,20 US$ har chaqiruv uchun

MiniMax-Hailuo-2.3

Sozlamalar bo‘yicha narxlar

Sozlama	To‘lovni hisoblash shartlari	To‘lov
SozlamaMiniMax-Hailuo-2.3 · Standart konfiguratsiya	To‘lovni hisoblash shartlariStandart konfiguratsiya	To‘lov Kirish · Kirish 0,00 US$ har chaqiruv uchun Chiqish · Chiqish 1,20 US$ har chaqiruv uchun

So‘rov namunalari

Ailoot · Video yaratish

Video namunasi

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

Natijalarni olish va saqlash

Ailoot · Video yaratish

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

Vazifa holatini tekshirish

GET holat

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"

Boshqa kontentni o‘qish

GET kontent

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

Barcha tayyor natijalarni saqlash

Har bir tayyor video yoki qaytarilgan faylni saqlang; har bir haqiqatan qaytarilgan material URL dan kontentni oling.

Qaytarilgan har bir data elementi/chiqish indeksini saqlang. content_url faqat birinchisiga tegishli; har bir haqiqiy mazmun yo‘lini/aktivni oling. index siz GET content barcha chiqishlarni bermaydi.

Asl javobni tekshirish kerak bo‘lsa

Mavjud dastlabki vazifani o‘qing; natijasi noma’lum yuborishni hech qachon takrorlamang.

Javob maydonlari

Maydon	Tur
Maydon`id`	Turstring
Maydon`object`	Turstring
Maydon`model`	Turstring
Maydon`status`	Turstring
Maydon`content_url`	Tursigned URL
Maydon`data[]`	Tursigned URL
Maydon`usage`	Turobject
Maydon`result_pending_check`	Turboolean

Xatolar va keyingi qadamlar

Javob	Shart	Keyingi qadam
Javob400 · `invalid_request_error`	ShartMajburiy maydonlar, material ifodasi yoki parametr qiymati noto‘g‘ri	Keyingi qadamYangi yaratish so‘rovidan oldin ko‘rsatilgan maydonlarni tuzating.
Javob409 · `video_not_ready`	ShartDastlabki natija mazmuni hali mavjud emas	Keyingi qadamDastlab qaytarilgan ID holatini so‘rab tekshiring va Retry-After ga rioya qiling.
Javob`server_error`	ShartQaytarilgan javob operatsiya yoki natijani tekshirish kerakligini bildiradi	Keyingi qadamDastlab qaytarilgan operatsiya/vazifa ID sini, so‘rov sarlavhalarini va javobni saqlang; aynan shu operatsiya uchun qo‘llab-quvvatlanadigan o‘qish so‘rovlarini davom ettiring. Yaratish so‘rovini qayta yubormang.

Taxalluslar

Model taxalluslari

Ailoot MiniMax-Hailuo-2.3
Ailoot Ultra MiniMax-Hailuo-2.3

Usul yo‘llari taxalluslari

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

Chaqirish uchun tegishli ID lar

MiniMax-Hailuo-2.3, MiniMax-Hailuo-2.3

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

MiniMax-Hailuo-2.3

MiniMax /MiniMax-Hailuo-2.3

Boshlash

Qabul qilinadigan kirish ma’lumotlari: Matn
Natijalar: Video

Ailoot da mavjud · kirish ma’lumotlari va usullar

Ailoot Ultra · Video POST /v1/videos

Kirish: text
Chiqish: video
Chiqish formati: mp4
Natijalar soni: Ko‘pi bilan 1 chiqish

Maydon	Tur	Talab	Qiymatlar va cheklovlar	Standart
Maydon`model`	Tur`string`	TalabMajburiy	Qiymatlar va cheklovlar MiniMax-Hailuo-2.3	Standart—
Maydon`prompt`	Tur`string`	TalabMajburiy	Qiymatlar va cheklovlar Eng kam uzunlik: 1 Eng ko‘p uzunlik: 2 000 Shartlar: 768P uchun: ko‘pi bilan 2000 Unicode kod nuqtasi. 1080P uchun: 200 tadan kam Unicode kod nuqtasi (ko‘pi bilan 199). Ko‘rsatmada bo‘shliqdan boshqa matn bo‘lishi kerak. Birlik: Unicode belgilari	Standart—
Maydon`duration`	Tur`integer`	TalabMajburiy	Qiymatlar va cheklovlar 6 Birlik: soniya	Standart—
Maydon`resolution`	Tur`string`	TalabMajburiy	Qiymatlar va cheklovlar 768P, 1080P	Standart—

Kirish materiallari birikmalari

Matndan video · Majburiy: prompt

Usul parametrlari va hayot sikli

Parametr	Parametr talablari
Parametr`content_type`	Parametr talablariapplication/json
Parametr`required`	Parametr talablarimodel, prompt, duration, resolution
Parametr`other_options`	Parametr talablarifalse
Parametr`duration`	Parametr talablari6
Parametr`resolution`	Parametr talablari768P, 1080P
Parametr`prompt_max_characters`	Parametr talablari2000
Parametr`material_types`	Parametr talablaritext
Parametr`prompt_max_characters_by_resolution`	Parametr talablari{"768P":2000,"1080P":199}

Usul taxalluslari: /v1/videos/generations, /videos, /videos/generations

Hayot sikli: 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

Bir marta yarating va qaytarilgan ID ni saqlang.

Dastlabki holatni so‘rab tekshiring; har bir yakunlangan aktivni va davomiylikni saqlang.

Tariflar

Tarif ma’lumotlari so‘rov imkoniyatlarini qo‘shmaydi. Qo‘llab-quvvatlanadigan parametrlar tanlangan usulda ko‘rsatilgan.

Tezkor rejim: Ko‘rsatilmagan Tezkor rejim tanlanganda
Flex rejimi: Ko‘rsatilmagan flex rejimi tanlanganda
Maksimal fikrlash darajasi: Ko‘rsatilmagan Maksimal fikrlash darajasi uchun standart (default) tuzatish qo‘llanganda

Ailoot tariflari

Sozlamalar bo‘yicha narxlar

Har bir to‘lovni ko‘rsatilgan shartlarga moslang. Har bir muqobil sozlamalar to‘plami uchun bitta tarifdan foydalaning.

Sozlama	Tariflar jadvali	Klipning nominal davomiyligi, soniya	Aniqlik	Hisob birligi	To‘lov
SozlamaTokenlar uchun bazaviy tariflar	Tariflar jadvaliAsosiy tarif	Klipning nominal davomiyligi, soniya—	Aniqlik—	Hisob birligi—	To‘lov Kirish · Kirish tokenlari — / 1K token Chiqish · Chiqish tokenlari — / 1K token Kirish · Keshdan o‘qish — / 1K token Kirish · Keshga yozish — / 1K token Kirish · Keshga yozish, 1 soat — / 1K token
SozlamaUltra	Tariflar jadvali—	Klipning nominal davomiyligi, soniya6	Aniqlik1080P	Hisob birliginominal davomiyligi 6s bo‘lgan chiqish klipi uchun	To‘lov Chiqish · Nominal 6s chiqish klipi $1.2 nominal davomiyligi 6s bo‘lgan chiqish klipi uchun
SozlamaUltra	Tariflar jadvali—	Klipning nominal davomiyligi, soniya6	Aniqlik768P	Hisob birliginominal davomiyligi 6s bo‘lgan chiqish klipi uchun	To‘lov Chiqish · Nominal 6s chiqish klipi $0.6 nominal davomiyligi 6s bo‘lgan chiqish klipi uchun

Ma’lumot uchun tarif tafsilotlari

Modelning ma’lumot jadvallari usul tanlash, narx hisobi yoki to‘lovlarni o‘zgartirmaydi. Amaldagi to‘lovlar tanlangan Ailoot usuli tariflari bo‘yicha hisoblanadi.

MiniMax-Hailuo-2.3

Sozlamalar bo‘yicha narxlar

Sozlama	To‘lovni hisoblash shartlari	To‘lov
SozlamaMiniMax-Hailuo-2.3 · Standart sozlama	To‘lovni hisoblash shartlariStandart konfiguratsiya	To‘lov Kirish · Kirish 0,00 US$ har chaqiruv uchun Chiqish · Chiqish 0,60 US$ har chaqiruv uchun

MiniMax-Hailuo-2.3

Sozlamalar bo‘yicha narxlar

Sozlama	To‘lovni hisoblash shartlari	To‘lov
SozlamaMiniMax-Hailuo-2.3 · Standart sozlama	To‘lovni hisoblash shartlariStandart konfiguratsiya	To‘lov Kirish · Kirish 0,00 US$ har chaqiruv uchun Chiqish · Chiqish 1,20 US$ har chaqiruv uchun

MiniMax-Hailuo-2.3

Sozlamalar bo‘yicha narxlar

Sozlama	To‘lovni hisoblash shartlari	To‘lov
SozlamaMiniMax-Hailuo-2.3 · Standart konfiguratsiya	To‘lovni hisoblash shartlariStandart konfiguratsiya	To‘lov Kirish · Kirish 0,00 US$ har chaqiruv uchun Chiqish · Chiqish 1,20 US$ har chaqiruv uchun

So‘rov namunalari

Ailoot Ultra · Video

curlcurl · 1080P / 6 soniya

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

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

Natijalarni olish va saqlash

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

Vazifa holatini tekshirish

GET holat

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

Barcha tayyor materiallarni saqlash

GET barcha tayyor materiallar

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

Boshqa kontentni o‘qish

GET kontent

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

Barcha tayyor natijalarni saqlash

Har bir tayyor video yoki qaytarilgan faylni saqlang; har bir haqiqatan qaytarilgan material URL dan kontentni oling.

Yakunlangan data[] egalik qilinadigan barcha imzolangan mazmun URL larini saqlaydi. Qaytarilgan har bir URL ni oling yoki content endpointida index ni haqiqiy chiqish indeksiga teng qilib belgilang. Dastlabki vazifa muvaffaqiyatsiz bo‘lsa, charge_pending_check qaytishi mumkin; qayta yaratish o‘rniga shu dastlabki vazifani tekshiring.

Asl javobni tekshirish kerak bo‘lsa

Mavjud dastlabki vazifani o‘qing; natijasi noma’lum yuborishni hech qachon takrorlamang.

Natijalarning eng ko‘p soni: 1.

Javob maydonlari

Maydon	Tur
Maydon`id`	Turstring
Maydon`object`	Turstring
Maydon`model`	Turstring
Maydon`status`	Turstring
Maydon`data[]`	Tursigned content URL
Maydon`charge_pending_check`	Turboolean
Maydon`error.code`	Turstring
Maydon`error.message`	Turstring
Maydon`requested_nominal_duration_seconds`	Turinteger
Maydon`measured_duration_seconds`	Turnumber
Maydon`width`	Turinteger
Maydon`height`	Turinteger

Xatolar va keyingi qadamlar

Javob	Shart	Keyingi qadam
Javob400 · `invalid_request_error`	ShartMajburiy maydonlar, material ifodasi yoki parametr qiymati noto‘g‘ri	Keyingi qadamYangi yaratish so‘rovidan oldin ko‘rsatilgan maydonlarni tuzating.
Javob409 · `video_not_ready`	ShartDastlabki natija mazmuni hali mavjud emas	Keyingi qadamDastlab qaytarilgan ID holatini so‘rab tekshiring va Retry-After ga rioya qiling.
Javob`server_error`	ShartQaytarilgan javob operatsiya yoki natijani tekshirish kerakligini bildiradi	Keyingi qadamDastlab qaytarilgan operatsiya/vazifa ID sini, so‘rov sarlavhalarini va javobni saqlang; aynan shu operatsiya uchun qo‘llab-quvvatlanadigan o‘qish so‘rovlarini davom ettiring. Yaratish so‘rovini qayta yubormang.

Taxalluslar

Model taxalluslari

Ailoot MiniMax-Hailuo-2.3
Ailoot Ultra MiniMax-Hailuo-2.3

Usul yo‘llari taxalluslari

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

Chaqirish uchun tegishli ID lar

MiniMax-Hailuo-2.3, MiniMax-Hailuo-2.3

FAQ · MiniMax-Hailuo-2.3

Qanday kirish ma’lumotlari va natijalar mavjud?

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

POST /v1/videos · MiniMax-Hailuo-2.3: text → video

So‘rov qaysi maydonlardan foydalanadi?

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

Qanday cheklovlar amal qiladi?

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

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

MiniMax-Hailuo-2.3