MiniMax: H3 Max
MiniMax H3 Max är en snabb eftertränad H3-variant för kort video med synkroniserat ljud. MiniMax dokumenterar ett arbetsflöde med text, bildrutor och multimodala referenser, utdata i 480P eller 768P, en längd på 5–15 sekunder och egna val för promptutökning.
Om modellen
Den här beskrivningen omfattar modellens förmågor. Tillgängliga indata, utdata och alternativ i Ailoot anges nedan för den valda metoden.
En snabb eftertränad H3-variant
MiniMax H3 Max är en eftertränad variant av basmodellen MiniMax H3, optimerad för snabbare generering, följsamhet mot prompten och audiovisuell kvalitet. Varianten utvecklades genom efterträning av fal Research. Den behåller ett gemensamt multimodalt sammanhang och inbyggd synkronisering av bild och ljud. Snabbhet är en designprioritering, inte en fast sluttid för varje prompt, längd eller tillämpning.
Håll Max åtskild från det ursprungliga H3-systemet och från den separata varianten Max Turbo. MiniMax nuvarande gränssnitt listar Max i 480P eller 768P, med 768P som standard, 24 bilder per sekund och en heltalslängd på 5 till 15 sekunder. Det dokumenterade Max-flödet erbjuder varken det ursprungliga H3-systemets 2K-inställning eller utdata på fyra sekunder.
Från prompt till tagning
Varje generering innehåller en textinstruktion som inte är tom, med upp till 7 000 tecken per textpost. Beskriv motivet, den inledande kompositionen, handlingen och resultatet, och ange sedan tydligt riktning för kamera och ljud. För ett kort avslöjande av ett föremål anger du vad tittaren ska se först, hur föremålet kommer in i bild och hur tagningen ska sluta.
En användbar femsekundersinstruktion kan beskriva en keramikkopp på ett träbord, en hand som ställer ett fat bredvid den, en liten framåtrörelse med kameran och ljudet av keramik som möter trä. Håll handlingen tillräckligt liten för den valda längden och kontrollera att den returnerade rörelsen och ljudet följer samma händelse.
Skapande med styrande bildrutor
Tillverkaren dokumenterar en öppningsbild, en slutbild eller båda. En första bild fastställer var klippet börjar; en sista bild fastställer det slutliga visuella tillståndet. Förklara rörelsen mellan dem, inklusive förändringar i pose, objektplacering, kamera eller belysning. För en övergång mellan två bildrutor bör instruktionen inte införa en oförenlig scen mellan ändpunkterna.
Utdata som styrs av bildrutor får sitt bildförhållande från inmatningsbilden. För arbete med enbart text väljer du ett konkret förhållande bland 21:9, 16:9, 4:3, 1:1, 3:4 eller 9:16. Referensstyrt arbete kan använda ett adaptivt förhållande eller ett av de dokumenterade uttryckliga valen. Komponera referensen eller den skrivna scenen för målformatet i stället för att anta att samma upplägg fungerar lika bra stående och liggande.
Multimodala referenser
MiniMax nuvarande genereringsschema för Max dokumenterar också referensbilder, video och ljud. Ange vad varje källa ska påverka: karaktärsidentitet, miljö, rörelsemönster, kamerabana, röstklang eller ljudegenskap. Roller som första/sista bildruta och roller som referensmedia utesluter varandra i det gränssnittet.
För en karaktärstagning identifierar du utseendereferensen och rörelsereferensen var för sig och anger sedan målhandlingen och repliken. En röstreferens som fastställer framförandet skiljer sig från att kopiera hela dess ljudsignal. Ange uttryckligen vilka egenskaper som ska bevaras och vilka ändringar som ska göras, och granska det faktiska audiovisuella klippet mot varje referensroll.
Promptutökning
Max specifika inställning för utökning erbjuder valen disabled, balanced och quality, med balanced som standard. Välj disabled när den angivna instruktionen ska passera utan utökning; använd ett dokumenterat utökningsläge när ytterligare tolkning önskas. Behåll originalinstruktionen så att en ändring som införts under utökningen går att skilja från det begärda innehållet.
Beskriv ljudet som en del av scenen. Ange fysiska ljud, atmosfär och eventuella talade ord, och skilj dem från bakgrundsmusik som bara publiken hör. Ange den exakta repliken och avsedd talare i stället för att begära ospecificerad dialog. Lyssna på resultatet samtidigt som du tittar; en övertygande bild bevisar inte att ordalydelse eller tajmning är rätt.
Förberedelse av indata och begränsningar
Tillverkarens nuvarande schema tar emot bilder i JPG, JPEG, PNG, WebP, HEIC eller HEIF, högst 30 MB per bild, med sidor på 256 till 5 760 pixlar och förhållanden från 0,4 till 2,5. Öppnings- och slutroller tillåter en bild vardera; referensläget tillåter upp till nio bilder. Bevara en tydlig vy av motivet och de detaljer som måste förbli identifierbara.
Referensvideo tillåter upp till tre MP4- eller MOV-klipp, vart och ett 2–15 sekunder och sammanlagt högst 15 sekunder, med en gräns på 50 MB per fil. Den dokumenterar H.264- eller H.265-video, AAC- eller MP3-ljud, sidor på 256 till 5 760 pixlar, förhållanden från 0,4 till 2,5 och bildfrekvens från 23,976 till 60. Referensljud tillåter upp till tre WAV- eller MP3-klipp, vart och ett högst 15 MB och 2–15 sekunder, sammanlagt högst 15 sekunder. Förfrågningskroppen har en separat gräns på 64 MB.
Använd bara referenser som bidrar till tagningen och identifiera varje bidrag i texten. Ett kort, relevant rörelseklipp är lättare att använda som instruktion än en lång samling orelaterade händelser. Ange den avsedda längden och upplösningen uttryckligen så att resultatet kan jämföras med samma instruktion.
Det färdiga resultatet
Tillverkarens asynkrona arbetsflöde returnerar ett uppgifts-ID innan den färdiga videon finns tillgänglig. Gränssnittet för uppgiftsfrågor hämtar uppgifter från de föregående sju dagarna. Spara det faktiskt returnerade klippet och dess specifikation för redigering eller vidare granskning; ett uppgifts-ID är inte den audiovisuella leveransen. Nedladdningsadresser är tidsbegränsade, så behåll själva filen när du sparar ett valt resultat.
Granska motivets kontinuitet, rörelse, synlig text, dialog och ljudtajmning i den storlek där klippet ska användas. Ge konkret återkoppling inför nästa kreativa instruktion: gesten som ändrades, repliken som saknades eller utsnittet som behöver justeras. Det användbara resultatet är en kort audiovisuell tagning kopplad till det inskickade innehållet och dess uttryckliga referensrelationer.
Ailoot Ultra · Video POST /v1/videos minimax/hailuo-3-max
minimax/hailuo-3-maxStart
MiniMax H3 Max är en snabb eftertränad H3-variant för kort video med synkroniserat ljud. MiniMax dokumenterar ett arbetsflöde med text, bildrutor och multimodala referenser, utdata i 480P eller 768P, en längd på 5–15 sekunder och egna val för promptutökning.
- Godkända indata
- Text · Bilder
- Resultat
- Video
Tillgängligt i Ailoot · indata & metoder
Ailoot Ultra · Video POST /v1/videos
- Indatatyper
text,image- Utdatatyper
video- Utdataformat
- ursprungliga MP4-byte; ingen normalisering/omkodning
| Fält | Typ | Krav | Värden & gränser | Standard |
|---|---|---|---|---|
Fältmodel | Typstring | KravObligatoriskt | Värden & gränser minimax/hailuo-3-max | Standard— |
Fältprompt | Typstring | KravObligatoriskt | Värden & gränser | Standard— |
Fältduration | Typinteger | KravObligatoriskt | Värden & gränser 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Minimum: 1 Maximum: 600 | Standard— |
Fältresolution | Typstring | KravValfritt | Värden & gränser 768p, 480p | Standard— |
Fältaspect_ratio | Typstring | KravValfritt | Värden & gränser 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Standard— |
Fältgenerate_audio | Typboolean | KravValfritt | Värden & gränser false | Standard— |
Fältframe_images | Typarray | KravValfritt | Värden & gränser Minsta antal objekt: 1 Maximalt antal objekt: 2 Indatainnehåll: Array med bildruteobjekt. Varje objekt har type=image_url, image_url som innehåller url samt frame_type. Använd en HTTPS URL till en bild och sätt frame_type till first_frame eller last_frame. Varje bildruteroll förekommer högst en gång. Exakta nycklar: type, image_url, frame_type Villkor: Dessa nycklar beskriver varje bildruteobjekt; image_url innehåller endast url. Utelämna frame_images för en begäran med enbart text. | Standard— |
Fältinput_references | Typarray | KravValfritt | Värden & gränser | Standard— |
Fältcallback_url | Typstring | KravValfritt | Värden & gränser Mönster: ^https:// | Standard— |
Fältsession_id | Typstring | KravValfritt | Värden & gränser | Standard— |
Fälttrace | Typobject | KravValfritt | Värden & gränser | Standard— |
Fältuser | Typstring | KravValfritt | Värden & gränser | Standard— |
Kombinationer av indatamaterial
Text till video · En skriven prompt. · Krävs: model, prompt, duration
Ange prompt som text och längd i hela sekunder. Välj en upplösning som stöds och vid behov ett bildförhållande.
model: Typ: string · minimax/hailuo-3-max
prompt: Typ: string · Maximalt antal UTF-8-byte: 10 000 · Minst ett tecken som inte är blanksteg krävs: Ja
Bild till video · En skriven prompt och en bild för den första bildrutan. · Krävs: model, prompt, duration, frame_images
frame_images är en array. Varje bildruteobjekt har type, image_url och frame_type; image_url innehåller url. Sätt type till image_url. Använd first_frame med valfri last_frame. Varje bildruteroll förekommer högst en gång. Ange en offentlig HTTPS URL till en bild för varje bildruta. Välj en upplösning som stöds och vid behov ett bildförhållande.
Exakta nycklar: type, image_url, frame_type
model: Typ: string · minimax/hailuo-3-max
prompt: Typ: string · Maximalt antal UTF-8-byte: 10 000 · Minst ett tecken som inte är blanksteg krävs: Ja
Metodparametrar och livscykel
| Parameter | Avtal |
|---|---|
Parametercontent_type | Avtalapplication/json |
Parameterrequired | Avtalmodel, prompt, duration |
Parametermaterial_types | Avtaltext, image |
Parameteradditional_properties | Avtalfalse |
Parameteroptional_controls | Avtalresolution, aspect_ratio, generate_audio, frame_images, input_references, callback_url, session_id, trace, user |
Livscykel: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
Priser
Så beräknas slutavgiften
De visade priserna används för att uppskatta kostnaden före genereringen. Den slutliga debiteringen beräknas utifrån den kostnad som registrerats för den ursprungliga genereringen. Uppmätt längd på resultatet och uppskattade mängder utgör inte den slutliga debiterbara mängden.
Tariffuppgifter lägger inte till begäransalternativ. Parametrar som stöds anges för den valda metoden.
- Snabbt läge
- Ej angivet När snabbt läge är valt
- Flex-läge
- Ej angivet När läget flex är valt
- Högsta resonemangsnivå
- Ej angivet När den högsta resonemangsnivån använder standardjusteringen (default)
Uppskattade priser för jämförelse
Priser efter konfiguration
Matcha varje avgift mot de visade villkoren. Använd ett pris för varje uppsättning alternativa konfigurationer.
| Konfiguration | Prislista | Prognostiserad mängd | Avgiftskomponent | Debiteringsenhet | Debiteringsvillkor | Avgift |
|---|---|---|---|---|---|---|
| KonfigurationGrundpriser för token | PrislistaGrundpris | Prognostiserad mängd— | Avgiftskomponent— | Debiteringsenhet— | Debiteringsvillkor— | Avgift Indata · Indatatoken · Uppskattning endast för jämförelse — / 1K token Utdata · Utdatatoken · Uppskattning endast för jämförelse — / 1K token Indata · Cacheläsning · Uppskattning endast för jämförelse — / 1K token Indata · Skrivning till cache · Uppskattning endast för jämförelse — / 1K token Indata · Skrivning till cache, 1 tim · Uppskattning endast för jämförelse — / 1K token |
| KonfigurationVideoutdata · referenspris | Prislista— | Prognostiserad mängd— | Avgiftskomponentreference_output_rate | Debiteringsenhetper utdatasekund | Debiteringsvillkor— | Avgift Utdata · Referenstaxa per sekund utgående video · Uppskattning endast för jämförelse $0.16 per utdatasekund |
| KonfigurationVideopris | Prislista— | Prognostiserad mängd— | Avgiftskomponent— | Debiteringsenhetper videosekund | Debiteringsvillkorresolution: 480p | Avgift Utdata · Videopris · Uppskattning endast för jämförelse $0.1 per videosekund |
| KonfigurationVideopris | Prislista— | Prognostiserad mängd— | Avgiftskomponent— | Debiteringsenhetper videosekund | Debiteringsvillkorresolution: 768p | Avgift Utdata · Videopris · Uppskattning endast för jämförelse $0.16 per videosekund |
| KonfigurationUppskattad genereringskostnad | Prislista— | Prognostiserad mängduppskattning för en generering | Avgiftskomponent— | Debiteringsenhet— | Debiteringsvillkor— | Avgift Utdata · Uppskattad genereringskostnad · Uppskattning endast för jämförelse $0.5 uppskattning före generering Denna uppskattning är varken en extra avgift eller ett fast pris för den slutförda genereringen. |
Ailoot reserverar ett uppskattat belopp före en begäran. Efter resultatet slutregleras avgiften utifrån uppmätt förbrukning. Slutreglering för strömning använder den slutliga förbrukningsposten. Så fungerar reservation och slutreglering →
Detaljer om referenstariffen
Referensprislistor på modellnivå ändrar inte metodval, prisuppgifter eller avgifter. Aktiva avgifter använder priserna för den valda Ailoot-metoden.
Prisreferenser för videokonfigurationer
Priser efter konfiguration
Matcha varje avgift mot de visade villkoren. Använd ett pris för varje uppsättning alternativa konfigurationer.
| Konfiguration | Debiteringsvillkor | Avgift |
|---|---|---|
| KonfigurationVideopris | DebiteringsvillkorInget ytterligare villkor anges i denna prisnyckel. | Avgift Utdata · Videopris $0.16 per videosekund Publicerad prisreferens för den visade konfigurationen. Den slutliga debiteringen följer den konfiguration som faktiskt debiterades. |
| KonfigurationVideopris | Debiteringsvillkorresolution: 480p | Avgift Utdata · Videopris $0.1 per videosekund Publicerad prisreferens för den visade konfigurationen. Den slutliga debiteringen följer den konfiguration som faktiskt debiterades. |
| KonfigurationVideopris | Debiteringsvillkorresolution: 768p | Avgift Utdata · Videopris $0.16 per videosekund Publicerad prisreferens för den visade konfigurationen. Den slutliga debiteringen följer den konfiguration som faktiskt debiterades. |
Exempelbegäranden
Ailoot Ultra · Video
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-max","prompt":"A serene mountain landscape at sunset","resolution":"480p"}', 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
Ta emot och spara resultat
Ailoot Ultra · Video
signerade innehållslänkar som du äger
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Kontrollera jobbstatus
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
Andra innehållsläsningar
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
Behåll alla färdiga resultat
Spara varje färdig video eller returnerad fil; hämta varje faktiskt returnerad resurs-URL.
Behåll varje faktiskt resultat som du äger och dess returnerade, uppmätta metadata.
Om det ursprungliga svaret behöver kontrolleras
503 result_pending_check + ursprungligt id + X-Should-Retry:false; upprepa aldrig originalet
Svarsfält
| Fält | Typ | Betydelse |
|---|---|---|
Fältindex | Typinteger | BetydelseNollbaserad position för denna video i utdatalistan. |
Fältcontent_url | Typstring | BetydelseSignerad HTTPS URL för hämtning av denna färdiga video. |
Fältsha256 | Typstring | null | BetydelseSHA-256-kontrollsumma för den ursprungliga videons byte; null om den inte är tillgänglig. |
Fältsize_bytes | Typinteger | null | BetydelseStorleken på den ursprungliga videofilen i byte; null om den inte är tillgänglig. |
Fältduration_ms | Typinteger | null | BetydelseUppmätt videolängd i millisekunder; null om den inte är tillgänglig. |
Fältwidth | Typinteger | null | BetydelseVideobredd i pixlar; null om den inte är tillgänglig. |
Fältheight | Typinteger | null | BetydelseVideohöjd i pixlar; null om den inte är tillgänglig. |
Fältvideo_codec | Typstring | null | BetydelseIdentifierare för videokodek; null om ingen har registrerats. |
Fälthas_audio | Typboolean | null | BetydelseOm videon innehåller ett ljudspår; null om detta inte har mätts. |
Fältaudio_codec | Typstring | null | BetydelseIdentifierare för ljudkodek; null när ingen identifierare har registrerats. |
Fel och nästa steg
| Svar | Villkor | Nästa steg |
|---|---|---|
Svar404 · not_found_error | VillkorVideoåtkomst är inte tillgänglig eller detta video-ID hittades inte. | Nästa stegKontrollera videoåtkomst. För en befintlig video använder du dess ursprungliga offentliga ID och samma API-nyckel. |
Svar401 · authentication_error | VillkorAPI-nyckeln motsvarar inte det autentiserade kontot. | Nästa stegKontrollera din API-nyckel och kontoåtkomst innan du skickar in. |
Svar400 · invalid_request_error | VillkorBegäran kunde inte läsas eller hämtningsindexet är ogiltigt. | Nästa stegKorrigera begäranskroppen. Vid hämtning väljer du ett utdataindex som returnerats av den ursprungliga uppgiften. |
Svar422 · price_unavailable | VillkorDen valda videokonfigurationen kan inte prissättas. | Nästa stegVälj en videokonfiguration som stöds och fyll i dess obligatoriska alternativ innan du skickar en korrigerad begäran. |
Svar422 · invalid_request_error | VillkorVideoindata eller den ursprungliga fortsättningsuppgiften är ogiltig. | Nästa stegAnvänd giltiga HTTPS-indata. För fortsättning använder du det färdiga originalets offentliga video-ID med samma API-nyckel. |
Svar402 · billing_error | VillkorDet tillgängliga saldot eller gränserna medger ingen reservation. | Nästa stegKontrollera ditt tillgängliga saldo och dina gränser innan du skickar en ny begäran. |
Svar503 · server_error | VillkorVideoverifiering, lagring eller tjänsteåtkomst är tillfälligt otillgänglig. | Nästa stegVänta tills tjänsten är tillgänglig. Om du redan har ett video-ID kontrollerar du den ursprungliga uppgiften i stället för att skapa en ny generering. |
Svar503 · result_pending_check | VillkorDet ursprungliga videoresultatet och debiteringen behöver kontrolleras. | Nästa stegBehåll det returnerade video-ID:t och kontrollera den uppgiften. Skicka ingen ersättande genereringsbegäran medan den kontrolleras. |
Svar503 · owned_result_unavailable | VillkorHämtningen av den befintliga videon är tillfälligt otillgänglig. | Nästa stegKontrollera samma videouppgift senare och hämta dess befintliga resultat. En ny generering skapar en separat operation. |
Svar409 · video_not_ready | VillkorVideoinnehållet har inte publicerats. | Nästa stegKontrollera den ursprungliga uppgiftens status. Hämta när den rapporterar completed; om den rapporterar failed följer du dess meddelande om debiteringskontroll. |
Alias
Modellalias
Ailoot Ultra minimax/hailuo-3-max
Alias för metodsökvägar
Använd metodsökvägarna som visas ovan.
Relaterade anropar-ID:n
FAQ · MiniMax: H3 Max
- Vilka indata och resultat finns?
POST /v1/videos·minimax/hailuo-3-max:text,image→video- Vilka fält använder begäran?
POST /v1/videos·minimax/hailuo-3-max:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,callback_url,session_id,trace,user- Vilka gränser gäller?
POST /v1/videos·minimax/hailuo-3-max:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1