需通过One-API自定义平台配置Minimax模型：一、在Minimax控制台获取API Key和Group ID并授权模型；二、在One-API添加自定义平台，设置基础URL、请求头及模型路径；三、配置请求体重写以适配Minimax字段；四、必要时部署Nginx反向代理解决TLS或网络限制；五、启用响应体重写，将Minimax返回格式映射为OpenAI兼容结构。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望将 Minimax 的大模型能力接入开源的 One-API 平台，需通过 One-API 的自定义后端模型配置机制实现。One-API 支持以 OpenAI 兼容接口方式对接第三方模型服务，Minimax 提供了符合 OpenAI REST API 规范的 v1/chat/completions 接口，因此可作为“自定义平台”添加至 One-API 中。以下是具体操作步骤：
一、获取 Minimax API 访问凭证
Minimax 要求每个请求携带有效的 API Key 和 Group ID，二者均需在 Minimax 控制台中创建并绑定模型权限。One-API 在转发请求时需将这些凭证注入 HTTP Header，因此必须提前完成申请与验证。
1、访问 https://www.minimaxi.com/console 并登录 Minimax 账户。
2、进入「API 密钥管理」页面，点击「创建新密钥」，填写描述后生成新的 API Key。
3、在「项目与分组」中确认已创建至少一个 Group，并记录其 group_id 值（格式如 grp-xxxxxxxx）。
4、前往「模型授权」页面，为该 Group 授权使用 abab6.5s-chat 或其他已开通的 chat 模型。
二、配置 One-API 自定义平台
One-API 不内置 Minimax 支持，但可通过「自定义平台」功能模拟 OpenAI 接口行为。需手动设置基础 URL、认证头、路径映射及模型名称映射关系，确保请求能被 Minimax 服务正确接收并响应。
1、登录 One-API 管理后台，在左侧菜单选择「平台管理」→「添加平台」→「自定义平台」。
2、在「平台名称」栏填写 minimax-custom；「基础 URL」填入 https://api.minimaxi.com/v1。
3、在「请求头」区域点击「添加请求头」，分别新增两行：
Key 填 Authorization，Value 填 Bearer {your_api_key}；
Key 填 X-Tenant-Id，Value 填 {your_group_id}。
4、在「模型列表」中点击「添加模型」，模型名称设为 abab6.5s-chat，路径填 /chat/completions，并勾选「启用」。
三、调整请求体字段映射
Minimax 的请求体结构与 OpenAI 存在差异，主要体现在 message role 值和 system prompt 处理方式上。One-API 的自定义平台支持字段重写规则，需将 standard OpenAI 字段转换为 Minimax 所需格式，否则会返回 400 错误。
1、在刚创建的自定义平台编辑页中，展开「请求体重写」选项。
2、启用「启用请求体重写」，并在「重写规则」文本框中粘贴以下 JSON：
{"messages":"$.messages","model":"$.model","temperature":"$.temperature","max_tokens":"$.max_completion_tokens"}
3、在「请求体模板」中替换为 Minimax 兼容结构：
{"model": "{{.model}}", "messages": {{.messages | toJson}}, "temperature": {{.temperature}}, "max_completion_tokens": {{.max_tokens}}
4、保存平台配置，并点击右侧「测试连接」按钮，使用模型名 abab6.5s-chat 发起测试请求。
四、部署反向代理绕过跨域或证书限制
若 One-API 实例运行在内网或使用自签名证书环境，直接调用 Minimax 官方域名可能因 TLS 验证失败或网络策略拦截而超时。此时需在 One-API 所在服务器部署轻量反向代理，将 /v1/chat/completions 请求转发至 Minimax，并由代理统一处理证书与头部透传。
1、在 One-API 服务器安装 Nginx，编辑配置文件添加 server 块：
location /v1/chat/completions { proxy_pass https://api.minimaxi.com/v1/chat/completions; proxy_set_header X-Tenant-Id $http_x_tenant_id; proxy_set_header Authorization $http_authorization; }
2、重启 Nginx 服务，验证代理是否生效：curl -H "X-Tenant-Id: grp-xxx" -H "Authorization: Bearer xxx" http://localhost/v1/chat/completions。
3、回到 One-API 平台配置，将「基础 URL」改为 http://localhost，移除原 HTTPS 地址。
4、重新测试模型调用，确认响应状态码为 200 且返回 valid JSON 格式的 completion 内容。
五、验证模型响应格式兼容性
Minimax 返回的 JSON 结构与 OpenAI 不完全一致，One-API 默认解析器可能无法提取 content 字段。需启用「响应体重写」功能，将 Minimax 的 response.choices[0].message.content 映射到标准 OpenAI 的 content 字段路径，确保前端 SDK 正常消费。
1、进入对应自定义平台编辑页，找到「响应体重写」区域。
2、启用「启用响应体重写」，在「重写规则」中填写：
{"id":"$.id","object":"$.object","created":"$.created","model":"$.model","choices":"$.choices","usage":"$.usage"}
3、在「响应体模板」中输入标准 OpenAI 格式模板：
{"id":"{{.id}}","object":"{{.object}}","created":{{.created}},"model":"{{.model}}","choices":[{"index":0,"message":{"role":"assistant","content":"{{.choices.0.message.content}}"},"finish_reason":"stop"}],"usage":{"prompt_tokens":{{.usage.prompt_tokens}},"completion_tokens":{{.usage.completion_tokens}},"total_tokens":{{.usage.total_tokens}}}}
4、保存配置，使用 One-API 提供的 cURL 示例再次调用，检查返回内容是否含 "role":"assistant" 与 "content" 字段。
