Minimax H3 Image-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-image-to-video",
  "prompt": "Cambiar lentamente el enfoque desde el bol de ramen en primer plano hacia las personas del fondo. Sale más vapor de forma natural mientras la cámara avanza suavemente; conservar la identidad de los personajes y el entorno del restaurante.",
  "image_start": "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-image-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-image-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-image-to-video",
  "prompt": "Cambiar lentamente el enfoque desde el bol de ramen en primer plano hacia las personas del fondo. Sale más vapor de forma natural mientras la cámara avanza suavemente; conservar la identidad de los personajes y el entorno del restaurante.",
  "image_start": "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-image-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-image-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-image-to-video

requerido

Nombre del modelo de generacion de video

Opciones disponibles:

minimax-h3-image-to-video

Ejemplo:

"minimax-h3-image-to-video"

prompt

string

requerido

Describe el movimiento de la imagen de entrada, los cambios de cámara y el contenido del 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

Restricciones de entrada:

Usa image_start y/o image_end para proporcionar fotogramas clave
No se admiten image_urls, video_urls ni audio_urls; enviarlos devuelve un error de parámetro

Minimum string length: 1

Ejemplo:

"Cambiar lentamente el enfoque desde el bol de ramen en primer plano hacia las personas del fondo. Sale más vapor de forma natural mientras la cámara avanza suavemente; conservar la identidad de los personajes y el entorno del restaurante."

image_start

string<uri>

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>

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"

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, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16

Comportamiento de imagen a vídeo:

La relación real viene determinada por la imagen de entrada
Se acepta otro valor válido, pero se ignora y se trata como adaptive
Un valor fuera de la enumeración devuelve un error de parámetro

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-image-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 Text-to-Video Minimax H3 Reference-to-Video

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 Image-to-Video

Autorizaciones

Cuerpo

Respuesta