Minimax H3 Text-to-Video
- Genera vídeo desde un prompt de texto no vacío
- Duración de salida:
5–15segundos; actualmente solo2k - No admite entradas de imagen, vídeo ni audio
- Procesamiento asíncrono; consulta la tarea con su ID
- Las URL generadas son válidas durante 24 horas
Autorizaciones
##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
Nombre del modelo de generacion de video
minimax-h3-text-to-video "minimax-h3-text-to-video"
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
500caracteres chinos o1000palabras 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_urlsniaudio_urls - Enviar cualquiera de estos campos multimedia devuelve un error de parámetro
1"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."
Duración del vídeo de salida en segundos. El valor predeterminado es 5 segundos.
Restricciones de valor:
- Solo se admiten enteros de
5a15, ambos inclusive - No se admiten decimales, cadenas numéricas,
autoni-1 - La duración de salida afecta directamente a la facturación
5 <= x <= 155
Resolución del vídeo de salida. El valor predeterminado es 2k.
Valor disponible:
2k: la única resolución admitida actualmente
Notas:
768paú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
2k "2k"
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 prompt21:9: ultraancha16:9: horizontal4:3: horizontal estándar1:1: cuadrada3:4: vertical estándar9:16: vertical
adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 "adaptive"
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
2048caracteres
Mecanismo de callback:
- Tiempo de espera:
10segundos - Maximo
3reintentos despues del fallo (reintentos a los1/2/4segundos 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
^https://"https://your-domain.com/webhooks/video-task-completed"
Respuesta
Tarea de generacion de video creada exitosamente
Marca de tiempo de creacion de la tarea
1761313744
ID de la tarea
"task-unified-1774857405-abc123"
Nombre del modelo utilizado
"minimax-h3-text-to-video"
Tipo especifico de la tarea
video.generation.task Porcentaje de progreso de la tarea (0-100)
0 <= x <= 1000
Estado de la tarea
pending, processing, completed, failed "pending"
Informacion detallada de la tarea de video
Tipo de salida de la tarea
text, image, audio, video "video"
Informacion de uso y facturacion