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": 5,
  "quality": "2k",
  "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": 8
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 50,
    "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": 5,
  "quality": "2k",
  "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": 8
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_second",
    "credits_reserved": 50,
    "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
Se recomiendan como máximo 500 caracteres chinos o 1000 palabras en inglés; 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 imagen de referencia o 1 vídeo de referencia; el audio de referencia no puede utilizarse por sí solo

Minimum string length: 1

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 1 imagen de referencia o 1 vídeo de referencia
Enviar solo audio_urls devuelve un error de parámetro

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 1 imagen de referencia o 1 vídeo de referencia
Enviar solo audio_urls devuelve un error de parámetro

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

Reglas de combinación:

El audio de referencia no puede utilizarse solo
Al usar audio_urls, proporciona también al menos 1 imagen de referencia o 1 vídeo de referencia

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

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

Restricciones de valor:

Solo se admiten enteros de 5 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: 5 <= x <= 15

Ejemplo:

5

quality

enum<string>

predeterminado:2k

Resolución del vídeo de salida. El valor predeterminado es 2k.

Valor disponible:

2k: la única resolución admitida actualmente

Notas:

768p aún no está disponible y devuelve un error de parámetro
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:

2k

Ejemplo:

"2k"

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
21:9: ultraancha
16:9: horizontal
4:3: horizontal estándar
1:1: cuadrada
3:4: vertical estándar
9:16: vertical

Opciones disponibles:

adaptive,

21:9,

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

Minimax H3 Image-to-Video Kling Elemento personalizado

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