MiniMax: Hailuo 02

Hailuo 02 crea vídeo a partir de texto o de una imagen del primer fotograma y admite un proceso documentado con fotogramas inicial y final. Los comandos de cámara, la optimización de instrucciones y las opciones de duración y resolución específicas de cada modo ayudan a dar forma al plano previsto.

Ailoot Ultra · Vídeo POST /v1/videos minimaxi-hailuo-02

Sobre el modelo

Esta descripción cubre las capacidades del modelo. Las entradas, salidas y opciones disponibles en Ailoot se indican a continuación para el método seleccionado.

Hailuo 02 es el modelo de vídeo de MiniMax para escenas basadas en texto, animación de imágenes y un proceso con fotogramas inicial y final. Unas indicaciones escritas describen el sujeto, la acción y la cámara, mientras que las imágenes de fotogramas proporcionadas pueden establecer el punto de partida visual o el destino de la transición. Elige el modo de generación según el material que ya tengas y la parte del plano que necesites controlar.

Para texto a vídeo, describe una acción coherente con un entorno y un punto de vista claros. Una escena puede mostrar un pequeño velero que pasa junto a un muelle mientras la cámara lo sigue desde la orilla. Especifica qué se mueve, qué detalles deben seguir siendo visibles y cómo termina el plano. Mantén las indicaciones centradas en acontecimientos observables, en lugar de una lista de cualidades visuales no relacionadas.

Para imagen a vídeo, prepara un primer fotograma con el sujeto y el encuadre deseados ya establecidos. El fabricante acepta imágenes JPG, JPEG, PNG y WebP de menos de 20 MB, con un lado corto de más de 300 píxeles y una relación de aspecto entre 2:5 y 5:2. Utiliza una imagen cuyos contornos y rasgos importantes sean visibles y describe después el movimiento que debe desarrollarse a partir de ella.

Hailuo 02 también tiene un modo documentado con fotogramas inicial y final. Prepara las dos imágenes como los estados inicial y final deseados de una secuencia y describe cómo se mueve la escena entre ellos. El primer fotograma determina el encuadre; el fabricante indica que un último fotograma de tamaño distinto se recorta para adaptarlo al primero. Alinea de antemano la composición de las imágenes cuando un sujeto deba seguir siendo visible durante la transición.

Las instrucciones pueden contener hasta 2.000 caracteres. Hailuo 02 admite comandos de cámara entre corchetes, incluidos push, pull, truck, pan, pedestal, tilt, zoom, tracking y un plano estático. Los comandos colocados juntos en un mismo par de corchetes solicitan movimiento simultáneo; los colocados en distintos puntos de la descripción solicitan una secuencia. El fabricante recomienda combinar como máximo tres movimientos, por lo que conviene elegir la acción de cámara que facilite ver al sujeto con claridad.

La duración y la resolución están vinculadas al modo. Texto a vídeo documenta seis o diez segundos a 768P y seis segundos a 1080P. Imagen a vídeo también documenta 512P para seis o diez segundos. El proceso con fotogramas inicial y final documenta 768P para seis o diez segundos y 1080P para seis segundos. Selecciona una combinación admitida para el plano, en lugar de trasladar las opciones de resolución de un modo a todos los demás.

La optimización automática de instrucciones es un control documentado y está activada de forma predeterminada en el proceso del fabricante. Conserva su ajuste al comparar versiones, porque unas indicaciones reescritas cambian lo que recibe el modelo. Guarda el texto exacto, los fotogramas de referencia y los ajustes de salida seleccionados junto con el clip generado para que una revisión pueda centrarse en la acción o el encuadre que necesiten mejorar.

Revisa la secuencia completa: la composición inicial, la continuidad del sujeto, los tiempos de la acción y el fotograma final. Para una transición, comprueba ambos extremos y el movimiento entre ellos. Guarda el vídeo real para editarlo, junto con las instrucciones y las referencias; utiliza la siguiente revisión para corregir un problema visual concreto, como un detalle oculto, un movimiento brusco de cámara o un final que llegue demasiado pronto.

Ailoot Ultra · Vídeo POST /v1/videos minimaxi-hailuo-02

minimaxi-hailuo-02

MiniMax /minimaxi-hailuo-02

Primeros pasos

Entradas aceptadas: Texto · Imágenes
Resultados: Vídeo

Disponible en Ailoot · entradas y métodos

Ailoot Ultra · Vídeo POST /v1/videos

Tipos de entrada: text, image
Tipos de salida: video

Campo	Tipo	Requisito	Valores y límites	Predeterminado
Campo`model`	Tipo`string`	RequisitoObligatorio	Valores y límites minimaxi-hailuo-02 Condiciones: Usa el selector exacto de modelo de Ailoot.	Predeterminado—
Campo`prompt`	Tipo`string`	RequisitoObligatorio	Valores y límites Condiciones: Describe la escena y el movimiento.	Predeterminado—
Campo`duration`	Tipo`integer`	RequisitoOpcional	Valores y límites 6, 10 Condiciones: Envía uno de los valores de duración enumerados; no se establece ningún valor predeterminado.	Predeterminado—
Campo`end_image`	Tipo`string`	RequisitoOpcional	Valores y límites Condiciones: Un fotograma final solo se aplica en un modo de entrada de imagen compatible.	Predeterminado—
Campo`image`	Tipo`string or array<string>`	RequisitoOpcional	Valores y límites Condiciones: Usa una URL real de imagen accesible públicamente o una cadena de imagen en base64; aquí no se establece un número máximo de imágenes.	Predeterminado—
Campo`resolution`	Tipo`string`	RequisitoOpcional	Valores y límites 512P, 768P, 1080P Condiciones: Envía uno de los valores de resolución enumerados; no se establece ningún valor predeterminado.	Predeterminado—

Parámetros del método y ciclo de vida

Parámetro	Contrato
Parámetro`content_type`	Contratoapplication/json
Parámetro`required`	Contratomodel, prompt
Parámetro`optional`	Contratoduration, end_image, image, resolution
Parámetro`material_types`	Contratotext, image
Parámetro`conditions`	ContratoUsa el selector exacto de modelo de Ailoot., Describe la escena y el movimiento., Envía uno de los valores de duración enumerados; no se establece ningún valor predeterminado., Un fotograma final solo se aplica en un modo de entrada de imagen compatible., Usa una URL real de imagen accesible públicamente o una cadena de imagen en base64; aquí no se establece un número máximo de imágenes., Envía uno de los valores de resolución enumerados; no se establece ningún valor predeterminado.

Alias de método: /v1/videos/generations

Ciclo de vida: submit_once_poll_original

GET /v1/videos/{request_id}

GET /v1/videos/generations/{request_id}

GET /v1/videos/{request_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Planes

Cómo se calcula el cargo definitivo

Las tarifas mostradas estiman el coste antes de la generación. El cargo final se calcula a partir del coste registrado para la generación original. La duración medida del resultado y las cantidades previstas no constituyen la cantidad facturable final.

Las referencias tarifarias no añaden opciones a la solicitud. Los parámetros admitidos se indican en el método seleccionado.

Modo rápido: Sin especificar Cuando se selecciona el modo rápido
Modo flex: Sin especificar Cuando se selecciona el modo flex
Esfuerzo máximo de razonamiento: Sin especificar Cuando el esfuerzo máximo de razonamiento utiliza el ajuste predeterminado (default)

Tarifas estimadas para comparar

Precios por configuración

Relaciona cada cargo con las condiciones mostradas. Usa una tarifa para cada conjunto de configuraciones alternativas.

Configuración	Tabla de tarifas	Cantidad prevista	Cargo
ConfiguraciónTarifas base por token	Tabla de tarifasTarifa base	Cantidad prevista—	Cargo Entrada · Tokens de entrada · Estimación solo para comparar — / 1K tokens Salida · Tokens de salida · Estimación solo para comparar — / 1K tokens Entrada · Lectura de caché · Estimación solo para comparar — / 1K tokens Entrada · Escritura en caché · Estimación solo para comparar — / 1K tokens Entrada · Escritura en caché, 1 hora · Estimación solo para comparar — / 1K tokens
ConfiguraciónCoste estimado de generación	Tabla de tarifas—	Cantidad previstaestimación para una generación	Cargo Salida · Coste estimado de generación · Estimación solo para comparar $0.2 estimación previa a la generación Esta estimación no es un cargo adicional ni una tarifa fija para la generación completada.

Ailoot reserva un importe estimado antes de la solicitud. Tras obtener el resultado, liquida el cargo definitivo según el uso medido. En las respuestas en flujo, la liquidación usa el registro de uso final. Cómo funcionan la reserva y la liquidación →

Solicitudes de ejemplo

Ailoot Ultra · Vídeo

curl · crea una sola vez y conserva el comprobanteLee la tarea originalGuarda cada recurso completado que te pertenece

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
  "model": "minimaxi-hailuo-02",
  "prompt": "A cat is walking on grass."
}
JSON
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
# Create once; retain id, polling_url, original task identifiers and every header.

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_STATUS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
u=urljoin("https://api.ailoot.ai",r["polling_url"])
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:
    raise SystemExit("Unexpected returned polling URL; preserve the response")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True)
# Read this same original polling_url again while pending.
# Preserve unknown/result_pending_check; do not repeat creation.
PY_STATUS

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())
roles={}
def visit(v,path=""):
    if isinstance(v,dict):
        for k,x in v.items(): visit(x,path+"/"+k)
    elif isinstance(v,list):
        for i,x in enumerate(v): visit(x,path+"/"+str(i))
    elif isinstance(v,str):
        u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)
        if p.scheme=="https" and p.netloc=="api.ailoot.ai" and not p.username and not p.password and p.path.startswith("/v1/media/assets/") and p.path.endswith("/content"):
            roles.setdefault(u,[]).append(path)
visit(r)
if not roles: raise SystemExit("No completed owned assets; retain the original status")
manifest=[]
for i,(u,paths) in enumerate(roles.items()):
    target=Path(f"asset-{i}.bin")
    subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)
    raw=target.read_bytes()
    if not raw: raise SystemExit("Empty asset; retain original status and metadata")
    ext="glb" if raw[:4]==b"glTF" else "png" if raw[:8]==b"\x89PNG\r\n\x1a\n" else "jpg" if raw[:3]==b"\xff\xd8\xff" else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "mp4" if raw[4:8]==b"ftyp" else "bin"
    name=f"asset-{i}.{ext}"
    if target.name!=name: target.rename(name)
    manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})
Path("asset-manifest.json").write_text(json.dumps(manifest,indent=2))
print("Saved",len(manifest),"unique owned assets; every response role retained")
PY_ASSETS

Recibir y guardar resultados

Ailoot Ultra · Vídeo

GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Conserva todos los resultados completados

Guarda todos los vídeos completados o archivos recibidos; descarga cada URL de archivo que se haya devuelto.

Conserva la respuesta completa y sus cabeceras, los identificadores originales, todos los resultados reales y todos los campos de uso y contabilidad. Guarda cada recurso único bajo tu titularidad y conserva todas las funciones que apuntan a él.

Si es necesario revisar la respuesta original

Conserva el id público devuelto de la tarea u operación y todas las cabeceras. Consulta únicamente la tarea original; unknown o result_pending_check no autorizan otra creación.

Campos de respuesta

Campo	Tipo
Campo`id`	Tipostring
Campo`polling_url`	Tipostring
Campo`provider_task_id`	Tipostring
Campo`task_id`	Tipostring
Campo`status`	Tipostring
Campo`video_url`	Tipostring

Alias

Alias del modelo

Ailoot Ultra minimaxi-hailuo-02

Alias de rutas de métodos

/v1/videos/generations

ID de modelo relacionados

minimaxi-hailuo-02

FAQ · MiniMax: Hailuo 02

¿Qué entradas y resultados están disponibles?: POST /v1/videos · minimaxi-hailuo-02: text, image → video
¿Qué campos utiliza la solicitud?: POST /v1/videos · minimaxi-hailuo-02: model, prompt, duration, end_image, image, resolution

MiniMax: Hailuo 02