需完成身份认证、API端点配置及请求构造:一、获取API密钥与项目ID;二、配置HTTP请求头(Authorization、Content-Type、x-group-id);三、调用/v1/chat/completions接口并构造JSON请求体;四、处理200成功响应或400/401/429等错误码;五、可选启用SSE流式响应。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜

如果您希望在应用程序中集成Minimax API以调用其大模型服务,则需要完成身份认证、API端点配置及请求构造等基础步骤。以下是具体接入流程:
一、获取API密钥与项目ID
Minimax平台要求每个调用方通过API Key和Group ID(或Project ID)进行身份验证,这些凭证用于鉴权和配额管理,必须在安全环境中存储,不可硬编码于前端代码中。
1、登录Minimax开发者控制台(https://www.minimaxi.com/console)。
2、进入“API密钥管理”页面,点击“创建新密钥”。
3、填写密钥名称,选择所属项目,确认后系统生成API Key与Group ID,请立即复制并保存至本地安全位置。
二、配置HTTP请求头
所有API请求必须携带标准认证头字段,Minimax使用Bearer Token机制校验身份,缺少任一头部将返回401错误。
1、设置请求头Authorization为Bearer {your_api_key},其中{your_api_key}替换为第一步获取的密钥值。
2、设置请求头Content-Type为application/json。
3、设置请求头x-group-id为{your_group_id},该值与API Key绑定,不可混用。
三、调用文本生成接口
Minimax提供/v1/chat/completions端点用于多轮对话式文本生成,需按OpenAI兼容格式组织请求体,支持system、user、assistant角色消息。
1、构造POST请求,目标URL为https://api.minimaxi.com/v1/chat/completions。
2、在请求体JSON中指定model字段,例如"abab6.5s"或"abab6.5t",具体型号参见控制台模型列表。
3、在messages数组中添加至少一条{"role": "user", "content": "你好"}对象。
4、可选设置temperature(0.0–1.0)、max_tokens(正整数)等参数控制输出行为。
四、处理响应与错误码
成功响应为200状态码,结构包含choices[0].message.content字段;失败响应含标准HTTP状态码与error.message字段,便于定位问题。
1、检查HTTP状态码:400表示请求体格式错误,401表示密钥无效或过期,429表示超出速率限制。
2、解析响应JSON,提取choices[0].message.content作为模型输出文本。
3、若返回"error": {"code": "invalid_api_key", "message": "..."} ,请重新核对API Key与Group ID是否匹配且未被禁用。
五、启用流式响应(SSE)
对于长文本生成场景,Minimax支持Server-Sent Events协议逐块返回token,降低首字延迟,适用于实时对话界面。
1、在请求URL末尾添加查询参数?stream=true,即完整地址为https://api.minimaxi.com/v1/chat/completions?stream=true。
2、设置请求头Accept为text/event-stream。
3、逐行读取响应体,每行以data:开头,解析JSON后提取choices[0].delta.content拼接完整结果。









