Minimax 怎么对接开源的 One-API 平台?

老丽吖_6144

老丽吖_6144

2026-03-22

1038人浏览

原创

需通过one-api自定义平台配置minimax模型:一、在minimax控制台获取api key和group id并授权模型;二、在one-api添加自定义平台,设置基础url、请求头及模型路径;三、配置请求体重写以适配minimax字段;四、必要时部署nginx反向代理解决tls或网络限制;五、启用响应体重写,将minimax返回格式映射为openai兼容结构。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

minimax 怎么对接开源的 one-api 平台?

如果您希望将 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:

MiniMax Provider 配置
MiniMax Provider 配置

为 OpenClaw 配置 MiniMax 作为模型源。MiniMax 提供两种接入方式:API Key 直连(openai-completions 协议)和 OAuth 门户(anthropic-messages 协议)。包含 provider 注册、模型定义、别名配置、fallback 链接入和验证的完整流程。当管理员说想"加 MiniMax"、"配 minimax"、"接入 MiniMax 模型"、"加海螺模型"、&qu

下载

{"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" 字段。

大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

minimax

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
minimax入口地址汇总
minimax入口地址汇总

本专题整合了minimax相关入口合集,阅读专题下面的文章了解更多详细地址。

2026.03.16

3128

9

minimax视频生成教程汇总
minimax视频生成教程汇总

本专题整合了minimax生成视频相关教程,阅读下面的文章了解更多详细操作。

2026.03.17

400

23

Minimax生成视频提示词和小技巧
Minimax生成视频提示词和小技巧

本专题整合了Minimax生成好的视频教程合集,阅读专题下面的文章了解更多详细内容。

2026.03.20

189

13

Minimax API接口合集
Minimax API接口合集

本专题整合了Minimax API接口相关教程,阅读专题下面的文章了解更多详细步骤。

2026.03.30

225

18

minimax大模型
minimax大模型

本专题整合了minimax大模型官网入口地址、升级内容等等内容,阅读专题下面的文章了解更多详细内容。

2026.03.31

348

24

Minimax海螺AI视频生成完全攻略
Minimax海螺AI视频生成完全攻略

围绕当前最热门的 AI 视频生成需求,全面讲解 Minimax 海螺 AI 视频生成的使用方法,涵盖文本生成视频(Text-to-Video)的场景描述与镜头语言提示词编写、图片生成视频(Image-to-Video)的首帧构图与运动方向控制、视频风格(写实/动漫/电影/3D)切换技巧、生成效果的常见问题(人物变形/动作不连贯)优化策略、热门爆款视频的创作思路拆解,帮助创作者与运营人员用 AI 高效产出吸睛短视频内容。

2026.05.13

558

18

Minimax语音克隆与AI配音实战合集
Minimax语音克隆与AI配音实战合集

聚焦 Minimax 语音技术中最受关注的声音克隆与 AI 配音应用,讲解声音克隆(Voice Clone)的录制要求与上传流程、少量样本即可定制专属音色的操作步骤、克隆音色的自然度与相似度优化技巧、中英文及多语种语音合成效果调控、情感化朗读(开心/悲伤/激昂/低沉)的参数设置,以及在短视频配音、有声读物批量制作、播客节目生成、电商产品口播、企业培训课件配音等热门场景中的实操应用。

2026.05.13

463

17

Minimax 注册与快速入门指南
Minimax 注册与快速入门指南

面向 AI 工具新手,从 Minimax 的账号注册、海螺 AI(Hailuo AI)网页端与移动端使用讲起,介绍 Minimax 大模型家族(abab 系列语言模型、语音模型、视频模型)的能力定位与产品矩阵、智能对话的基本使用技巧、角色扮演与长文本处理功能体验、免费额度与订阅方案说明,帮助用户快速了解 Minimax 平台全貌并高效上手使用。

2026.05.13

594

13

Minimax API 开发与多模态集成合集
Minimax API 开发与多模态集成合集

系统讲解 Minimax 开放平台 API 的开发与集成方法,涵盖 API Key 申请与鉴权机制、Chat Completion 文本对话接口的参数配置(temperature/top_p/tokens_to_generate)与多轮对话管理、流式输出(SSE Streaming)实现、Text-to-Speech(T2A)语音合成接口与音色选择、视频生成(Video Generation)接口调用与任务状态查询、Embeddings

2026.05.13

497

18

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程