MiniMax H3 Max Turbo API

Generación rápida de video con audio nativo, con entrenamiento adicional de fal a partir de MiniMax H3

480p
FAL 0,025 $ / segundo
768p
FAL 0,04 $ / segundo

Comparar precios

Compara los precios públicos de los proveedores para la misma especificación de salida

Comparar otros modelos
Especificación de salidaProveedoresPrecio publicado del proveedorTiempo típicoProbar
480p
FALOficial
0,025 $ / segundo
Probar
768p
FALOficial
0,04 $ / segundo
Probar
Notas de precios

Se cobra según el proveedor que realmente ejecuta la tarea. El failover puede cambiar de proveedor, lo que puede modificar el costo y el tiempo.

Usar la API

Deja el código a un agente de programación, genera en el chat con MCP o la Skill, o intégralo tú mismo con el SDK o la API compatible con OpenAI.

Deja que un agente de programación lo integre

Copia el prompt de integración o ábrelo directamente en Codex o Claude. El agente lee esta página y el contrato del modelo, y luego escribe en tu proyecto el envío, la espera y el manejo de resultados.

Añade el servidor MCP de Yir

Conéctalo a ChatGPT, Claude o Cursor, menciona @Yir y pide MiniMax H3 Max Turbo por su nombre. Primero te da el precio y solo genera cuando confirmas.

https://gateway.yir.ai/mcp
Pasos para cada cliente

Un comando para Claude Code

Crea una API key en la consola, guárdala como YIR_API_KEY y ejecuta:

claude mcp add --transport http yir https://gateway.yir.ai/mcp --header "Authorization: Bearer $YIR_API_KEY"

Instala la Skill de Yir

Define YIR_API_KEY donde se ejecuta tu agente, añade la Skill a Claude Code, Codex u otro agente de programación y di “usa MiniMax H3 Max Turbo en Yir para crear…”.

npx skills add yir-ai/skills
Sobre la Skill de Yir

Instala el SDK oficial con tu gestor de paquetes o copia el fragmento de código de abajo para empezar

$pnpm add @yir-ai/sdk
import { createNodeYirClient } from "@yir-ai/sdk/server";
 
// Lee YIR_API_KEY del entorno por defecto: process.env.YIR_API_KEY
const client = createNodeYirClient();
 
// 1. Envía una tarea de generación de video
const job = await client.submitVideo({
model: "minimax/h3-max-turbo",
input: {
type: "text",
prompt: "Una tortuga marina nada despacio sobre un arrecife de coral. La cámara la sigue suavemente de lado mientras la luz del sol atraviesa el agua clara y proyecta reflejos en movimiento sobre su caparazón",
},
parameters: {
duration: 5,
resolution: "768P",
aspect_ratio: "16:9",
generate_audio: true,
n: 1,
},
});
 
// 2. Espera a que la tarea termine y entregue el resultado
const result = await client.waitForJob(job.id);
console.log("Archivos entregados:", result.result);
if (result.result && "files" in result.result) {
for (const file of result.result.files) {
console.log("->", file.url);
}
}

Los proyectos que ya usan el protocolo de OpenAI, o gateways como new-api, solo necesitan una nueva Base URL y una nueva clave. Guía de compatibilidad con OpenAI

base_url del SDK de OpenAI
https://gateway.yir.ai/openai/v1
Base URL del canal en new-api
https://gateway.yir.ai/openai
Clave
API Key de Yir
ID del modelo
minimax/h3-max-turbo
curl https://gateway.yir.ai/openai/v1/videos \
  -H "Authorization: Bearer $YIR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax/h3-max-turbo",
    "prompt": "Una tortuga marina nada despacio sobre un arrecife de coral. La cámara la sigue suavemente de lado mientras la luz del sol atraviesa el agua clara y proyecta reflejos en movimiento sobre su caparazón",
    "resolution": "768P",
    "aspect_ratio": "16:9",
    "seconds": "5"
  }'

Resumen de parámetros

Parámetros comunes; los límites dependen del modelo actual y del proveedor seleccionado

Documentación de la API
Resolución
resolution
  • 480p
  • 768P

Nivel de resolución de salida. Las resoluciones más altas dan mayor nitidez y el precio aumenta en consecuencia

Relación de aspecto
aspect_ratio
  • 21:9
  • 16:9
  • 4:3
  • 1:1
  • 3:4
  • 9:16

Proporción geométrica. Elígela según el medio de destino (vertical, banner o cuadrado)

Modo de entrada
input_mode
  • Entrada de texto
  • Entrada de imagen

Los límites y formatos de las referencias dependen del modelo y del proveedor seleccionado

Duración
duration
  • 5–15 segundos

Nivel de duración del video de salida, cobrado por segundo o por tramos

Audio
generate_audio
  • Siempre incluido

Este modo de entrada siempre genera video con audio; no se puede desactivar

Referencias
references
  • first_frame ≤ 1
  • last_frame ≤ 1

Los límites por modo dependen del proveedor elegido. Las cantidades de la tabla son ejemplos de precio, no límites ni cuotas gratuitas.

Preguntas frecuentes

Empieza a crear con MiniMax H3 Max Turbo

Compara la misma especificación entre proveedores y llama a varios proveedores desde una sola billetera.