MiniMax-H3 API

Utilice el ID de modelo exacto MiniMax-H3. El campo del modelo debe coincidir exactamente con esta página.

Salida de muestraMiniMax-H3POST /v1/videos5.2s

Parámetros: duration=5resolution=2Kratio=16:9

Prompt: A fleet of hot-air balloons drifts over mist-filled mountain valleys at dawn. Aerial camera glides slowly between the balloons as golden light breaks over the ridges and fog rolls through the pines below. Calm, majestic, photoreal landscape, steady motion, no text.

Solicitud que produjo esta muestra

{
  "model": "MiniMax-H3",
  "prompt": "A fleet of hot-air balloons drifts over mist-filled mountain valleys at dawn. Aerial camera glides slowly between the balloons as golden light breaks over the ridges and fog rolls through the pines below. Calm, majestic, photoreal landscape, steady motion, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "2K",
  "ratio": "16:9",
  "aspect_ratio": "16:9"
}

Autenticación y punto final

Utilice una clave API de Modelflare con https://modelflare.dev/v1. El punto de entrada de la puerta de enlace es POST /v1/videos.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Crear una tarea

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "content": [{"type": "text", "text": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot"}],
    "resolution": "2K", "duration": 5, "ratio": "16:9"
  }'

Encuesta y descarga

Guardar el ID de la tarea. Sondear GET /v1/videos/{task_id} y descargar con GET /v1/videos/{task_id}/content. Las URL de resultados pueden caducar, así que transfiera el archivo lo antes posible.

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Solicitar notas

MiniMax-H3 usa content[] con resolution, duration y ratio controlando la salida.

Solicitar parámetros

MiniMax-H3 utiliza un arreglo multimodal content[]. Sondear la ruta de consulta MiniMax después de la creación de la tarea; Las funciones first_frame/last_frame y reference_* son flujos de trabajo distintos.

Campo	Requerido	Notas
model	Sí	MiniMax-H3
content[]	Sí	Exactamente un ítem text; puede incluir first_frame, last_frame, reference_image, reference_video o reference_audio
resolution	Sí	768P / 2K
duration	Sí	4–15 segundos
ratio	Condicional	21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive
content[].role	Condicional	Utilice first_frame / last_frame para imagen a video y reference_* para flujos de trabajo de referencia; no mezclar los grupos
content[].url	No	Se requiere URL HTTP/HTTPS pública; Los medios Base64 no son compatibles
aigc_watermark	No	Si se debe agregar una marca de agua
callback_url	No	URL de devolución de llamada del estado de la tarea

Límites de entrada y salida

La salida es 768P o 2K durante 4 a 15 segundos. Las solicitudes de solo texto necesitan un ratio concreto; La conversión de imagen a video permite un primer cuadro y un último cuadro, mientras que los flujos de trabajo de referencia requieren al menos una imagen o video de referencia y no pueden usar audio solo. No mezcle los dos grupos de roles.

Ejemplos de flujos de trabajo documentados

MiniMax-H3 las URL de medios deben ser de acceso público y no pueden utilizar Base64; Los flujos de trabajo de primer/final fotograma y de referencia no se deben mezclar.

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "content": [
      {"type": "text", "text": "让图像主体沿视频动作自然移动"},
      {"type": "reference_image", "role": "reference_image", "url": "https://example.com/subject.png"},
      {"type": "reference_video", "role": "reference_video", "url": "https://example.com/motion.mp4"}
    ],
    "resolution": "2K", "duration": 5, "ratio": "16:9"
  }'

Errores y tareas fallidas

Los parámetros del modelo no válidos devuelven un 4xx con un ID de solicitud. Una tarea asincrónica también puede fallar después de que la creación sea exitosa; utilice error_code y error_message de la respuesta de la encuesta como motivo final de la tarea. No vuelva a intentar la misma solicitud con una forma JSON diferente.

Alcance soportado

Esta página cubre las llamadas de generación y edición de modelos de Modelflare. El enriquecimiento de mapas o búsquedas, la administración de voz y la administración de bibliotecas de elementos son API de recursos fuera de esta superficie pública de llamada de modelo y no son campos de solicitud obligatorios.

Precios y facturación

Este modelo utiliza facturación de video por segundo. Consulte la página de precios de modelos para conocer el precio actual para el cliente, el precio de lista de referencia y las especificaciones completas.

Nota

Esta página documenta la interfaz pública de Modelflare; Los campos y límites que se muestran aquí son el contrato actual.

Variantes

ID del modelo	Diferencia
MiniMax-H3	El modelo documentado en esta página.