Minimax H3 Reference-to-Video

curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "minimax-h3-reference-to-video",
  "prompt": "Usar a la persona de Image 1 como única referencia del personaje, conservando su rostro, peinado y ropa. El personaje camina contra el viento por un paseo marítimo mientras la cámara lo sigue suavemente desde un plano medio hasta un primer plano lateral, a contraluz del atardecer.",
  "image_urls": [
    "https://cdn.hailuoai.com/prod/hailuo_demo/testsets/H3_AA_I2VA/gallery/sr_v17_variants_seed42_43_20260724/inputs/4a3a90bf9100_KDmcbkhzYo5sjjxr9FqcVmWVnzb.png"
  ],
  "duration": 4,
  "quality": "768p",
  "aspect_ratio": "adaptive"
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "minimax-h3-reference-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 model: minimax-h3-reference-to-video",
    "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"
  }
}

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-reference-to-video",
  "prompt": "Usar a la persona de Image 1 como única referencia del personaje, conservando su rostro, peinado y ropa. El personaje camina contra el viento por un paseo marítimo mientras la cámara lo sigue suavemente desde un plano medio hasta un primer plano lateral, a contraluz del atardecer.",
  "image_urls": [
    "https://cdn.hailuoai.com/prod/hailuo_demo/testsets/H3_AA_I2VA/gallery/sr_v17_variants_seed42_43_20260724/inputs/4a3a90bf9100_KDmcbkhzYo5sjjxr9FqcVmWVnzb.png"
  ],
  "duration": 4,
  "quality": "768p",
  "aspect_ratio": "adaptive"
}
'

{
  "created": 1761313744,
  "id": "task-unified-1774857405-abc123",
  "model": "minimax-h3-reference-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 model: minimax-h3-reference-to-video",
    "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>

predeterminado:minimax-h3-reference-to-video

requerido

Nombre del modelo de generacion de video

Opciones disponibles:

minimax-h3-reference-to-video

Ejemplo:

"minimax-h3-reference-to-video"

prompt

string

requerido

Describe cómo deben utilizarse los recursos de referencia y el vídeo que quieres generar.

Requisitos del prompt:

Es obligatorio y no puede estar vacío
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

Reglas para referenciar recursos:

Usa Image 1, Image 2, Video 1, Audio 1, etc.; no uses etiquetas de Seedance como @image1 o @video1
La numeración comienza en 1 y sigue el orden de cada matriz de URL
El primer elemento de image_urls es Image 1, el primero de video_urls es Video 1 y el primero de audio_urls es Audio 1

Restricciones de entrada:

No se admiten image_start ni image_end
Proporciona al menos 1 recurso de referencia: imagen, vídeo o audio; el audio de referencia puede usarse por sí solo

Required string length: 1 - 7000

Ejemplo:

"Sustituir a la persona de Video 1 por el personaje de Image 1, conservando su rostro, peinado y ropa. Mantener el movimiento, el ritmo, la composición y la cámara de Video 1, e interpretar el diálogo con la voz de Audio 1 sincronizando los labios."

image_urls

string<uri>[]

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 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>[]

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 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>[]

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 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

predeterminado:4

Duración del vídeo de salida en segundos. El valor predeterminado es 4 segundos.

Restricciones de valor:

Solo se admiten enteros de 4 a 15, ambos inclusive
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:

4

quality

enum<string>

predeterminado:768p

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

Valores disponibles:

768p: valor predeterminado
2k

Notas:

Si se omite el parámetro, la salida es 768p; para 2K hay que enviar quality="2k" de forma explícita
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:

768p,

2k

Ejemplo:

"768p"

aspect_ratio

enum<string>

predeterminado:adaptive

Relación de aspecto del vídeo de salida. El valor predeterminado es adaptive.

Valores disponibles:

adaptive: 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:

"adaptive"

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

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-reference-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

Minimax H3 Reference-to-Video

Autorizaciones

Cuerpo

Respuesta