curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "minimax-h3-text-to-video",
  "prompt": "Tráiler épico de ópera espacial: una capitana permanece sola ante una enorme ventana de observación mientras la última flota se reúne en el exterior. Cuando la flota salta, estalla una luz blanca cegadora y el puente se sacude violentamente; al desaparecer la luz, ella queda sola en el silencio del espacio profundo. Iluminación cinematográfica, lento avance de cámara y una atmósfera grandiosa pero contenida.",
  "duration": 4,
  "quality": "768p",
  "aspect_ratio": "16:9"
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "minimax-h3-text-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 165,
    "video_duration": 4
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 44.2,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to the specified model",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Minimax H3

Guía completa de parámetros de Minimax H3 / H3 Max

API unificada para toda la serie Minimax H3 y H3 Max. Selecciona el modo de generación con el parámetro model.

3 modos de generación, 5 modelos:

Modo	ID del modelo	Recursos de entrada
Text-to-Video	`minimax-h3-text-to-video`	Solo `prompt`
Text-to-Video	`minimax-h3-max-text-to-video`	Solo `prompt`
Image-to-Video	`minimax-h3-image-to-video`	`prompt` + `image_start` y/o `image_end`
Image-to-Video	`minimax-h3-max-image-to-video`	`prompt` + `image_start` y/o `image_end`
Reference-to-Video	`minimax-h3-reference-to-video`	`prompt` + `image_urls` / `video_urls` / `audio_urls`

Diferencias de parámetros:

Minimax H3: duración de salida de 4 a 15 segundos; resolución 768p (predeterminada) o 2k
Minimax H3 Max: duración de salida de 5 a 15 segundos; resolución 480p o 768p (predeterminada)

Capacidades comunes:

Procesamiento asíncrono; utiliza el ID de tarea devuelto para consultar la tarea
Las tareas de Minimax H3 y H3 Max no se pueden cancelar
Las URL de los vídeos generados son válidas durante 24 horas; guarda el resultado cuanto antes

POST

videos

generations

curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "minimax-h3-text-to-video",
  "prompt": "Tráiler épico de ópera espacial: una capitana permanece sola ante una enorme ventana de observación mientras la última flota se reúne en el exterior. Cuando la flota salta, estalla una luz blanca cegadora y el puente se sacude violentamente; al desaparecer la luz, ella queda sola en el silencio del espacio profundo. Iluminación cinematográfica, lento avance de cámara y una atmósfera grandiosa pero contenida.",
  "duration": 4,
  "quality": "768p",
  "aspect_ratio": "16:9"
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "minimax-h3-text-to-video",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": false,
    "estimated_time": 165,
    "video_duration": 4
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 44.2,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to the specified model",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Autorizaciones

Authorization

string

header

requerido

##Todas las interfaces requieren autenticacion mediante Bearer Token##

Obtener API Key:

Visite la Pagina de gestion de API Key para obtener su API Key

Agregue en el encabezado de la solicitud al usar:

Authorization: Bearer YOUR_API_KEY

Cuerpo

application/json

model

enum<string>

requerido

Nombre del modelo de generación de vídeo.

ID del modelo	Modo	Parámetros multimedia
`minimax-h3-text-to-video`	Texto a vídeo	No acepta recursos multimedia
`minimax-h3-max-text-to-video`	Texto a vídeo	No acepta recursos multimedia
`minimax-h3-image-to-video`	Imagen a vídeo	`image_start` y/o `image_end`
`minimax-h3-max-image-to-video`	Imagen a vídeo	`image_start` y/o `image_end`
`minimax-h3-reference-to-video`	Referencia multimodal a vídeo	`image_urls` / `video_urls` / `audio_urls`

Opciones disponibles:

minimax-h3-text-to-video,

minimax-h3-max-text-to-video,

minimax-h3-image-to-video,

minimax-h3-max-image-to-video,

minimax-h3-reference-to-video

Ejemplo:

"minimax-h3-text-to-video"

prompt

string

requerido

Describe el vídeo que quieres generar. Este campo es obligatorio y no puede estar vacío.

Requisitos del prompt:

Se admiten chino e inglés
Longitud máxima: 7000 caracteres (tanto el chino como el inglés se cuentan por caracteres)
Un prompt demasiado largo puede hacer que el modelo omita algunos detalles

Uso según el modelo:

Text-to-Video: Describe la escena, el sujeto, la acción, la cámara y la atmósfera; no envíes campos multimedia
Image-to-Video: Describe cómo deben moverse los sujetos del primer/último fotograma y cómo debe cambiar la cámara; utiliza image_start y/o image_end
Reference-to-Video: Describe cómo usar los recursos de referencia. Haz referencia a ellos como Image 1, Image 2, Video 1, Audio 1, etc.; no uses nombres de estilo Seedance como @image1 o @video1. La numeración empieza en 1 y sigue el orden de cada matriz de URL

Required string length: 1 - 7000

Ejemplo:

"Escena cinematográfica: un astronauta permanece ante la ventana de observación de una base lunar mientras la cámara avanza lentamente y la Tierra aparece sobre el horizonte lejano."

image_start

string<uri>

Modelos aplicables:

minimax-h3-image-to-video
minimax-h3-max-image-to-video
Los modelos de texto a vídeo y de referencia a vídeo no admiten este parámetro

URL HTTP(S) de la imagen del primer fotograma.

Reglas de combinación:

Proporciona al menos uno de image_start e image_end
Solo image_start: generación desde el primer fotograma
Ambos campos: generación entre el primer y el último fotograma
Máximo 1 primer fotograma; este campo acepta una URL

Requisitos de imagen:

Formatos: JPG, JPEG, PNG, WEBP, HEIC, HEIF
Tamaño: máximo 30MB
Anchura y altura: de 256 a 5760 px cada una
Relación anchura/altura: 0.4–2.5
La URL debe usar HTTP(S) y ser accesible directamente por el servicio
El cuerpo JSON completo no debe superar 64MB; no se aceptan entradas Base64 ni mm_file://

Ejemplo:

"https://cdn.hailuoai.com/prod/hailuo_demo/testsets/H3_AA_I2VA/gallery/sr_v17_variants_seed42_43_20260724/inputs/4a3a90bf9100_KDmcbkhzYo5sjjxr9FqcVmWVnzb.png"

image_end

string<uri>

Modelos aplicables:

minimax-h3-image-to-video
minimax-h3-max-image-to-video
Los modelos de texto a vídeo y de referencia a vídeo no admiten este parámetro

URL HTTP(S) de la imagen del último fotograma.

Reglas de combinación:

Proporciona al menos uno de image_end e image_start
Solo image_end: el modelo genera un movimiento natural que termina en este fotograma
Ambos campos: generación entre el primer y el último fotograma
Máximo 1 último fotograma; este campo acepta una URL

Requisitos de imagen:

Formatos: JPG, JPEG, PNG, WEBP, HEIC, HEIF
Tamaño: máximo 30MB
Anchura y altura: de 256 a 5760 px cada una
Relación anchura/altura: 0.4–2.5
La URL debe usar HTTP(S) y ser accesible directamente por el servicio
El cuerpo JSON completo no debe superar 64MB; no se aceptan entradas Base64 ni mm_file://

Ejemplo:

"https://images.unsplash.com/photo-1515003197210-e0cd71810b5f?auto=format&fit=crop&w=1920&q=85"

image_urls

string<uri>[]

Modelos aplicables:

Solo minimax-h3-reference-to-video
Los modelos de texto a vídeo y de imagen a vídeo no admiten este parámetro

Matriz de URL HTTP(S) de imágenes de referencia. El valor predeterminado es []; máximo 9 imágenes.

Función y numeración:

Todas las imágenes se usan como reference_image
El primer elemento es Image 1, el segundo Image 2, etc.

Requisitos de imagen:

Formatos: JPG, JPEG, PNG, WEBP, HEIC, HEIF
Tamaño: máximo 30MB por imagen
Anchura y altura: de 256 a 5760 px cada una
Relación anchura/altura: 0.4–2.5
Las URL deben usar HTTP(S) y ser accesibles directamente por el servicio
El cuerpo JSON completo no debe superar 64MB; no se aceptan entradas Base64 ni mm_file://

Reglas de combinación:

Proporciona al menos uno de image_urls, video_urls o audio_urls
El total de los tres tipos de referencia no puede superar los 12 elementos (imágenes + vídeos + audios de referencia)
Si los tres están vacíos se devuelve un error de parámetro; usa minimax-h3-text-to-video o minimax-h3-max-text-to-video para generar solo con texto

Maximum array length: 9

Ejemplo:

[
  "https://cdn.hailuoai.com/prod/hailuo_demo/testsets/H3_AA_I2VA/gallery/sr_v17_variants_seed42_43_20260724/inputs/4a3a90bf9100_KDmcbkhzYo5sjjxr9FqcVmWVnzb.png"
]

video_urls

string<uri>[]

Modelos aplicables:

Solo minimax-h3-reference-to-video
Los modelos de texto a vídeo y de imagen a vídeo no admiten este parámetro

Matriz de URL HTTP(S) de vídeos de referencia. El valor predeterminado es []; máximo 3 vídeos.

Función y numeración:

Todos los vídeos se usan como reference_video
El primer elemento es Video 1, el segundo Video 2, etc.

Requisitos de vídeo:

Contenedores: MP4 (.mp4), MOV (.mov)
Códecs de vídeo: H.264/AVC, H.265/HEVC
Códecs de audio incluidos: AAC, MP3
Tamaño: máximo 50MB por vídeo
Duración: 2–15 segundos por clip; duración total de los vídeos de referencia de hasta 15 segundos
Anchura y altura: de 256 a 5760 px cada una
Relación anchura/altura: 0.4–2.5
Frecuencia de fotogramas: 23.976–60 FPS
Las URL deben usar HTTP(S) y ser accesibles directamente por el servicio
El cuerpo JSON completo no debe superar 64MB; no se aceptan entradas Base64 ni mm_file://

Facturación:

La duración de entrada de los vídeos de referencia es facturable

Reglas de combinación:

Proporciona al menos uno de image_urls, video_urls o audio_urls
El total de los tres tipos de referencia no puede superar los 12 elementos (imágenes + vídeos + audios de referencia)
Si los tres están vacíos se devuelve un error de parámetro; usa minimax-h3-text-to-video o minimax-h3-max-text-to-video para generar solo con texto

Maximum array length: 3

Ejemplo:

[
  "https://cdn.hailuoai.com/prod/hailuo_demo/testsets/h3_promo_eval_ref2va/gallery/sr_v2p26_trio_seed42_20260724/inputs/297573323635_00_%E8%A7%86%E9%A2%911_YnyRbxEwio_video_20260525_163755_1927e9d3.mp4"
]

audio_urls

string<uri>[]

Modelos aplicables:

Solo minimax-h3-reference-to-video
Los modelos de texto a vídeo y de imagen a vídeo no admiten este parámetro

Matriz de URL HTTP(S) de audios de referencia. El valor predeterminado es []; máximo 3 clips.

Función y numeración:

Todos los clips se usan como reference_audio
El primer elemento es Audio 1, el segundo Audio 2, etc.

Requisitos de audio:

Formatos: WAV, MP3
Tamaño: máximo 15MB por clip
Duración: 2–15 segundos por clip; duración total de los audios de referencia de hasta 15 segundos
Las URL deben usar HTTP(S) y ser accesibles directamente por el servicio
El cuerpo JSON completo no debe superar 64MB; no se aceptan entradas Base64 ni mm_file://

Facturación:

La duración del audio de referencia no se factura

Reglas de combinación:

audio_urls puede usarse por sí solo; no se requiere imagen ni vídeo de referencia
El total de los tres tipos de referencia no puede superar los 12 elementos (imágenes + vídeos + audios de referencia)
Si los tres están vacíos se devuelve un error de parámetro; usa minimax-h3-text-to-video o minimax-h3-max-text-to-video para generar solo con texto

Maximum array length: 3

Ejemplo:

[
  "https://cdn.hailuoai.com/prod/hailuo_demo/testsets/h3_promo_eval_ref2va/gallery/sr_v2p26_trio_seed42_20260724/inputs/f463d523c5ce_01_%E9%9F%B3%E9%A2%911_RSLcbpzJPo_6%E6%9C%885%E6%97%A5(1).mp3"
]

duration

integer

Duración del vídeo de salida en segundos. El intervalo de valores y el valor predeterminado dependen de model.

Modelos aplicables:

Los 5 modelos Minimax H3 y H3 Max

Restricciones por modelo:

Minimax H3: enteros de 4 a 15, ambos inclusive; valor predeterminado 4 segundos
Minimax H3 Max: enteros de 5 a 15, ambos inclusive; valor predeterminado 5 segundos
No se admiten decimales, cadenas numéricas, auto ni -1
La duración de salida afecta directamente a la facturación

Rango requerido: 4 <= x <= 15

Ejemplo:

5

quality

enum<string>

predeterminado:768p

Resolución del vídeo de salida. El valor predeterminado es 768p.

Modelos aplicables:

Los 5 modelos Minimax H3 y H3 Max

Valores disponibles por modelo:

Minimax H3: 768p (predeterminada), 2k
Minimax H3 Max: 480p, 768p (predeterminada)

Notas:

Si se omite el parámetro, la salida es 768p
La plataforma determina la tasa de bits, la frecuencia de fotogramas y los códecs de vídeo y audio; no se pueden configurar

Opciones disponibles:

480p,

768p,

2k

Ejemplo:

"768p"

aspect_ratio

enum<string>

Relación de aspecto del vídeo de salida.

Modelos aplicables y valores predeterminados:

minimax-h3-text-to-video, minimax-h3-max-text-to-video: solo relaciones de aspecto explícitas; valor predeterminado 16:9
minimax-h3-reference-to-video: admite todas las opciones siguientes; valor predeterminado adaptive
minimax-h3-image-to-video, minimax-h3-max-image-to-video: el modelo adapta automáticamente la relación de aspecto del vídeo de salida a la imagen de entrada; no envíes este parámetro en solicitudes de imagen a vídeo

Valores disponibles:

adaptive: solo para referencia a vídeo; el modelo selecciona una relación adecuada a partir de los recursos de referencia y el prompt
16:9: Horizontal
21:9: Ultraancha
4:3: Horizontal estándar
1:1: Cuadrada
3:4: Vertical estándar
9:16: Vertical

Opciones disponibles:

adaptive,

16:9,

21:9,

4:3,

1:1,

3:4,

9:16

Ejemplo:

"16:9"

callback_url

string<uri>

Direccion de callback HTTPS despues de completar la tarea

Momento del callback:

Se activa cuando la tarea se completa (completed) o falla (failed)
Se envia despues de confirmar la facturacion

Restricciones de seguridad:

Solo admite protocolo HTTPS
Prohibido el callback a direcciones IP de red interna (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
La longitud de la URL no debe exceder 2048 caracteres

Mecanismo de callback:

Tiempo de espera: 10 segundos
Maximo 3 reintentos despues del fallo (reintentos a los 1/2/4 segundos despues del fallo)
El formato del cuerpo de respuesta del callback es consistente con el formato de retorno de la interfaz de consulta de tareas
Un codigo de estado 2xx se considera exitoso, otros codigos de estado activan reintentos

Modelos aplicables:

Los 5 modelos Minimax H3 y H3 Max

Pattern: ^https://

Ejemplo:

"https://your-domain.com/webhooks/video-task-completed"

Respuesta

Tarea de generacion de video creada exitosamente

created

integer

Marca de tiempo de creacion de la tarea

Ejemplo:

1761313744

string

ID de la tarea

Ejemplo:

"task-unified-1774857405-abc123"

model

string

Nombre del modelo utilizado

Ejemplo:

"minimax-h3-text-to-video"

object

enum<string>

Tipo especifico de la tarea

Opciones disponibles:

video.generation.task

progress

integer

Porcentaje de progreso de la tarea (0-100)

Rango requerido: 0 <= x <= 100

Ejemplo:

0

status

enum<string>

Estado de la tarea

Opciones disponibles:

pending,

processing,

completed,

failed

Ejemplo:

"pending"

task_info

object

Informacion detallada de la tarea de video

Show child attributes

type

enum<string>

Tipo de salida de la tarea

Opciones disponibles:

text,

image,

audio,

video

Ejemplo:

"video"

usage

object

Informacion de uso y facturacion

Show child attributes

Serie de imágenes

Serie de videos

Serie de audio

Serie de texto

Gestión de cuenta

Gestión de tareas

Gestión de archivos

Guía completa de parámetros de Minimax H3 / H3 Max

Autorizaciones

Cuerpo

Respuesta