Acesso à API da MiniMax com um Roteador Compatível com OpenAI

Acesso à API da MiniMax com um Roteador Compatível com OpenAI é útil quando sua equipe quer a MiniMax no mesmo fluxo de trabalho de produção que o restante da sua stack de IA. O caminho direto da MiniMax já é compatível com o SDK da OpenAI para os modelos de linguagem suportados. Um caminho por roteador adiciona uma única URL base compartilhada, uma camada única de chave, uma única verificação de catálogo, um único log de uso e um único lugar para decidir quais cargas de trabalho da MiniMax devem ficar ao lado de GPT, Claude, Gemini, DeepSeek, Qwen, Seedance, Veo e outras rotas de modelo.

Esta atualização foi verificada em 16 de setembro de 2026 com base na documentação oficial da API da MiniMax, nos preços pay-as-you-go da MiniMax, na documentação pública da Flatkey, no diretório de modelos da Flatkey e nas páginas de modelos da MiniMax na Flatkey. Trate todo modelo, preço e status de rota como um instantâneo público datado. Verifique novamente sua conta, catálogo e termos antes de enviar tráfego de produção.

A versão curta: use a MiniMax direta quando você precisar apenas de acesso à conta da MiniMax. Use a Flatkey quando a MiniMax precisar ser avaliada, orçada, registrada e revertida dentro de um fluxo de trabalho de roteador com vários provedores.

Resposta Rápida: Acesso à API da MiniMax com um Roteador Compatível com OpenAI

Se seu app já usa o SDK da OpenAI para Python ou JavaScript, a MiniMax tem dois caminhos práticos de acesso:

Use este guia de Acesso à API da MiniMax com um Roteador Compatível com OpenAI como checklist de lançamento. Não aprove a migração só porque uma resposta de exemplo funcionou. Aprove quando o ID exato do modelo, endpoint, formato da requisição, unidade de preço, log de uso, regra de fallback e caminho de reversão estiverem todos visíveis.

O que Mudou Desde o Artigo Antigo da MiniMax

O artigo público mais antigo estava datado de 16 de junho de 2026. A atualização segura não é uma reescrita cosmética. A MiniMax e a Flatkey avançaram o suficiente para que o artigo precise de uma linguagem de rota atualizada.

As principais atualizações são:

• A MiniMax agora documenta MiniMax-M3 como o mais recente modelo de linguagem da série M compatível com o OpenAI SDK, com uma janela de contexto de 1.000.000 de tokens e suporte a entrada de imagem/vídeo por meio de partes de conteúdo de mensagens compatíveis com OpenAI.
• A geração de vídeo MiniMax V2 agora documenta MiniMax-H3 e MiniMax-H3-Max por meio de um fluxo assíncrono POST /v2/video_generation.
• O preço pay-as-you-go da MiniMax agora separa o preço de texto do M3 por limite de contexto e nível de serviço, o preço de vídeo do H3 por modelo/resolução/segundos, o preço de imagem por imagem gerada, o preço de fala por hora ou caractere e o preço de MCP/ferramenta por solicitação.
• A documentação pública da Flatkey expõe MiniMax-H3 por meio do fluxo assíncrono de vídeo compartilhado POST /v1/videos.
• As páginas públicas de modelos da Flatkey verificadas durante esta atualização retornaram 200 para https://flatkey.ai/models/minimax-h3 e https://flatkey.ai/models/minimax-m2.7; https://flatkey.ai/models/minimax-m3 retornou 404. Isso significa que este artigo não afirma uma rota M3 verificada da Flatkey.

Esse último ponto importa. Um artigo sobre roteadores deve ajudar as equipes a evitar suposições desatualizadas sobre nomes de modelos. Se você quiser o M3 por meio da Flatkey, verifique o diretório de modelos ao vivo, /v1/models, ou seu console antes de configurar o tráfego de produção.

Fatos da fonte para fixar antes de rotear a MiniMax

Use esta tabela de origem antes de alterar o código:

Este é o principal hábito de produção por trás de Acesso à API da MiniMax com um Roteador Compatível com OpenAI: salve a data da fonte, salve o ID do modelo e salve o caminho de evidência. Os catálogos de modelos mudam com muita frequência para que trechos copiados sejam a autoridade final.

Configuração Direta do SDK OpenAI da MiniMax

A configuração direta da MiniMax é o primeiro teste mais limpo quando você precisa entender o comportamento nativo do provedor.

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": "Return one sentence confirming the MiniMax route works."}
    ],
    max_completion_tokens=120,
    extra_body={
        "thinking": {"type": "disabled"}
    },
)

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

Use a MiniMax direta para aprender primeiro o comportamento do provedor:

• O seu app precisa da saída de pensamento do MiniMax ou de respostas diretas?
• O seu manipulador de stream tolera os campos de resposta do MiniMax?
• O seu loop de chamada de ferramenta anexa a mensagem completa do assistente quando necessário?
• O seu analisador depende de parâmetros que o MiniMax ignora?
• A sua carga de trabalho usa partes de entrada de imagem ou vídeo com MiniMax-M3?
• O seu app espera acidentalmente entrada de áudio no caminho de chat compatível com OpenAI?

Esse teste direto dá a você a linha de base antes de colocar o MiniMax atrás de um roteador.

Configuração do Flatkey para o MiniMax por meio de um roteador

No Flatkey, a configuração do cliente compatível com OpenAI segue o mesmo padrão usado para outros modelos: use uma chave Flatkey, defina a URL base do roteador Flatkey e escolha um ID de modelo que exista no catálogo atual do Flatkey.

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

# Exemplo de rota pública de chat verificada nesta atualização.
export FLATKEY_MINIMAX_TEXT_MODEL="minimax-m2.7"

# Exemplo de rota pública de vídeo verificada nesta atualização.
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": "Retorne uma frase confirmando que a rota Flatkey MiniMax funciona."}
    ],
    max_tokens=120,
)

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

Este é o padrão básico de Acesso à API da MiniMax com um roteador compatível com OpenAI. O código continua normal, mas o ID do modelo deve vir do Flatkey no dia em que você testar. Se o catálogo atual mostrar MiniMax-M3, use a string exata atual. Se não mostrar, não cole o ID direto do modelo MiniMax em uma rota do Flatkey e presuma que funcionará.

Vídeo: MiniMax H3 por meio do Flatkey

Para equipes de mídia, o acesso à API da MiniMax costuma ser mais sobre vídeo do que sobre chat. O Flatkey documenta MiniMax-H3 por meio de um fluxo de trabalho assíncrono dedicado de vídeo:

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": "Um barco de papel cruza uma poça de chuva em uma tomada macro cinematográfica"
      }
    ],
    "resolution": "768P",
    "duration": 6,
    "ratio": "16:9",
    "aigc_watermark": false
  }'

O guia do MiniMax H3 do Flatkey diz que a resposta inclui um id e um task_id. Salve isso, consulte GET /v1/videos/{task_id}, e então baixe o arquivo de metadata.url quando a tarefa for concluída.

A configuração de vídeo não é intercambiável com uma conclusão de chat:

• MiniMax-H3 usa a estrutura de array content.
• resolution diferencia maiúsculas de minúsculas e aceita 768P ou 2K no guia da Flatkey.
• duration é um inteiro de 4 a 15 segundos.
• Solicitações apenas de texto precisam de uma proporção não-adaptive.
• As mídias de referência e os controles de primeiro/último quadro têm regras de função diferentes.
• Os campos de uso representam segundos para respostas de vídeo H3, não tokens de modelos de linguagem.

Se o seu produto também compara Seedance, Veo ou outros modelos de vídeo, combine este artigo com as verificações de roteamento de vídeo multi-fornecedor da Flatkey. O ponto principal não é apenas se uma tarefa de vídeo é concluída com sucesso. O ponto principal é se o contrato de saída, a unidade de custo, o comportamento da fila, o estado de falha e a regra de fallback são aceitáveis para o fluxo de trabalho.

Unidades de Preço da MiniMax para Normalizar

O preço é onde o acesso à API da MiniMax com um roteador compatível com OpenAI pode dar errado. A MiniMax não tem uma única tabela de preços. São várias unidades de preço.

Os preços do Flatkey e os multiplicadores de grupo são separados dos preços diretos da MiniMax. A tabela do provedor direto informa como a MiniMax cobra em uma conta MiniMax. Uma decisão de roteamento do Flatkey deve usar a linha do modelo Flatkey ao vivo, o grupo da sua conta e o log de uso após uma solicitação de teste.

Use esta fórmula para fluxos de trabalho de mídia e criadores:

accepted_output_cost:
  provider_or_router_cost: "soma de todas as tentativas"
  accepted_outputs: "clipes, imagens, arquivos de áudio ou respostas que passaram na revisão"
  formula: "provider_or_router_cost / accepted_outputs"
  include:
    - retries
    - fallback attempts
    - rejected outputs
    - regeneration
    - review lane
    - storage handoff

A saída gerada mais barata nem sempre é a saída aceita mais barata.

Teste de Fumaça de Compatibilidade

Execute este teste de fumaça antes de mover qualquer tráfego de produção:

A condição de aprovação é evidência, não confiança. Salve um ID de solicitação ou ID de tarefa, um ID de modelo, um carimbo de data e hora, o caminho da rota, uma captura de tela ou exportação do log de uso e a unidade final de custo.

Registro de Revisão de Rota MiniMax Copiável

Use este modelo no seu issue de lançamento ou repositório de roteamento:

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: "record current row"
    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 transforma o Acesso à API da MiniMax com um Roteador Compatível com OpenAI em uma decisão auditável. Qualquer pessoa deve conseguir ver qual modelo foi testado, qual rota o processou, qual unidade de custo foi aprovada e qual comportamento de fallback é permitido.

Quando o MiniMax Direto É Suficiente

Use o MiniMax direto quando:

• MiniMax for o único provedor no fluxo de trabalho.
• Você precisar de um modelo MiniMax recém-lançado antes que ele apareça em um catálogo de gateway.
• Você precisar de um recurso nativo do provedor que o roteador não expõe.
• As políticas de compras ou de dados exigirem controles diretos do provedor.
• Sua equipe ainda estiver aprendendo o comportamento da MiniMax e quiser uma base limpa.

O acesso direto não é uma falha de arquitetura. É o caminho certo quando a especificidade do provedor importa mais do que a centralização.

Quando a Flatkey É o Caminho Mais Limpo

Use a Flatkey quando a MiniMax for uma rota em um sistema de modelos mais amplo:

• O produto compara MiniMax com GPT, Claude, Gemini, DeepSeek, Qwen, Seedance, Veo ou outros provedores.
• Um fluxo de trabalho de criação precisa de rotas de texto, imagem, fala e vídeo sob um único processo de revisão.
• O financeiro quer um único histórico de uso em nível de requisição em vez de vários consoles de provedores.
• Os responsáveis pela plataforma precisam de subchaves, cotas, allowlists de modelos, revisões de rotas ou controles de rollback.
• A equipe já usa clientes do SDK da OpenAI e quer a escolha do modelo na configuração.
• As decisões de fallback e de integridade da rota precisam ser observáveis.

Flatkey não remove os testes no nível do provedor. Ele torna os testes e as evidências mais fáceis de gerenciar entre provedores.

Erros Comuns

• Misturar credenciais: uma chave MiniMax pertence ao URL base da MiniMax, e uma chave Flatkey pertence ao URL base da Flatkey.
• Usar MiniMax-M3 no código da Flatkey sem verificar se o catálogo atual da Flatkey expõe exatamente essa rota.
• Tratar a compatibilidade direta do SDK OpenAI da MiniMax como paridade total com a API da OpenAI.
• Ignorar as ressalvas da MiniMax sobre function_call obsoleto e sem suporte, n: 1, parâmetros ignorados e entrada de áudio no caminho de chat compatível com OpenAI.
• Testar apenas chat quando a carga de trabalho de produção usa streaming, ferramentas, entrada de imagem, entrada de vídeo ou jobs assíncronos de vídeo.
• Comparar preços de tokens, segundos de vídeo, caracteres de fala e preços de imagem em uma única tabela sem normalizar pelo resultado de saída aceito.
• Habilitar fallback de um modelo de vídeo para outro sem verificar duração, resolução, suporte a áudio/referência e comportamento de moderação.
• Publicar código de exemplo com chaves que pareçam reais ou IDs de modelo desatualizados.

Links Internos Para o Próximo Passo

Se esta for sua primeira migração para a Flatkey, comece com o quickstart da API da Flatkey e o fluxo de trabalho unificado de API de IA mais amplo. Para revisão da linha do modelo, use o guia de catálogo de modelos de IA. Para política de vídeo, combine isto com o roteamento de API Seedance vs Veo, a lista de verificação de acesso à API Veo e o guia de roteamento de agentes multimodais.

Perguntas frequentes

Como obtenho acesso à API da MiniMax?

Você pode obter acesso à API da MiniMax diretamente pela plataforma MiniMax com uma chave de API pay-as-you-go, ou rotear os modelos MiniMax suportados pela Flatkey com uma chave Flatkey e https://router.flatkey.ai/v1. Use a MiniMax direta para testes nativos do provedor e a Flatkey para roteamento multi-provedor, logs, revisão de faturamento e política de fallback.

A API da MiniMax é compatível com OpenAI?

A MiniMax documenta o uso do SDK OpenAI com https://api.minimax.io/v1 como URL base para modelos de linguagem suportados. A compatibilidade é no nível de recursos. A MiniMax documenta ressalvas sobre parâmetros OpenAI ignorados, n: 1, function_call obsoleto sem suporte e ausência de entrada de áudio no caminho de conteúdo de mensagens de chat compatível com OpenAI.

Qual é o modelo de linguagem atual da MiniMax que devo verificar primeiro?

A documentação oficial da MiniMax lista MiniMax-M3 como o mais recente modelo de linguagem da série M, com uma janela de contexto de 1.000.000 de tokens e suporte multimodal para entrada de imagem e vídeo. Para a Flatkey, verifique o catálogo ao vivo antes de assumir que esse ID de modelo exato está disponível pelo roteador.

Posso usar o MiniMax-M3 pela Flatkey?

Não o assuma com base apenas na documentação direta da MiniMax. Durante esta atualização de 16 de setembro de 2026, a página pública de detalhes do modelo minimax-m3 na Flatkey retornou 404, enquanto minimax-m2.7 e MiniMax-H3 retornaram 200. Verifique seu diretório atual de modelos da Flatkey, /v1/models, ou o console antes de configurar o M3 através da Flatkey.

Como uso o vídeo MiniMax-H3 via Flatkey?

Use POST https://router.flatkey.ai/v1/videos com o modelo MiniMax-H3, um array content, resolution de 768P ou 2K, uma duração de 4 a 15, e uma proporção válida. Salve o ID da tarefa retornado, faça polling em GET /v1/videos/{task_id} e depois faça o download de metadata.url quando concluído.

Como devo comparar os preços da MiniMax por meio de um roteador?

Comece pela unidade direta da MiniMax, depois verifique a linha do modelo na Flatkey e seu log de uso. Texto usa unidades de tokens, vídeo usa segundos, fala pode usar horas ou caracteres, geração de imagens usa precificação por imagem, e ferramentas podem usar precificação por requisição. Compare o custo por saída aceita após tentativas e saídas rejeitadas, não apenas o preço de tabela.

A Flatkey substitui os testes diretos de rota da MiniMax?

Não. A Flatkey pode centralizar o gerenciamento de chaves, o roteamento de modelos, os logs de uso e a revisão de cobrança, mas você ainda precisa testar o modelo exato, o endpoint, a estrutura da requisição, a unidade de preço, a regra de fallback e o comportamento de erro que seu produto usará.

Conclusão Final

Acesso à API da MiniMax com um Roteador Compatível com OpenAI deve terminar com um registro de rota datado, e não apenas com uma alteração em base_url. Confirme o comportamento direto da MiniMax, escolha a linha exata do modelo na Flatkey se você rotear pela Flatkey, execute testes rápidos de chat e vídeo separadamente, normalize a precificação por saída aceita e mantenha a reversão na configuração. Em seguida, use o diretório de modelos, a página de preços, o guia de início rápido, a documentação de vídeo e os logs de uso da Flatkey para manter a MiniMax dentro do mesmo ciclo de revisão operacional que o restante da sua pilha de modelos.

Para equipes de mídia e produto, Acesso à API da MiniMax com um Roteador Compatível com OpenAI é o hábito prático de tratar cada lançamento de modelo como uma decisão de rota com evidências anexadas.