MiniMax Agent API接入教程

轻静同学_7567

轻静同学_7567

2026-08-14

925人浏览

原创

必须构造合法http post请求调用minimax agent,需提供agent_id和api key,缺一不可;须在控制台发布agent后获取凭证,请求url为https://api.minimax.chat/v1/text/chatcompletion,header含authorization和content-type,body含agent_id与messages数组,响应中choices[0].message.content为有效文本。

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

minimax agent api接入教程

要让自有系统调用 MiniMax Agent 的能力,必须构造合法的 HTTP POST 请求,传入 agent_id 和 API Key,并正确解析返回字段;直接复用 OpenAI SDK 配置或漏填关键字段会导致 401 或 400 错误,连基础响应都拿不到。

获取 Agent ID 和 API Key

这两项是调用 Agent 接口的硬性身份凭证,缺一不可,且必须在控制台发布 Agent 后才能拿到有效 ID。

登录 platform.minimax.chat,用实名手机号或邮箱进入开发者控制台。

左侧导航栏点击【Agent】→【创建Agent】,选择“通用对话型”模板,填写名称并输入系统提示词(例如:“你是一名电商客服,只回答订单、物流、售后类问题”),点击【保存并发布】。

发布成功后,在 Agent 详情页复制显示的 【Agent ID】(形如 agt-xxxxxx)和测试 Token(或使用项目级 API Key)。

进入【项目管理】→【API密钥管理】,确认已生成有效密钥;若未生成,点击【创建新密钥】并复制 sk-xxx 格式密钥,【立即保存至安全位置】——该密钥仅显示一次,丢失需重新生成。

构造标准 POST 请求

MiniMax Agent 接口不接受 GET 请求,也不支持 OpenAI SDK 默认 base_url 直接切换,必须手动构造完整请求。

请求 URL 固定为:https://api.minimax.chat/v1/text/chatcompletion。

Integrate Claude Agent SDK with You.com MCP server
Integrate Claude Agent SDK with You.com MCP server

将 Claude Agent SDK 与 You.com HTTP MCP 服务器集成,支持 Python 和 TypeScript。当开发者提及 Claude Agent SDK、Anthropic Agent SDK 或将 Claude 与 MCP 工具集成时使用。

下载

设置 Header 字段:Authorization: Bearer {your_api_key} 和 Content-Type: application/json。

Body 提交 JSON,必须包含以下字段:agent_id(填上一步复制的 ID)、messages(数组格式,至少含一个 {"role":"user","content":"你好"} 对象)。

注意:stream 默认为 true,若不需要流式响应,必须显式写 "stream": false;model 字段可不填——只要 Agent 已绑定默认模型,填了反而可能触发冲突校验。

解析响应并提取内容

成功调用返回 HTTP 状态码 200,响应体是标准 JSON 结构,但有效文本藏得深,不能直接渲染整个 response。

第一步:检查 status code 是否为 200;若为 4xx/5xx,根据 error.message 定位问题(常见如 “agent not published”、“invalid api key”、“quota exceeded”)。

第二步:读取响应体中 choices[0].message.content 字段值,该字段即为 Agent 生成的纯文本回复。

第三步:若需多轮对话,将历史消息(含 system、user、assistant 角色)按时间顺序追加至 messages 数组,总长度不能超过上下文限制——超长会直接被截断且不报错,只返回部分结果。

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

相关文章

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

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

下载

相关标签:

agent minimax

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

相关专题

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

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

2026.03.16

2948

9

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

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

2026.03.17

380

23

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

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

2026.03.20

169

13

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

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

2026.03.30

205

18

minimax大模型
minimax大模型

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

2026.03.31

328

24

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

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

2026.05.13

518

18

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

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

2026.05.13

443

17

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

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

2026.05.13

574

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

477

18

热门下载

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

精品课程

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