Skip to main content
POST

Autorización

string
requerido
Todos los endpoints de la API requieren autenticación mediante Bearer TokenObtenga su API Key:Visite la página de gestión de API Keys para obtener su API KeyAñádala al encabezado de la solicitud:

Parámetros de la solicitud

string
requerido
Modelos soportados:
  • MiniMax-Hailuo-2.3 - Hailuo 2.3
  • MiniMax-Hailuo-2.3-Fast - Hailuo 2.3 Fast (menor latencia)
MiniMax-Hailuo-2.3-Fast:
Con este modelo, first_frame_image es obligatorio.
boolean
predeterminado:"false"
Indica si se debe moderar el contenido antes de enviar la tarea de vídeo.
  • true: revisar los prompts y las imágenes de entrada con omni-moderation-latest
  • false u omitido: no enviar una solicitud de moderación, sin coste ni latencia de moderación adicionales (predeterminado)
string
requerido
Descripción del contenido del video (máximo 2000 caracteres)Describa escenas, acciones y estilos en detalle para obtener mejores resultados. Admite comandos de movimiento de cámara (consulte los Comandos de movimiento de cámara más abajo).Ejemplo: "A cute kitten running on the grass"
integer
predeterminado:"6"
Duración del video (segundos)Opciones:
  • 6 - Video de 6 segundos
  • 10 - Video de 10 segundos
Por defecto: 6
Limitación de 1080p: Al usar resolución 1080p, solo se admite la duración de 6 segundos
string
predeterminado:"768p"
Resolución del videoOpciones:
  • 768p - Alta definición
  • 1080p - Full HD (solo admite duración de 6 segundos)
Por defecto: 768p
string
Imagen del primer fotograma del videoAdmite dos formatos:
  • URL pública: https://example.com/start.jpg
  • Codificación Base64: data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
Cuando se proporciona, esta imagen se utilizará como fotograma inicial del video
MiniMax-Hailuo-2.3-Fast:
Con este modelo, first_frame_image es obligatorio.
boolean
predeterminado:"true"
Si se debe optimizar el prompt automáticamenteCuando está activado, el sistema optimizará automáticamente su prompt para obtener mejores resultadosPor defecto: true
boolean
predeterminado:"false"
Si se debe acortar el tiempo de optimización del promptCuando está activado, la velocidad de procesamiento es más rápida, pero la calidad de la optimización puede verse ligeramente afectadaPor defecto: false
boolean
predeterminado:"false"
Si se debe añadir una marca de aguaPor defecto: false

Combinaciones de resolución y duración

Comandos de movimiento de cámara

Use la sintaxis [comando] en el prompt para controlar los movimientos de cámara. Se admiten 15 comandos: Ejemplo de uso:

Respuesta

integer
Código de estado de la respuesta, 200 en caso de éxito
array
Array de datos de la respuesta

Casos de uso

Caso 1: Texto a video rápido

Caso 2: Video 1080p de alta calidad

Caso 3: Imagen a video con primer fotograma

Caso 4: Comandos de movimiento de cámara

Caso 5: Modo de pretratamiento rápido

Consultar resultados de la tareaLa generación de video es una tarea asíncrona que devuelve un task_id al enviarse. Use el endpoint Obtener estado de la tarea para consultar el progreso y los resultados de la generación.