Respuesta rápida
- minimax-h3-max admite Text-to-Video, Image-to-Video, R2V y Video Edit en un solo flujo.
- Use esta página de guía del modelo para validar parámetros con ejemplos mínimos de solicitud y respuesta.
- Estabilice primero los prompts aquí y después pase a la integración con la API de producción.
Parámetros clave
- model | string | obligatorio | MiniMax-H3-Max | - | Identificador del modelo. Use el valor fijo `MiniMax-H3-Max`.
- prompt | string | obligatorio | - | - | Instrucción principal que describe el sujeto, la acción, la escena y el estilo.
- aspect_ratio | string | opcional | 16:9 | 16:9 | 9:16 | 1:1 | 4:3 | 3:4 | 21:9 | adaptive | Relación de aspecto del vídeo. Por defecto `16:9`; admite `16:9 | 9:16 | 1:1 | 4:3 | 3:4 | 21:9 | adaptive`.
- duration | integer | opcional | 5 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | Duración de salida en segundos. Valor predeterminado `5`; admite `5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15`.
- resolution | string | opcional | 480P | 480P | 768P | 1080P | Resolución de salida. Valor predeterminado `480P`; admite `480P | 768P | 1080P`.
Errores comunes
- 400 invalid_request_error: disparador=El payload de la solicitud no incluye campos obligatorios o tiene tipos de campo no válidos.; solución=Valide model, mode y el esquema de input antes de enviar.; reintento=Reintente solo después de corregir el payload; evite reintentos ciegos.
- 401 authentication_error: disparador=Falta la cabecera Authorization o la clave de API no es válida.; solución=Verifique el formato del token Bearer y el ámbito de la clave de API.; reintento=Reintente después de corregir la autenticación; rote la clave si los fallos se repiten.
- 429 rate_limit_exceeded: disparador=La frecuencia de solicitudes, la concurrencia o la cuota actual activan el límite del proveedor.; solución=Aplique primero un retroceso exponencial y luego revise el ritmo de solicitudes, la concurrencia y el uso de la cuota.; reintento=Use retroceso exponencial (por ejemplo, 1s/2s/4s) con jitter; si persiste, reduzca la presión de envío.
- 500 internal_error: disparador=Error transitorio del proveedor o fallo interno de procesamiento.; solución=Registre el request id y active el flujo de reintentos.; reintento=Reintente de 2 a 3 veces con intervalos cortos; escale si el problema persiste.







