Acceso a la API de MiniMax con un solo router compatible con OpenAI

Acceso a la API de MiniMax con un solo router compatible con OpenAI es útil cuando tu equipo quiere MiniMax en el mismo flujo de trabajo de producción que el resto de tu stack de IA. La ruta directa de MiniMax ya es compatible con el SDK de OpenAI para los modelos de lenguaje admitidos. Una ruta de router añade una única URL base compartida, una capa de claves, una verificación de catálogo, un registro de uso y un solo lugar para decidir qué cargas de trabajo de MiniMax deben coexistir junto a GPT, Claude, Gemini, DeepSeek, Qwen, Seedance, Veo y otras rutas de modelos.

Esta actualización se comprobó el 16 de septiembre de 2026 frente a la documentación oficial de la API de MiniMax, los precios de pago por uso de MiniMax, la documentación pública de Flatkey, el directorio de modelos de Flatkey y las páginas de modelos de MiniMax de Flatkey. Trata cada modelo, precio y estado de ruta como una instantánea pública fechada. Vuelve a revisar tu cuenta, catálogo y condiciones antes de enviar tráfico de producción.

La versión corta: usa MiniMax directo cuando solo necesites acceso a la cuenta de MiniMax. Usa Flatkey cuando MiniMax deba evaluarse, presupuestarse, registrarse y revertirse dentro de un flujo de trabajo de router multi-proveedor.

Respuesta rápida: acceso a la API de MiniMax con un solo router compatible con OpenAI

Si tu aplicación ya usa el SDK de OpenAI para Python o JavaScript, MiniMax tiene dos rutas prácticas de acceso:

Usa esta guía de Acceso a la API de MiniMax con un solo router compatible con OpenAI como lista de comprobación de lanzamiento. No apruebes la migración solo porque funcionó una respuesta de ejemplo. Apruébala cuando el ID exacto del modelo, el endpoint, la forma de la solicitud, la unidad de precio, el registro de uso, la regla de respaldo y la ruta de reversión sean visibles.

Qué cambió desde el artículo anterior sobre MiniMax

El artículo público anterior estaba fechado el 16 de junio de 2026. La actualización segura no es una reescritura cosmética. MiniMax y Flatkey cambiaron lo suficiente como para que el artículo necesite un lenguaje de ruta actualizado.

Las actualizaciones clave son:

• MiniMax ahora documenta MiniMax-M3 como el modelo de lenguaje más reciente compatible con el SDK de OpenAI de la serie M, con una ventana de contexto de 1.000.000 tokens y compatibilidad con entrada de imagen/video mediante partes de contenido de mensaje compatibles con OpenAI.
• La generación de video V2 de MiniMax ahora documenta MiniMax-H3 y MiniMax-H3-Max mediante un flujo asíncrono POST /v2/video_generation.
• El precio de pago por uso de MiniMax ahora separa la tarifa de texto de M3 por umbral de contexto y nivel de servicio, la tarifa de video H3 por modelo/resolución/segundos, la tarifa de imagen por imagen generada, la tarifa de voz por hora o carácter, y la tarifa de MCP/herramientas por solicitud.
• La documentación pública de Flatkey expone MiniMax-H3 a través del flujo de trabajo asíncrono compartido POST /v1/videos.
• Las páginas públicas de modelos de Flatkey comprobadas durante esta actualización devolvieron 200 para https://flatkey.ai/models/minimax-h3 y https://flatkey.ai/models/minimax-m2.7; https://flatkey.ai/models/minimax-m3 devolvió 404. Eso significa que este artículo no afirma una ruta M3 de Flatkey verificada.

Ese último punto importa. Un artículo sobre routers debería ayudar a los equipos a evitar suposiciones obsoletas sobre los nombres de los modelos. Si quieres M3 a través de Flatkey, revisa el directorio de modelos en vivo, /v1/models, o tu consola antes de configurar el tráfico de producción.

Hechos de la fuente que debes fijar antes de enrutar MiniMax

Usa esta tabla de origen antes de cambiar el código:

Este es el principal hábito de producción detrás de Acceso a la API de MiniMax con un solo router compatible con OpenAI: guarda la fecha de la fuente, guarda el ID del modelo y guarda la ruta de evidencia. Los catálogos de modelos cambian con demasiada frecuencia como para que los fragmentos copiados sean la autoridad final.

Configuración directa del SDK de OpenAI de MiniMax

La configuración directa de MiniMax es la primera prueba más limpia cuando necesitas entender el comportamiento nativo del proveedor.

export OPENAI_BASE_URL="https://api.minimax.io/v1"
export OPENAI_API_KEY="your-minimax-api-key"
export MINIMAX_MODEL="MiniMax-M3"

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["OPENAI_API_KEY"],
    base_url=os.environ["OPENAI_BASE_URL"],
)

response = client.chat.completions.create(
    model=os.environ.get("MINIMAX_MODEL", "MiniMax-M3"),
    messages=[
        {"role": "user", "content": "Devuelve una sola frase confirmando que la ruta de MiniMax funciona."}
    ],
    max_completion_tokens=120,
    extra_body={
        "thinking": {"type": "disabled"}
    },
)

print(response.choices[0].message.content)
print(response.usage)

Usa MiniMax directamente para aprender primero el comportamiento del proveedor:

• ¿Tu app necesita la salida de pensamiento de MiniMax o respuestas directas?
• ¿Tu controlador de streaming tolera los campos de respuesta de MiniMax?
• ¿Tu bucle de tool-call añade el mensaje completo del asistente cuando es necesario?
• ¿Tu analizador depende de parámetros que MiniMax ignora?
• ¿Tu carga de trabajo usa partes de entrada de imagen o video con MiniMax-M3?
• ¿Tu app espera por error entrada de audio en la ruta de chat compatible con OpenAI?

Esa prueba directa te da la línea base antes de poner MiniMax detrás de un router.

Configuración de Flatkey para MiniMax a través de un solo router

Para Flatkey, la configuración del cliente compatible con OpenAI sigue el mismo patrón que se usa para otros modelos: usa una clave de Flatkey, establece la URL base del router de Flatkey y elige un ID de modelo que exista en el catálogo actual de Flatkey.

export FLATKEY_API_KEY="sk-your-flatkey-key"
export OPENAI_BASE_URL="https://router.flatkey.ai/v1"

# Example public chat route verified in this refresh.
export FLATKEY_MINIMAX_TEXT_MODEL="minimax-m2.7"

# Example public video route verified in this refresh.
export FLATKEY_MINIMAX_VIDEO_MODEL="MiniMax-H3"

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["FLATKEY_API_KEY"],
    base_url=os.environ.get("OPENAI_BASE_URL", "https://router.flatkey.ai/v1"),
)

response = client.chat.completions.create(
    model=os.environ["FLATKEY_MINIMAX_TEXT_MODEL"],
    messages=[
        {"role": "user", "content": "Return one sentence confirming the Flatkey MiniMax route works."}
    ],
    max_tokens=120,
)

print(response.choices[0].message.content)
print(response.usage)

Este es el patrón básico de acceso a la API de MiniMax con un solo router compatible con OpenAI. El código sigue siendo normal, pero el ID del modelo debe provenir de Flatkey el día en que hagas la prueba. Si el catálogo actual muestra MiniMax-M3, usa la cadena exacta actual. Si no lo hace, no pegues el ID directo del modelo de MiniMax en una ruta de Flatkey y asumas que funcionará.

Video: MiniMax H3 a través de Flatkey

Para los equipos de medios, el acceso a la API de MiniMax suele tratarse más de video que de chat. Flatkey documenta MiniMax-H3 mediante un flujo de trabajo de video asíncrono dedicado:

curl --fail-with-body -sS https://router.flatkey.ai/v1/videos \
  -H "Authorization: Bearer $FLATKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-H3",
    "content": [
      {
        "type": "text",
        "text": "A paper boat crosses a rain puddle in a cinematic macro shot"
      }
    ],
    "resolution": "768P",
    "duration": 6,
    "ratio": "16:9",
    "aigc_watermark": false
  }'

La guía de MiniMax H3 de Flatkey dice que la respuesta incluye un id y un task_id. Guárdalo, consulta periódicamente GET /v1/videos/{task_id}, y luego descarga el archivo desde metadata.url cuando la tarea se haya completado.

La configuración de video no es intercambiable con una completación de chat:

• MiniMax-H3 usa la estructura de matriz content.
• resolution distingue entre mayúsculas y minúsculas y acepta 768P o 2K en la guía de Flatkey.
• duration es un entero de 4 a 15 segundos.
• Las solicitudes solo de texto necesitan una relación no adaptive.
• Los medios de referencia y los controles del primer/último fotograma tienen reglas de rol diferentes.
• Los campos de uso representan segundos para las respuestas de vídeo de H3, no tokens de modelos de lenguaje.

Si tu producto también compara Seedance, Veo u otros modelos de vídeo, combina este artículo con las comprobaciones de enrutamiento de vídeo multi-proveedor de Flatkey. La clave no es solo si una tarea de vídeo se completa correctamente. La clave es si el contrato de salida, la unidad de coste, el comportamiento de la cola, el estado de fallo y la regla de respaldo son aceptables para el flujo de trabajo.

Unidades de precios de MiniMax que hay que normalizar

El precio es donde el acceso a la API de MiniMax con un solo router compatible con OpenAI puede fallar. MiniMax no es una sola tabla de precios. Son varias unidades de precios.

Los precios de Flatkey y los multiplicadores de grupo son independientes del precio directo de MiniMax. La tabla del proveedor directo te indica cómo factura MiniMax a una cuenta de MiniMax. Una decisión de enrutamiento de Flatkey debe usar la fila del modelo de Flatkey en vivo, el grupo de tu cuenta y el registro de uso después de una solicitud de prueba.

Usa esta fórmula para flujos de trabajo de medios y creadores:

accepted_output_cost:
  provider_or_router_cost: "suma de todos los intentos"
  accepted_outputs: "clips, imágenes, archivos de audio o respuestas que pasaron la revisión"
  formula: "provider_or_router_cost / accepted_outputs"
  include:
    - reintentos
    - intentos de respaldo
    - salidas rechazadas
    - regeneración
    - cola de revisión
    - traspaso de almacenamiento

La salida generada más barata no siempre es la salida aceptada más barata.

Prueba de humo de compatibilidad

Ejecuta esta prueba de humo antes de mover cualquier tráfico de producción:

La condición de aprobación es evidencia, no confianza. Guarda un ID de solicitud o ID de tarea, un ID de modelo, una marca de tiempo, la ruta, una captura de pantalla o exportación del registro de uso y la unidad de costo final.

Registro de revisión de ruta de MiniMax copiable

Usa esta plantilla en tu issue de lanzamiento o repositorio de enrutamiento:

minimax_route_review:
  checked_at_utc: "2026-09-16T00:00:00Z"
  owner: "media_platform_team"
  workload: "creator_video_draft | support_chat | voiceover | image_draft"
  route_mode: "direct_minimax | flatkey | dual_route_test"
  direct_minimax:
    base_url: "https://api.minimax.io/v1"
    model_id: "MiniMax-M3"
    docs_checked:
      - "https://platform.minimax.io/docs/api-reference/text-openai-api.md"
      - "https://platform.minimax.io/docs/guides/pricing-paygo.md"
  flatkey:
    base_url: "https://router.flatkey.ai/v1"
    model_id: "replace_with_current_flatkey_model_id"
    catalog_url: "https://flatkey.ai/models"
    model_page_status: "200 | 404 | account_only"
    usage_logs_verified: false
  endpoint_contract:
    path: "/v1/chat/completions | /v1/videos"
    request_shape: "chat_messages | content_array | prompt_string"
    streaming_required: false
    tool_calls_required: false
    image_input_required: false
    video_input_required: false
  cost_review:
    provider_unit: "tokens | seconds | characters | images | hours | requests"
    flatkey_unit: "registrar la fila actual"
    accepted_output_cost_target: "USD"
  fallback_policy:
    fallback_enabled: false
    fallback_models: []
    allowed_failure_classes:
      - "timeout"
      - "upstream_5xx"
    blocked_failure_classes:
      - "safety_block"
      - "unsupported_feature"
  rollout:
    first_environment: "staging"
    production_slice: "0%"
    rollback_owner: "engineering"
    next_review_date: "YYYY-MM-DD"

Este registro convierte el Acceso a la API de MiniMax con un solo router compatible con OpenAI en una decisión auditable. Cualquiera debería poder ver qué modelo se probó, qué ruta lo gestionó, qué unidad de coste se aprobó y qué comportamiento de fallback está permitido.

Cuándo el acceso directo a MiniMax es suficiente

Usa MiniMax directo cuando:

• MiniMax es el único proveedor en el flujo de trabajo.
• Necesitas un modelo de MiniMax recién lanzado antes de que aparezca en un catálogo de gateway.
• Necesitas una funcionalidad nativa del proveedor que el router no expone.
• Las políticas de compras o de datos requieren controles directos del proveedor.
• Tu equipo todavía está aprendiendo el comportamiento de MiniMax y quiere una línea base limpia.

El acceso directo no es un fallo de arquitectura. Es la ruta correcta cuando la especificidad del proveedor importa más que la centralización.

Cuándo Flatkey es la ruta más limpia

Usa Flatkey cuando MiniMax sea una ruta dentro de un sistema de modelos más amplio:

• El producto compara MiniMax con GPT, Claude, Gemini, DeepSeek, Qwen, Seedance, Veo u otros proveedores.
• Un flujo de trabajo de creadores necesita rutas de texto, imagen, voz y video bajo un solo proceso de revisión.
• Finanzas quiere un único historial de uso a nivel de solicitud en lugar de varias consolas de proveedores.
• Los responsables de plataforma necesitan subclaves, cuotas, listas permitidas de modelos, revisiones de rutas o controles de reversión.
• El equipo ya usa clientes del SDK de OpenAI y quiere la elección del modelo en la configuración.
• Las decisiones de fallback y de estado de la ruta deben ser observables.

Flatkey no elimina las pruebas a nivel de proveedor. Hace que las pruebas y la evidencia sean más fáciles de gestionar entre proveedores.

Errores comunes

• Mezclar credenciales: una clave de MiniMax debe usarse con la URL base de MiniMax, y una clave de Flatkey debe usarse con la URL base de Flatkey.
• Usar MiniMax-M3 en código de Flatkey sin comprobar que el catálogo actual de Flatkey expone exactamente esa ruta.
• Tratar la compatibilidad directa del SDK de OpenAI de MiniMax como si fuera una paridad completa con la API de OpenAI.
• Ignorar las advertencias de MiniMax sobre function_call obsoleto no compatible, n: 1, parámetros ignorados y entrada de audio en la ruta de chat compatible con OpenAI.
• Probar solo chat cuando la carga de trabajo de producción usa streaming, herramientas, entrada de imágenes, entrada de video o trabajos asíncronos de video.
• Comparar precios de tokens, segundos de video, caracteres de voz y precios de imágenes en una sola tabla sin normalizar por la salida aceptada.
• Habilitar el fallback de un modelo de video a otro sin comprobar la duración, la resolución, la compatibilidad con audio/referencia y el comportamiento de moderación.
• Publicar código de ejemplo con claves que parezcan reales o IDs de modelos obsoletos.

Enlaces internos para el siguiente paso

Si esta es tu primera migración a Flatkey, empieza con la guía rápida de la API de Flatkey y el flujo de trabajo más amplio de API unificada de IA. Para revisar la fila del modelo, usa la guía del catálogo de modelos de IA. Para la política de video, combínalo con enrutamiento de API Seedance vs Veo, la lista de verificación de acceso a la API de Veo y la guía de enrutamiento de agentes multimodales.

Preguntas frecuentes

¿Cómo obtengo acceso a la API de MiniMax?

Puedes obtener acceso a la API de MiniMax directamente a través de la plataforma MiniMax con una clave de API de pago por uso, o enrutar los modelos compatibles de MiniMax a través de Flatkey con una clave de Flatkey y https://router.flatkey.ai/v1. Usa MiniMax directo para pruebas nativas del proveedor y Flatkey para enrutamiento multi-proveedor, registros, revisión de facturación y política de fallback.

¿La API de MiniMax es compatible con OpenAI?

MiniMax documenta el uso del SDK de OpenAI con https://api.minimax.io/v1 como URL base para los modelos de lenguaje compatibles. La compatibilidad es a nivel de funcionalidad. MiniMax documenta advertencias sobre parámetros de OpenAI ignorados, n: 1, function_call obsoleto no compatible y sin entrada de audio en la ruta de contenido de mensajes de chat compatible con OpenAI.

¿Cuál es el modelo de lenguaje actual de MiniMax que debo comprobar primero?

La documentación oficial de MiniMax enumera MiniMax-M3 como el último modelo de lenguaje de la serie M, con una ventana de contexto de 1.000.000 de tokens y compatibilidad multimodal para entrada de imagen y video. Para Flatkey, revisa el catálogo en vivo antes de asumir que ese ID exacto de modelo está disponible a través del router.

¿Puedo usar MiniMax-M3 a través de Flatkey?

No lo asuma únicamente a partir de la documentación directa de MiniMax. Durante esta actualización del 16 de septiembre de 2026, la página pública de detalles del modelo Flatkey minimax-m3 devolvió 404, mientras que minimax-m2.7 y MiniMax-H3 devolvieron 200. Revise su directorio actual de modelos de Flatkey, /v1/models, o la consola antes de configurar M3 a través de Flatkey.

¿Cómo uso el video de MiniMax-H3 a través de Flatkey?

Use POST https://router.flatkey.ai/v1/videos con el modelo MiniMax-H3, un array content, una resolution de 768P o 2K, una duración de 4 a 15 y una relación válida. Guarde el ID de tarea devuelto, consulte periódicamente GET /v1/videos/{task_id}, y luego descargue desde metadata.url cuando se complete.

¿Cómo debería comparar los precios de MiniMax a través de un router?

Empiece con la unidad directa de MiniMax, luego revise la fila del modelo en Flatkey y su registro de uso. El texto usa unidades de tokens, el video usa segundos, la voz puede usar horas o caracteres, la generación de imágenes usa precios por imagen y las herramientas pueden usar precios por solicitud. Compare el costo por salida aceptada después de reintentos y salidas rechazadas, no solo el precio de lista.

¿Flatkey reemplaza las pruebas directas de rutas de MiniMax?

No. Flatkey puede centralizar la gestión de claves, el enrutamiento de modelos, los registros de uso y la revisión de facturación, pero aun así necesita probar el modelo exacto, el endpoint, la forma de la solicitud, la unidad de precio, la regla de respaldo y el comportamiento de error que usará su producto.

Conclusión final

El Acceso a la API de MiniMax con un solo router compatible con OpenAI debe terminar con un registro de ruta fechado, no solo con un base_url cambiado. Confirme el comportamiento directo de MiniMax, elija la fila exacta del modelo en Flatkey si enruta a través de Flatkey, ejecute pruebas rápidas de chat y video por separado, normalice los precios por salida aceptada y mantenga el rollback en la configuración. Luego use el directorio de modelos de Flatkey, la página de precios, la guía de inicio rápido, la documentación de video y los registros de uso para mantener MiniMax dentro del mismo ciclo de revisión operativa que el resto de su pila de modelos.

Para los equipos de medios y producto, el Acceso a la API de MiniMax con un solo router compatible con OpenAI es el hábito práctico de tratar cada lanzamiento de modelo como una decisión de ruta con evidencia adjunta.