使用一个兼容 OpenAI 的路由器访问 MiniMax API

使用一个兼容 OpenAI 的路由器访问 MiniMax API 当你的团队希望将 MiniMax 与 AI 技术栈中的其他部分放在同一生产工作流中时，这会很有用。对于受支持的语言模型，直接的 MiniMax 路径已经与 OpenAI SDK 兼容。路由器路径则增加了一个共享基础 URL、一个密钥层、一次目录检查、一份使用日志，以及一个统一位置来决定哪些 MiniMax 工作负载应与 GPT、Claude、Gemini、DeepSeek、Qwen、Seedance、Veo 和其他模型路由并列。

本次更新已于 2026 年 9 月 16 日对照 MiniMax 官方 API 文档、MiniMax 按量付费定价、Flatkey 公共文档、Flatkey 模型目录以及 Flatkey MiniMax 模型页面进行核查。请将所有模型、价格和路由状态都视为带日期的公开快照。在向生产流量发送请求之前，请重新核对你的账户、目录和条款。

简而言之：当你只需要 MiniMax 账户访问时，使用直接的 MiniMax。 当 MiniMax 需要在多提供商路由器工作流中进行评估、预算控制、记录和回滚时，使用 Flatkey。

快速回答：使用一个兼容 OpenAI 的路由器访问 MiniMax API

如果你的应用已经使用 OpenAI Python 或 JavaScript SDK，MiniMax 有两种实用的访问路径：

将这份《使用一个兼容 OpenAI 的路由器访问 MiniMax API》指南当作上线清单。不要因为某个示例响应有效就批准迁移。只有当确切的模型 ID、端点、请求格式、定价单位、使用日志、回退规则和回滚路径都清晰可见时，才批准。

与旧版 MiniMax 文章相比有哪些变化

旧的公开文章日期是 2026 年 6 月 16 日。安全的更新并不是表面上的重写。MiniMax 和 Flatkey 都发生了足够多的变化，以至于这篇文章需要使用当前的路由语言。

关键更新如下：

• MiniMax 现在将 MiniMax-M3 记录为最新的支持 OpenAI SDK 的 M 系列语言模型，提供 1,000,000 token 的上下文窗口，并可通过兼容 OpenAI 的消息内容部分支持图像/视频输入。
• MiniMax 视频生成 V2 现在通过异步 POST /v2/video_generation 流程记录 MiniMax-H3 和 MiniMax-H3-Max。
• MiniMax 按量付费定价现在将 M3 文本定价按上下文阈值和服务层级区分，将 H3 视频定价按模型/分辨率/秒数区分，将图像定价按生成图片计费，将语音定价按小时或字符计费，并将 MCP/工具定价按请求计费。
• Flatkey 公共文档通过共享的 POST /v1/videos 异步视频工作流公开了 MiniMax-H3。
• 在本次刷新期间检查的 Flatkey 公共模型页面中，https://flatkey.ai/models/minimax-h3 和 https://flatkey.ai/models/minimax-m2.7 返回了 200；https://flatkey.ai/models/minimax-m3 返回了 404。这意味着本文并未声称已验证 Flatkey 的 M3 路由。

最后这一点很重要。路由器文章应帮助团队避免对模型名称的过时假设。如果你想通过 Flatkey 使用 M3，请在配置生产流量之前检查实时模型目录、/v1/models 或你的控制台。

在路由 MiniMax 之前需要锁定的源事实

在更改代码之前，请使用此源表：

这就是《使用一个兼容 OpenAI 的路由器访问 MiniMax API》背后的主要生产习惯：保存来源日期、保存模型 ID、保存证据路径。模型目录变化太快，复制的代码片段不可能成为最终权威。

直接 MiniMax OpenAI SDK 设置

当你需要了解提供商原生行为时，直接 MiniMax 配置是最干净的首次测试。

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)

先使用直连 MiniMax 来了解提供商行为：

• 您的应用需要 MiniMax 的思考输出还是直接答案？
• 您的流式处理器能否兼容 MiniMax 的响应字段？
• 在需要时，您的工具调用循环是否会追加完整的 assistant 消息？
• 您的解析器是否依赖 MiniMax 会忽略的参数？
• 您的工作负载是否使用带有 MiniMax-M3 的图像或视频输入部分？
• 您的应用是否在 OpenAI 兼容的聊天路径中误以为会有音频输入？

在把 MiniMax 放到路由器后面之前，这个直接测试就能给您提供基线。

通过一个路由器使用 Flatkey 配置 MiniMax

对于 Flatkey，OpenAI 兼容客户端的设置与其他模型采用相同模式：使用 Flatkey 密钥，设置 Flatkey 路由器基础 URL，并选择当前 Flatkey 目录中存在的模型 ID。

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

# 本次刷新中已验证的示例公共聊天路由。
export FLATKEY_MINIMAX_TEXT_MODEL="minimax-m2.7"

# 本次刷新中已验证的示例公共视频路由。
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)

这就是通过一个兼容 OpenAI 的路由器访问 MiniMax API 的基本模式。代码保持普通写法，但模型 ID 必须来自您测试当天的 Flatkey。如果当前目录显示 MiniMax-M3，就使用当前的精确字符串。如果没有，不要把直接的 MiniMax 模型 ID 贴到 Flatkey 路由里并假设它会生效。

视频：通过 Flatkey 使用 MiniMax H3

对于媒体团队来说，MiniMax API 访问通常更偏向视频而不是聊天。Flatkey 通过专门的异步视频工作流记录了 MiniMax-H3：

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
  }'

Flatkey 的 MiniMax H3 指南说明响应会包含一个 id 和 task_id。请保存它，轮询 GET /v1/videos/{task_id}，然后在任务完成时从 metadata.url 下载文件。

视频设置不能与聊天补全互换使用：

• MiniMax-H3 使用 content 数组结构。
• resolution 区分大小写，在 Flatkey 指南中接受 768P 或 2K。
• duration 是一个从 4 到 15 秒的整数。
• 仅文本请求需要非 adaptive 比例。
• 参考媒体以及首帧/尾帧控制有不同的角色规则。
• 用量字段表示 H3 视频响应的秒数，而不是语言模型 token。

如果你的产品也在对比 Seedance、Veo 或其他视频模型，可以将本文与 Flatkey 的多提供商视频路由检查搭配使用。关键不只是视频任务是否成功。关键在于输出契约、成本单位、队列行为、失败状态和回退规则是否适合工作流。

需要归一化的 MiniMax 计费单位

计费是 MiniMax API Access With One OpenAI-Compatible Router 可能出错的地方。MiniMax 并不是单一价目表，而是多种计费单位。

Flatkey 价格和组乘数独立于直接 MiniMax 定价。直接提供方表告诉你 MiniMax 如何向 MiniMax 账户计费。Flatkey 的路由决策应使用实时的 Flatkey 模型行、你的账户组，以及测试请求后的使用日志。

媒体和创作者工作流请使用以下公式：

accepted_output_cost:
  provider_or_router_cost: "sum of all attempts"
  accepted_outputs: "clips, images, audio files, or responses that passed review"
  formula: "provider_or_router_cost / accepted_outputs"
  include:
    - retries
    - fallback attempts
    - rejected outputs
    - regeneration
    - review lane
    - storage handoff

最便宜的生成输出并不总是最便宜的已接受输出。

兼容性冒烟测试

在将任何生产流量切换之前先运行此冒烟测试：

通过条件是证据，而不是信心。保存请求 ID 或任务 ID、模型 ID、时间戳、路由路径、使用日志截图或导出，以及最终成本单位。

可复制的 MiniMax 路由审查记录

在你的发布工单或路由仓库中使用此模板：

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: "记录当前行"
    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"

这份记录将“通过一个兼容 OpenAI 的路由器访问 MiniMax API”变成了一项可审计的决策。任何人都应该能够看出测试了哪个模型、由哪条路由处理、批准了哪种成本单位，以及允许哪些回退行为。

何时直接使用 MiniMax 就足够

在以下情况下使用直接 MiniMax：

• MiniMax 是工作流中唯一的提供商。
• 你需要一个新发布的 MiniMax 模型，而它尚未出现在网关目录中。
• 你需要路由器未暴露的提供商原生功能。
• 采购或数据政策要求直接使用提供商控制。
• 你的团队仍在了解 MiniMax 的行为，并希望有一个干净的基线。

直接访问并不意味着架构失败。只有在提供商特性比集中化更重要时，它才是正确的路径。

何时 Flatkey 是更清晰的路径

当 MiniMax 只是更广泛模型系统中的一条路线时，使用 Flatkey：

• 产品将 MiniMax 与 GPT、Claude、Gemini、DeepSeek、Qwen、Seedance、Veo 或其他提供商进行比较。
• 创作工作流需要在一个审核流程下统一处理文本、图像、语音和视频路由。
• 财务希望看到一条按请求级别的使用轨迹，而不是多个提供商控制台。
• 平台负责人需要子密钥、配额、模型允许列表、路由审核或回滚控制。
• 团队已经在使用 OpenAI SDK 客户端，并希望通过配置来选择模型。
• 回退和路由健康状况决策需要可观察。

Flatkey 并不会移除供应商级测试。它只是让跨供应商的测试和证据更容易管理。

常见错误

• 混用凭证：MiniMax 密钥应对应 MiniMax 基础 URL，而 Flatkey 密钥应对应 Flatkey 基础 URL。
• 在 Flatkey 代码中使用 MiniMax-M3，却没有先确认当前 Flatkey 目录是否公开了该精确路由。
• 把直接使用 MiniMax 的 OpenAI SDK 兼容性当作完全等同于 OpenAI API。
• 忽视 MiniMax 关于不支持已弃用的 function_call、n: 1、被忽略参数，以及在 OpenAI 兼容聊天路径中不支持音频输入的说明。
• 只测试聊天，而生产负载实际使用的是流式传输、工具、图像输入、视频输入或异步视频任务。
• 在一个表格里比较 token 价格、视频秒数、语音字符数和图片价格，却没有按可接受输出进行归一化。
• 在不检查时长、分辨率、音频/参考支持以及审核行为的情况下，将一个视频模型的回退启用到另一个视频模型。
• 发布包含看起来像真实密钥或过期模型 ID 的示例代码。

下一步的内部链接

如果这是你第一次迁移到 Flatkey，请先阅读 Flatkey API 快速入门，以及更广泛的 统一 AI API 工作流。如需查看模型行，请使用 AI 模型目录指南。关于视频策略，请将本文与 Seedance 与 Veo API 路由、Veo API 访问清单以及 多模态代理路由指南配合阅读。

常见问题

如何获取 MiniMax API 访问权限？

你可以直接通过 MiniMax 平台使用按量付费的 API 密钥获取 MiniMax API 访问权限，也可以使用 Flatkey 密钥和 https://router.flatkey.ai/v1 通过 Flatkey 路由受支持的 MiniMax 模型。对于供应商原生测试，请使用直接的 MiniMax；对于多供应商路由、日志、计费审查和回退策略，请使用 Flatkey。

MiniMax API 兼容 OpenAI 吗？

MiniMax 文档说明，受支持的语言模型可使用 https://api.minimax.io/v1 作为基础 URL 来使用 OpenAI SDK。兼容性是按功能层面定义的。MiniMax 还说明了关于被忽略的 OpenAI 参数、n: 1、不支持已弃用的 function_call，以及在 OpenAI 兼容的聊天消息内容路径中不支持音频输入的注意事项。

首先要检查的当前 MiniMax 语言模型是什么？

MiniMax 官方文档将 MiniMax-M3 列为最新的 M 系列语言模型，拥有 1,000,000 token 的上下文窗口，并支持图像和视频输入的多模态能力。对于 Flatkey，请在假设该精确模型 ID 可通过路由器使用之前，先查看实时目录。

我可以通过 Flatkey 使用 MiniMax-M3 吗？

不要仅凭 MiniMax 的直接文档就这样假设。在 2026 年 9 月 16 日这次更新期间，公开的 Flatkey minimax-m3 模型详情页返回了 404，而 minimax-m2.7 和 MiniMax-H3 返回了 200。在通过 Flatkey 配置 M3 之前，请先检查你当前的 Flatkey 模型目录、/v1/models 或控制台。

如何通过 Flatkey 使用 MiniMax-H3 视频？

使用 POST https://router.flatkey.ai/v1/videos，模型为 MiniMax-H3，提供一个 content 数组，resolution 为 768P 或 2K，时长为 4 到 15 之间，并使用有效的比例。保存返回的任务 ID，轮询 GET /v1/videos/{task_id}，完成后从 metadata.url 下载。

我应该如何通过路由器比较 MiniMax 定价？

先从 MiniMax 的直接单价开始，再查看 Flatkey 的模型行和你的使用日志。文本使用 token 单位，视频使用秒，语音可能使用小时或字符，图像生成按每张图定价，工具则可能按每次请求定价。应比较重试和被拒绝输出之后的已接受输出成本，而不只是标价。

Flatkey 会替代直接的 MiniMax 路由测试吗？

不会。Flatkey 可以集中管理密钥、模型路由、使用日志和计费审查，但你仍然需要测试产品将使用的确切模型、端点、请求格式、价格单位、回退规则和错误行为。

最终结论

通过一个兼容 OpenAI 的路由器访问 MiniMax API，最终应形成一份带日期的路由记录，而不仅仅是更改了 base_url。确认直接连接 MiniMax 的行为，如果通过 Flatkey 路由，则选定准确的 Flatkey 模型行，分别运行聊天和视频冒烟测试，按已接受输出统一价格口径，并将回滚保留在配置中。然后利用 Flatkey 的模型目录、定价页面、快速入门、视频文档和使用日志，让 MiniMax 与你的其余模型栈一样，纳入同一套运维审查流程。

对于媒体和产品团队来说，通过一个兼容 OpenAI 的路由器访问 MiniMax API，本质上是一种实践习惯：把每一次模型上线都当作一次带有证据的路由决策。