Hailuo 2.3 Fast
MiniMax Hailuo 2.3 Fast anima un’immagine del primo fotogramma da un breve prompt di movimento. Scegli questo profilo da immagine a video per un’inquadratura di prodotto, una posa di personaggio o un’immagine fissa di storyboard.
Informazioni sul modello
Questa descrizione illustra le funzionalità del modello. Gli input, gli output e le opzioni disponibili in Ailoot per il metodo selezionato sono elencati di seguito.
MiniMax Hailuo 2.3 Fast è il profilo denominato Fast per la generazione di video da immagini. Parti da un’immagine iniziale composta e descrivi come devono muoversi soggetto o camera. Un’immagine fissa di prodotto, una posa di personaggio o un fotogramma di storyboard forniscono all’inquadratura un punto di partenza visivo concreto.
Preparare l’immagine e il brief di movimento
Fornisci un’immagine quadrata PNG o JPEG tramite un URL HTTPS, con ogni lato tra 300 e 4.096 pixel. Il file immagine scaricato non deve superare 20.000.000 byte. Mantieni il prompt tra 1 e 199 caratteri, concentrato su un’azione visibile e sul movimento importante per l’inquadratura.
Seguire la clip fino al completamento
Questo profilo è configurato per una sola clip MP4 di 768 × 768 pixel con durata nominale di sei secondi. Invia la richiesta una sola volta, salva l’ID restituito e segui quella richiesta originale fino al completamento. Scarica il video restituito e conserva dimensioni dichiarate e durata misurata insieme al risultato. Se l’esito della creazione è incerto, continua a controllare la richiesta originale invece di crearla di nuovo.
Ailoot Ultra · Video POST /v1/videos MiniMax-Hailuo-2.3-Fast
MiniMax-Hailuo-2.3-FastIntroduzione
MiniMax Hailuo 2.3 Fast anima un’immagine del primo fotogramma da un breve prompt di movimento. Scegli questo profilo da immagine a video per un’inquadratura di prodotto, una posa di personaggio o un’immagine fissa di storyboard.
- Input accettati
- Testo · Immagini
- Risultati
- Video
Disponibile in Ailoot · input e metodi
Ailoot Ultra · Video POST /v1/videos
- Tipi di input
text,image- Tipi di output
video- Formato di output
- mp4
- Numero di output
- Fino a 1 output
| Campo | Tipo | Requisito | Valori e limiti | Predefinito |
|---|---|---|---|---|
Campomodel | Tipostring | RequisitoObbligatorio | Valori e limiti MiniMax-Hailuo-2.3-Fast | Predefinito— |
Campoprompt | Tipostring | RequisitoObbligatorio | Valori e limiti Lunghezza minima: 1 Lunghezza massima: 199 Unità: caratteri Unicode | Predefinito— |
Campoduration | Tipointeger | RequisitoObbligatorio | Valori e limiti 6 Unità: secondi | Predefinito— |
Camporesolution | Tipostring | RequisitoObbligatorio | Valori e limiti 768P | Predefinito— |
Campofirst_frame_image | Tipohttps_url | RequisitoObbligatorio | Valori e limiti Dimensione massima del file in byte: 20.000.000 Tipi MIME: image/png, image/jpeg Dimensione minima: 300 Dimensione massima: 4096 Solo quadrato: Sì | Predefinito— |
Combinazioni di materiali in input
Da immagine a video · Obbligatorio: prompt, first_frame_image
Parametri e ciclo di vita del metodo
| Parametro | Contratto |
|---|---|
Parametrocontent_type | Contrattoapplication/json |
Parametrorequired | Contrattomodel, prompt, duration, resolution, first_frame_image |
Parametroother_options | Contrattofalse |
Parametroduration | Contratto6 |
Parametroresolution | Contratto768P |
Parametroprompt_max_characters | Contratto199 |
Parametrofirst_frame_image | Contratto{"type":"https_url","format":["png","jpeg"],"dimensions":"quadrato di 300..4096 pixel","full_image_validation_before_send":true,"maximum_file_bytes":20000000} |
Parametromaterial_types | Contrattotext, image |
Parametroadditional_properties | Contrattofalse |
Alias del metodo: /v1/videos/generations, /videos, /videos/generations
Ciclo di vita: 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
Crea una sola volta e salva l'ID restituito.
Interroga periodicamente lo stato originale; conserva ogni risorsa completata e la relativa durata.
Tariffe
Le tariffe non aggiungono opzioni alla richiesta. I parametri supportati sono elencati nel metodo selezionato.
- Modalità rapida
- Non specificato Quando è selezionata la modalità rapida
- Modalità flex
- Non specificato Quando è selezionata la modalità flex
- Sforzo massimo di ragionamento
- Non specificato Quando lo sforzo massimo di ragionamento usa l'adeguamento predefinito (default)
Tariffe Ailoot
Prezzi per configurazione
Associa ogni costo alle condizioni indicate. Usa una sola tariffa per ogni insieme di configurazioni alternative.
| Configurazione | Listino delle tariffe | Durata nominale del clip, secondi | Risoluzione | Unità di fatturazione | Costo |
|---|---|---|---|---|---|
| ConfigurazioneTariffe base dei token | Listino delle tariffeTariffa base | Durata nominale del clip, secondi— | Risoluzione— | Unità di fatturazione— | Costo Input · Token in input — / 1K token Output · Token in output — / 1K token Input · Lettura dalla cache — / 1K token Input · Scrittura nella cache — / 1K token Input · Scrittura nella cache, 1 ora — / 1K token |
| ConfigurazioneUltra | Listino delle tariffe— | Durata nominale del clip, secondi6 | Risoluzione768P | Unità di fatturazioneper clip in output di durata nominale 6s | Costo Output · clip in uscita di durata nominale 6s $0.4 per clip in output di durata nominale 6s |
Ailoot prenota un importo stimato prima di una richiesta. Dopo il risultato, addebita il costo finale in base all’utilizzo misurato. Per lo streaming, l’addebito usa il record finale di utilizzo. Come funzionano la prenotazione e l’addebito finale →
Dettagli della tariffa di riferimento
I listini di riferimento del modello non modificano la selezione del metodo, i preventivi o gli addebiti. Gli addebiti attivi usano le tariffe del metodo Ailoot selezionato.
MiniMax-Hailuo-2.3-Fast
Prezzi per configurazione
| Configurazione | Condizioni di fatturazione | Costo |
|---|---|---|
| ConfigurazioneMiniMax-Hailuo-2.3-Fast · Configurazione predefinita | Condizioni di fatturazioneConfigurazione predefinita | Costo Input · Input 0,00 USD per chiamata Output · Output 0,40 USD per chiamata |
MiniMax-Hailuo-2.3-Fast
Prezzi per configurazione
| Configurazione | Condizioni di fatturazione | Costo |
|---|---|---|
| ConfigurazioneMiniMax-Hailuo-2.3-Fast · Configurazione predefinita | Condizioni di fatturazioneConfigurazione predefinita | Costo Input · Input 0,00 USD per chiamata Output · Output 0,80 USD per chiamata |
MiniMax-Hailuo-2.3-Fast
Prezzi per configurazione
| Configurazione | Condizioni di fatturazione | Costo |
|---|---|---|
| ConfigurazioneMiniMax-Hailuo-2.3-Fast · Configurazione predefinita | Condizioni di fatturazioneConfigurazione predefinita | Costo Input · Input 0,00 USD per chiamata Output · Output 0,80 USD per chiamata |
Esempi di richieste
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
Ricevi e salva i risultati
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
Verifica lo stato dell’attività
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
Altre letture di contenuto
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
Conserva tutti i risultati completati
Salva ogni video completato o file restituito; recupera ogni URL di risorsa effettivamente restituito.
A completamento, data[] contiene tutti gli URL firmati dei contenuti di tua proprietà. Recupera ogni URL restituito oppure usa l'endpoint del contenuto impostando index su un indice di uscita effettivo. Un'attività originale non riuscita può restituire charge_pending_check; verifica quell'attività originale invece di crearla nuovamente.
Se occorre verificare la risposta originale
Consulta l'attività originale esistente; non ripetere mai un invio dall'esito sconosciuto.
Numero massimo di output: 1.
Campi della risposta
| Campo | Tipo | Significato |
|---|---|---|
Campoid | Tipostring | Significato— |
Campoobject | Tipostring | Significato— |
Campomodel | Tipostring | Significato— |
Campostatus | Tipostring | Significato— |
Campodata[] | Tiposigned content URL | Significato— |
Campocharge_pending_check | Tipoboolean | Significato— |
Campoerror.code | Tipostring | Significato— |
Campoerror.message | Tipostring | Significato— |
Camporequested_nominal_duration_seconds | Tipointeger | Significato— |
Campomeasured_duration_seconds | Tiponumber | Significato— |
Campowidth | Tipointeger | Significato— |
Campoheight | Tipointeger | Significato— |
Campooperation_id | Tipostring | SignificatoRestituito quando status=unknown; ID pubblico effettivo dell'operazione video originale |
Camporequest_id | Tipostring | SignificatoFacoltativo quando status=unknown; restituito solo se l'attività originale ha un ID di richiesta |
Errori e passaggi successivi
| Risposta | Condizione | Passaggio successivo |
|---|---|---|
Risposta400 · invalid_request_error | CondizioneLa lettura del corpo grezzo della richiesta non riesce prima dell'analisi del profilo video | Passaggio successivoConserva la risposta restituita e correggi il corpo della richiesta illeggibile. |
Risposta422 · price_unavailable | CondizioneL'analisi del profilo video esatto non riesce oppure il profilo analizzato completo non dispone di una scheda tariffaria esatta pronta all'uso | Passaggio successivoConserva la risposta; usa il profilo completo esatto autorizzato e la relativa scheda pubblicata. Questo ramo viene eseguito prima dell'invio al fornitore. |
Risposta409 · video_not_ready | CondizioneContenuto del risultato originale non ancora disponibile | Passaggio successivoInterroga periodicamente l'ID originale restituito e rispetta Retry-After. |
Rispostaserver_error | CondizioneLa risposta restituita indica che l'operazione o il risultato richiede una verifica | Passaggio successivoConserva l'ID originale di operazione/task restituito, gli header della richiesta e la risposta; continua a leggere l'operazione originale tramite le modalità supportate. Non reinviare la richiesta di creazione. |
Risposta200 · video_result_unverified | CondizioneLo stato dell'attività Fast originale è sconosciuto; status=unknown e charge_pending_check=true | Passaggio successivoConserva id/operation_id effettivamente restituiti e request_id facoltativo; consulta solo l'attività originale. Non inviare mai nuovamente la richiesta. |
Alias
Alias del modello
Ailoot Ultra MiniMax-Hailuo-2.3-Fast
Alias dei percorsi dei metodi
/v1/videos/generations, /videos, /videos/generations
ID di chiamata correlati
FAQ · Hailuo 2.3 Fast
- Quali input e risultati sono disponibili?
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:text,image→video- Quali campi usa la richiesta?
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:model,prompt,duration,resolution,first_frame_image- Quali limiti si applicano?
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:prompt.maximum_length:199