MiniMax: H3
MiniMax H3 iš teksto, kadrų vaizdų arba multimodalinių orientyrų generuoja trumpus vaizdo įrašus su kartu kuriamu stereogarsu. Jis palaiko kūrimą pagal pirmąjį ir paskutinį kadrus, orientyrais valdomą redagavimą bei judesio ar balso ryšius, 4–15 sekundžių rezultatus ir atskirą pakartotinio generavimo 2K raiška eigą.
Apie modelį
Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.
Vienas garso ir vaizdo rezultatas iš multimodalinės užduoties
MiniMax H3 yra MiniMax visų modalumų vaizdo sistema. Ji kartu interpretuoja tekstą, vaizdus, vaizdo įrašus ir garsą, tada generuoja vaizdo įrašą su kartu kuriamu stereogarsu. Gamintojas ją pristato trumpiems kūrybiniams darbams, pavyzdžiui, produktų vaizdams, reklamai, animuotiems plakatams ir filmų titrų koncepcijoms, kur orientyrinių failų ryšiai svarbūs tiek pat, kiek scenos aprašymas.
Dokumentuota sistema kuria 4–15 sekundžių vaizdo įrašus, 24 kadrų per sekundę, su 32 kHz stereogarsu. Jos H3-Base generavimas veikia 768p raiška; visa 2K eiga pakartotinai generuoja tą rezultatą naudodama originalų multimodalinį kontekstą. Tai daugiau nei įprastas dydžio pakeitimas: antras etapas vėl naudoja modelį ir pradinį kontekstą smulkioms detalėms atkurti. H3 Max ir H3-Context-IR turi atskirus vaidmenis bei ribas.
Kūrimas iš teksto ir pagal kadrus
Vien tekstinė įvestis aprašo visą garso ir vaizdo laiko juostą. Pirmas vaizdas įtvirtina pradžią, paskutinis – pabaigą, o du vaizdai gali nustatyti abi. Planui pagal pirmąjį kadrą pradėkite nuo nuotraukoje matomos kompozicijos ir tapatumo, tada aprašykite iš jų besivystantį veiksmą. Perėjimui nuo pirmojo iki paskutinio kadro aprašykite stebimą judesį, jungiantį dvi būsenas, užuot kartoję du nesusijusius vaizdų aprašymus.
Praktiška produkto užduotis gali nurodyti uždarytą pakuotę pirmame kadre, ją atveriančią ranką, švelnų kameros judėjimą ir siekiamą galutinę būseną. Pateiktuose kadruose išlaikykite daikto formą, etiketės vietą bei apšvietimą. Kūrimas pagal kadrus ir pagal orientyrus yra atskiri įvesties režimai; gamintojo sąsaja nejungia pirmojo ir paskutinio kadrų vaidmenų su orientyrinės medijos vaidmenimis vienoje užklausoje.
Orientyrais valdomas generavimas ir redagavimas
Orientyrų režimas priima tekstą su vaizdais, vaizdo klipais ir garso klipais. Įvardykite, ką kiekvienas šaltinis suteikia: personažo išvaizdą, vietą, kameros judėjimą, pradinio klipo laikinę struktūrą arba balsą. Vaizdo įrašas, naudojamas tik kameros judesiui, skiriasi nuo vaizdo įrašo, kurį iš tikrųjų reikia redaguoti ar pratęsti. Šį ryšį nurodykite aiškiai.
Gamintojo orientyrų vadovas atskiria objektų apibrėžimus, užduoties santrauką, išsaugojimo analizę, išsamų plano aprašymą, bendrą garsinę aplinką ir tik žiūrovui skirtą foninę muziką. Jis skiria matomo turinio išsaugojimą nuo savybių perkėlimo arba plataus stiliaus orientyro. Garso signalo kopijavimas skiriasi nuo rėmimosi tembru, ritmu ar atlikimu. Šiuos vaidmenis išlaikykite pastovius visoje užduotyje.
Orientyrais valdomai scenai pateikite personažo vaizdą, trumpą kameros judesio orientyrą ir garso balso orientyrą, tada aprašykite, kur kiekvienas turi veikti tikslinį planą. Nurodykite, kurios aprangos, aplinkos arba daikto detalės turi likti atpažįstamos. Užbaigtą klipą lyginkite su tais reikalavimais, įskaitant judesio vientisumą ir matomo kalbėtojo ryšį su girdimu balsu.
Kalba, garsas ir plano laikas
H3 kartu modeliuoja dialogą, fizinius garsus, aplinką ir muziką. Modelio kortelė dokumentuoja stabilų dialogo palaikymą arabų, kinų, anglų, prancūzų, vokiečių, italų, japonų, korėjiečių, portugalų, rusų ir ispanų kalbomis; kitų kalbų palaikymas aprašomas kaip nevienodas. Pateikite tikslius sakomus žodžius ir kalbą, išlaikydami pastovų kalbėtojo tapatumą per planus.
Gamintojo užklausų rašymo vadovai aprašomosioms dalims naudoja anglų kalbą, o dialogą ir matomą tekstą išlaiko originalia kalba. Sakytinis turinys naudoja <d>[Language] ...</d>, o kalbėtojo tapatumas ir balso aprašymas lieka už bloko. Scenoje sakomą kalbą atskirkite nuo užkadrinio įgarsinimo ir nurodykite, kada replika tęsiasi per montažo pjūvį arba nutrūksta klipo pabaigoje. Matomą tekstą taip pat išlaikykite tiksliai. Kalbos kiekį derinkite prie pasirinktos trukmės ir kartu tikrinkite atvaizduotus žodžius bei girdimą repliką.
Kameros judėjimą aprašykite kaip veiksmą, įtraukdami jo diapazoną ir greitį, kai jie svarbūs. Planus numeruokite atkūrimo tvarka, o pjūvių laikus išlaikykite vaizdo trukmės ribose. Scenos garsus, pavyzdžiui, žingsnius ar užsidarančias duris, atskirkite nuo tik žiūrovui girdimos foninės muzikos. Šie pasirinkimai palengvina trumpo plano interpretavimą ir peržiūrą pagal rezultatą.
Įvesties paruošimas ir skaitinės ribos
Dabartinė generavimo schema visuose režimuose reikalauja netuščio teksto, iki 7 000 simbolių kiekvienam teksto elementui. Vaizdai gali būti JPG, JPEG, PNG, WebP, HEIC arba HEIF, kiekvienas iki 30 MB, kiekviena kraštinė nuo 256 iki 5 760 pikselių, kraštinių santykis nuo 0.4 iki 2.5. Kadrų įvestis leidžia po vieną pirmąjį ir paskutinį vaizdą; orientyrų režimas leidžia iki devynių orientyrinių vaizdų.
Orientyrinį vaizdo įrašą gali sudaryti iki trijų MP4 arba MOV klipų, kiekvienas 2–15 sekundžių, kartu ne daugiau kaip 15 sekundžių. Klipas gali būti iki 50 MB; jo vaizdo kodekas yra H.264 arba H.265, su AAC arba MP3 garsu, kraštinėmis nuo 256 iki 5 760 pikselių, santykiais nuo 0.4 iki 2.5 ir kadrų dažniu nuo 23.976 iki 60. Orientyrinis garsas palaiko iki trijų WAV arba MP3 klipų, kiekvieną iki 15 MB, kiekvieną 2–15 sekundžių ir kartu ne daugiau kaip 15 sekundžių. Modelio kortelė mišrias orientyrines įvestis apriboja 12 failų. Dokumentuota užklausos turinio riba yra 64 MB ir skiriasi nuo atskirų failų ribų.
Rinkitės tik prie užduoties prisidedančius orientyrus ir kiekvieną indėlį nurodykite aiškiai. Vienas aiškus objekto vaizdas naudingesnis už kelis prieštaringus be paaiškinimo. Išlaikykite orientyrų tvarką, apkirpkite nereikalingą medžiagą nepašalindami būtino scenos konteksto ir patikrinkite, kad trumpuose pradiniuose klipuose būtų prašomas veiksmas arba balso savybė.
Rezultato forma ir visa sistema
Gamintojo H3 sąsaja siūlo 768P ir 2K. Generavimas tik iš teksto reikalauja konkretaus santykio: 21:9, 16:9, 4:3, 1:1, 3:4 arba 9:16. Kūrimas pagal pirmąjį ir paskutinį kadrus kraštinių santykį gauna iš pradinio vaizdo; kūrimas pagal orientyrus gali naudoti prisitaikantį arba aiškiai nurodytą santykį. Išvesties trukmė nurodoma sveikomis sekundėmis ir yra 4–15 sekundžių.
Modelio kortelė skiria H3-Context-IR, kuris interpretuoja ir praturtina užduotį, H3-Base, kuris generuoja garso bei vaizdo turinį, ir H3-Regenerate-2K, kuris kuria aukštesnės raiškos rezultatą. Išleisti baziniai kontroliniai taškai atskiria kadrų valdomas ir visų orientyrų užduotis. Konteksto ir pakartotinio generavimo komponentai skiriasi nuo tų bazinių svorių, todėl vien atviro kontrolinio taško pavadinimas nepatvirtina visos sistemos elgsenos.
Gamintojo generavimo eiga asinchroninė. Užduočių užklausos sąsaja gauna ankstesnių septynių dienų užduotis. Užduoties identifikatorių laikykite iki tikro vaizdo rezultato grąžinimo, tada išsaugokite klipą, užuot pasilikę vien riboto galiojimo atsisiuntimo adresą. Numatytu žiūrėjimo dydžiu peržiūrėkite vaizdinį tapatumą, smulkų tekstą, objektų sąveikas, sakytinį turinį ir garso laiką. Gamintojas multimodalinį supratimą bei smulkias vaizdines detales įvardija kaip toliau tobulinamas sritis; išsami užduotis ir palyginimas su šaltiniu išlieka naudingo rezultato pagrindu.
Ailoot Ultra · Vaizdo įrašai POST /v1/videos minimax/hailuo-3
minimax/hailuo-3Pradžia
MiniMax H3 iš teksto, kadrų vaizdų arba multimodalinių orientyrų generuoja trumpus vaizdo įrašus su kartu kuriamu stereogarsu. Jis palaiko kūrimą pagal pirmąjį ir paskutinį kadrus, orientyrais valdomą redagavimą bei judesio ar balso ryšius, 4–15 sekundžių rezultatus ir atskirą pakartotinio generavimo 2K raiška eigą.
- Leidžiamos įvestys
- Tekstas · Vaizdai · Garsas · Vaizdo įrašai
- Rezultatai
- Vaizdo įrašai
Prieinama Ailoot · įvestys ir metodai
Ailoot Ultra · Vaizdo įrašai POST /v1/videos
- Įvestis
text,image,audio,video- Išvestis
video- Išvesties formatas
- originalūs MP4 baitai; be normalizavimo ar perkodavimo
| Laukas | Tipas | Reikalavimas | Reikšmės ir ribos | Numatyta |
|---|---|---|---|---|
Laukasmodel | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos minimax/hailuo-3 | Numatyta— |
Laukasprompt | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos | Numatyta— |
Laukasduration | Tipasinteger | ReikalavimasPrivaloma | Reikšmės ir ribos 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Mažiausia reikšmė: 1 Didžiausia reikšmė: 600 | Numatyta— |
Laukasresolution | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos 2K | Numatyta— |
Laukasaspect_ratio | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Numatyta— |
Laukasgenerate_audio | Tipasboolean | ReikalavimasNeprivaloma | Reikšmės ir ribos false, true | Numatyta— |
Laukasframe_images | Tipasarray | ReikalavimasNeprivaloma | Reikšmės ir ribos Mažiausias elementų skaičius: 1 Didžiausias elementų skaičius: 2 Įvesties turinys: Kadrų objektų masyvas. Kiekviename objekte yra type=image_url, image_url su url ir frame_type. Naudokite HTTPS paveikslėlio URL ir nustatykite frame_type reikšmę first_frame arba last_frame. Kiekviena kadro paskirtis nurodoma daugiausia vieną kartą. Tikslūs raktai: type, image_url, frame_type Sąlygos: Šie raktai apibūdina kiekvieną kadro objektą; image_url turi tik url. Jei užklausoje yra tik tekstas, praleiskite frame_images. | Numatyta— |
Laukasinput_references | Tipasarray | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
Laukascallback_url | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos Šablonas: ^https:// | Numatyta— |
Laukassession_id | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
Laukastrace | Tipasobject | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
Laukasuser | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
Įvesties medžiagos deriniai
Iš teksto į vaizdo įrašą · Tekstinė užklausa. · Privaloma: model, prompt, duration
Pateikite prompt kaip tekstą ir duration sveikomis sekundėmis. Pasirinkite palaikomą skiriamąją gebą ir, jei reikia, kraštinių santykį.
model: Tipas: string · minimax/hailuo-3
prompt: Tipas: string · Didžiausias UTF-8 baitų skaičius: 10 000 · Būtinas bent vienas simbolis, nepriskiriamas tarpų simboliams: Taip
Iš vaizdo į vaizdo įrašą · Tekstinė užklausa ir pirmojo kadro paveikslėlis. · Privaloma: model, prompt, duration, frame_images
frame_images yra masyvas. Kiekviename kadro objekte yra type, image_url ir frame_type; image_url turi url lauką. Nustatykite type reikšmę image_url. Naudokite first_frame ir neprivalomą last_frame. Kiekviena kadro paskirtis nurodoma daugiausia vieną kartą. Kiekvienam kadrui pateikite viešą HTTPS paveikslėlio URL. Vienoje užklausoje naudokite arba kadrų paveikslėlius, arba pavyzdinius paveikslėlius; nederinkite abiejų. Pasirinkite palaikomą skiriamąją gebą ir, jei reikia, kraštinių santykį.
Tikslūs raktai: type, image_url, frame_type
model: Tipas: string · minimax/hailuo-3
prompt: Tipas: string · Didžiausias UTF-8 baitų skaičius: 10 000 · Būtinas bent vienas simbolis, nepriskiriamas tarpų simboliams: Taip
Reference to video · Tekstinė užklausa ir palaikoma pavyzdinė medžiaga: paveikslėliai, vaizdo įrašai, garsas. · Privaloma: model, prompt, duration, input_references
input_references yra objektų masyvas. Nustatykite type reikšmę image_url, video_url, audio_url ir naudokite atitinkamą lauką su url. Naudokite viešus HTTPS URL. Kad pasirinktumėte pavyzdinės medžiagos režimą, praleiskite frame_images. Į sąmatą rodomas mokestis už paveikslėlį įtraukiamas tik pavyzdiniams paveikslėliams po pirmųjų penkių. Galutinis mokestis nustatomas pagal tikrąją apmokestintą konfigūraciją. Nederinkite pavyzdinių paveikslėlių su kadrų paveikslėliais. Pasirinkite palaikomą skiriamąją gebą ir, jei reikia, kraštinių santykį.
model: Tipas: string · minimax/hailuo-3
prompt: Tipas: string · Didžiausias UTF-8 baitų skaičius: 10 000 · Būtinas bent vienas simbolis, nepriskiriamas tarpų simboliams: Taip
Metodo parametrai ir gyvavimo ciklas
| Parametras | Specifikacija |
|---|---|
Parametrascontent_type | Specifikacijaapplication/json |
Parametrasrequired | Specifikacijamodel, prompt, duration |
Parametrasmaterial_types | Specifikacijatext, image, audio, video |
Parametrasadditional_properties | Specifikacijafalse |
Parametrasoptional_controls | Specifikacijaresolution, aspect_ratio, generate_audio, frame_images, input_references, callback_url, session_id, trace, user |
Gyvavimo ciklas: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
Planai
Kaip apskaičiuojamas galutinis mokestis
Rodomi įkainiai leidžia įvertinti kainą prieš generavimą. Galutinė suma apskaičiuojama pagal užfiksuotą pradinio generavimo kainą. Išmatuota rezultato trukmė ir prognozuoti kiekiai nėra galutinis apmokestinamas kiekis.
Tarifų informacija neprideda užklausos parinkčių. Palaikomi parametrai nurodyti prie pasirinkto metodo.
- Spartusis režimas
- Nenurodyta Pasirinkus spartųjį režimą
- Flex režimas
- Nenurodyta Pasirinkus flex režimą
- Didžiausios samprotavimo pastangos
- Nenurodyta Kai didžiausioms samprotavimo pastangoms taikomas numatytasis koregavimas (default)
Numatomi įkainiai palyginimui
Kainos pagal konfigūraciją
Kiekvieną mokestį susiekite su nurodytomis sąlygomis. Kiekvienam alternatyvių konfigūracijų rinkiniui taikykite vieną įkainį.
| Konfigūracija | Įkainių lentelė | Numatomas kiekis | Apskaitos vienetas | Apmokestinimo sąlygos | Mokestis |
|---|---|---|---|---|---|
| KonfigūracijaBaziniai žetonų įkainiai | Įkainių lentelėBazinis įkainis | Numatomas kiekis— | Apskaitos vienetas— | Apmokestinimo sąlygos— | Mokestis Įvestis · Įvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Išvestis · Išvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Įvestis · Talpyklos skaitymas · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą, 1 val · Įvertis tik palyginimui — / 1K tokenų |
| KonfigūracijaVaizdo įrašo kaina | Įkainių lentelė— | Numatomas kiekis— | Apskaitos vienetasuž vaizdo įrašo sekundę | Apmokestinimo sąlygosŠiame kainodaros rakte papildoma sąlyga nenurodyta. | Mokestis Išvestis · Vaizdo įrašo kaina · Įvertis tik palyginimui $0.26 už vaizdo įrašo sekundę |
| Konfigūracijareferencinis vaizdas | Įkainių lentelė— | Numatomas kiekis— | Apskaitos vienetasuž pavyzdinį vaizdą | Apmokestinimo sąlygos— | Mokestis Įvestis · referencinis vaizdas · Įvertis tik palyginimui $0.08 už pavyzdinį vaizdą |
| KonfigūracijaNumatoma generavimo kaina | Įkainių lentelė— | Numatomas kiekisvieno generavimo įvertis | Apskaitos vienetas— | Apmokestinimo sąlygos— | Mokestis Išvestis · Numatoma generavimo kaina · Įvertis tik palyginimui $1.3 įvertis prieš generavimą Šis įvertis nėra papildomas mokestis ar fiksuotas užbaigto generavimo įkainis. |
Ailoot prieš užklausą rezervuoja numatomą sumą. Gavus rezultatą, galutinis mokestis nuskaitomas pagal išmatuotą naudojimą. Srautinio atsakymo atsiskaitymui naudojamas galutinis naudojimo įrašas. Kaip veikia rezervavimas ir atsiskaitymas →
Informacinio tarifo duomenys
Modelio informacinės lentelės nekeičia metodo pasirinkimo, kainos įverčių ar mokesčių. Galiojantys mokesčiai nustatomi pagal pasirinkto Ailoot metodo įkainius.
Vaizdo įrašo konfigūracijų kainų nuorodos
Kainos pagal konfigūraciją
Kiekvieną mokestį susiekite su nurodytomis sąlygomis. Kiekvienam alternatyvių konfigūracijų rinkiniui taikykite vieną įkainį.
| Konfigūracija | Apmokestinimo sąlygos | Mokestis |
|---|---|---|
| KonfigūracijaVaizdo įrašo kaina | Apmokestinimo sąlygosŠiame kainodaros rakte papildoma sąlyga nenurodyta. | Mokestis Išvestis · Vaizdo įrašo kaina $0.26 už vaizdo įrašo sekundę Paskelbta orientacinė rodomos konfigūracijos kaina. Galutiniai mokesčiai nustatomi pagal faktiškai apmokestintą konfigūraciją. |
| KonfigūracijaPavyzdiniai paveikslėliai po pirmųjų penkių | Apmokestinimo sąlygosŠiame kainodaros rakte papildoma sąlyga nenurodyta. | Mokestis Įvestis · Referenciniai vaizdai po pirmųjų penkių $0.08 už vaizdą Pirmieji penki pavyzdiniai paveikslėliai nemokami; nurodytas tarifas už paveikslėlį taikomas po pirmųjų penkių. Paskelbtos kainos nuoroda rodoma pasirinktai konfigūracijai. Galutiniai mokesčiai nustatomi pagal tikrąją apmokestintą konfigūraciją. |
Užklausų pavyzdžiai
Ailoot Ultra · Vaizdo įrašai
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"minimax/hailuo-3","prompt":"A serene mountain landscape at sunset","resolution":"2K"}', encoding='utf-8')
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
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.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
Gauti ir išsaugoti rezultatus
Ailoot Ultra · Vaizdo įrašai
pasirašyti jums priklausančio turinio URL
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Tikrinti užduoties būseną
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
Kito turinio skaitymas
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
Išsaugoti visus baigtus rezultatus
Išsaugokite kiekvieną baigtą vaizdo įrašą arba grąžintą failą; gaukite turinį iš kiekvieno faktiškai grąžinto medžiagos URL.
Išsaugokite kiekvieną tikrą jums priklausantį rezultatą ir grąžintus išmatuotus jo metaduomenis.
Jei reikia patikrinti pradinį atsakymą
503 result_pending_check + pradinis id + X-Should-Retry:false; niekada nekartokite pradinės užklausos
Atsakymo laukai
| Laukas | Tipas | Reikšmė |
|---|---|---|
Laukasindex | Tipasinteger | ReikšmėŠio vaizdo įrašo pozicija rezultatų sąraše, skaičiuojama nuo nulio. |
Laukascontent_url | Tipasstring | ReikšmėPasirašytas HTTPS atsisiuntimo URL šiam užbaigtam vaizdo įrašui. |
Laukassha256 | Tipasstring | null | ReikšmėPradinio vaizdo įrašo baitų SHA-256 santrauka; null, jei nepasiekiama. |
Laukassize_bytes | Tipasinteger | null | ReikšmėPradinio vaizdo įrašo failo dydis baitais; null, jei nepasiekiamas. |
Laukasduration_ms | Tipasinteger | null | ReikšmėIšmatuota vaizdo įrašo trukmė milisekundėmis; null, jei nepasiekiama. |
Laukaswidth | Tipasinteger | null | ReikšmėVaizdo įrašo plotis pikseliais; null, jei nepasiekiamas. |
Laukasheight | Tipasinteger | null | ReikšmėVaizdo įrašo aukštis pikseliais; null, jei nepasiekiamas. |
Laukasvideo_codec | Tipasstring | null | ReikšmėVaizdo kodeko identifikatorius; null, jei neužregistruotas. |
Laukashas_audio | Tipasboolean | null | ReikšmėAr vaizdo įraše yra garso takelis; null, jei nenustatyta. |
Laukasaudio_codec | Tipasstring | null | ReikšmėGarso kodeko identifikatorius; null, kai identifikatorius neužregistruotas. |
Klaidos ir tolesni veiksmai
| Atsakymas | Sąlyga | Kitas žingsnis |
|---|---|---|
Atsakymas404 · not_found_error | SąlygaPrieiga prie vaizdo įrašo nepasiekiama arba šis vaizdo įrašo ID nerastas. | Kitas žingsnisPatikrinkite prieigą prie vaizdo įrašo. Jei vaizdo įrašas jau yra, naudokite jo pradinį viešą ID ir tą patį API raktą. |
Atsakymas401 · authentication_error | SąlygaAPI raktas neatitinka autentifikuotos paskyros. | Kitas žingsnisPrieš pateikdami patikrinkite savo API raktą ir paskyros prieigą. |
Atsakymas400 · invalid_request_error | SąlygaNepavyko nuskaityti užklausos arba atsisiuntimo indeksas netinkamas. | Kitas žingsnisPataisykite užklausos turinį. Atsisiuntimui pasirinkite išvesties indeksą, kurį grąžino pradinė užduotis. |
Atsakymas422 · price_unavailable | SąlygaPasirinktos vaizdo įrašo konfigūracijos kainos nustatyti negalima. | Kitas žingsnisPasirinkite palaikomą vaizdo įrašo konfigūraciją ir prieš pateikdami pataisytą užklausą užpildykite jos privalomas parinktis. |
Atsakymas422 · invalid_request_error | SąlygaVaizdo įrašo įvestis arba pradinė tęsinio užduotis netinkama. | Kitas žingsnisNaudokite tinkamą HTTPS įvestį. Tęsiniui naudokite užbaigto pradinio vaizdo įrašo viešą ID ir tą patį API raktą. |
Atsakymas402 · billing_error | SąlygaTurimas likutis arba limitai neleidžia rezervuoti lėšų. | Kitas žingsnisPrieš siųsdami naują užklausą patikrinkite turimą likutį ir limitus. |
Atsakymas503 · server_error | SąlygaVaizdo įrašo patikra, saugykla arba prieiga prie paslaugos laikinai nepasiekiama. | Kitas žingsnisPalaukite, kol paslauga taps pasiekiama. Jei jau turite vaizdo įrašo ID, tikrinkite tą pradinę užduotį, užuot pradėję kitą generavimą. |
Atsakymas503 · result_pending_check | SąlygaReikia patikrinti pradinį vaizdo įrašo rezultatą ir mokestį. | Kitas žingsnisIšsaugokite grąžintą vaizdo įrašo ID ir tikrinkite tą užduotį. Kol ji tikrinama, nesiųskite ją pakeičiančios generavimo užklausos. |
Atsakymas503 · owned_result_unavailable | SąlygaEsamo vaizdo įrašo atsisiuntimas laikinai nepasiekiamas. | Kitas žingsnisVėliau patikrinkite tą pačią vaizdo įrašo užduotį ir atsisiųskite jos esamą rezultatą. Naujas generavimas sukuria atskirą operaciją. |
Atsakymas409 · video_not_ready | SąlygaVaizdo įrašo turinys nepaskelbtas. | Kitas žingsnisPatikrinkite pradinės užduoties būseną. Atsisiųskite, kai ji praneša completed; jei praneša failed, vadovaukitės jos pranešimu apie mokesčio patikrą. |
Pseudonimai
Modelių pseudonimai
Ailoot Ultra minimax/hailuo-3
Metodų kelių pseudonimai
Naudokite aukščiau nurodytus metodų kelius.
Susiję ID iškvietimui
FAQ · MiniMax: H3
- Kokios įvestys ir rezultatai prieinami?
POST /v1/videos·minimax/hailuo-3:text,image,audio,video→video- Kokius laukus naudoja užklausa?
POST /v1/videos·minimax/hailuo-3:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,callback_url,session_id,trace,user- Kokie apribojimai taikomi?
POST /v1/videos·minimax/hailuo-3:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1