Skip to main content
POST
Minimax H3 Text-to-Video

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:

Cuerpo

application/json
model
enum<string>
predeterminado:minimax-h3-text-to-video
requerido

Nombre del modelo de generacion de video

Opciones disponibles:
minimax-h3-text-to-video
Ejemplo:

"minimax-h3-text-to-video"

prompt
string
requerido

Describe 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

Restricciones de entrada:

  • Este modelo genera vídeo únicamente a partir de texto
  • No admite image_start, image_end, image_urls, video_urls ni audio_urls
  • Enviar cualquiera de estos campos multimedia devuelve un error de parámetro
Minimum string length: 1
Ejemplo:

"Tráiler cinematográfico de ópera espacial épica: una capitana permanece sola ante una enorme ventana de observación mientras la última flota se reúne en el exterior. La flota salta entre un destello cegador y el puente tiembla; cuando la luz se desvanece, ella queda sola en el silencio del espacio profundo. Iluminación cinematográfica, lento avance de cámara, atmósfera grandiosa pero contenida."

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

id
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

type
enum<string>

Tipo de salida de la tarea

Opciones disponibles:
text,
image,
audio,
video
Ejemplo:

"video"

usage
object

Informacion de uso y facturacion