Skip to main content
POST
BaseURL 说明:默认 BaseURL 为 https://direct.evolink.ai,对文本模型支持更好,支持长连接;https://api.evolink.ai 是多模态主力地址,对文本模型作为备用地址使用。

授权

Authorization
string
header
必填

所有接口均需要使用 Bearer Token 进行认证

获取 API Key:

访问 API Key 管理页面 获取您的 API Key

使用时在请求头中添加:

备注:EvoLink 对 /v1/messages 统一采用 Bearer Token 鉴权。

请求体

application/json
model
enum<string>
必填

要调用的模型

可用选项:
MiniMax-M3.1-Flash
示例:

"MiniMax-M3.1-Flash"

messages
object[]
必填

对话消息列表,按轮次 user / assistant 交替

说明:

  • 至少包含 1 条消息
  • 最后一条消息通常为 role=user
Minimum array length: 1
max_tokens
integer

生成内容长度上限(Token 数),包含思考和回答

说明:

  • 推荐 131,072(128K),最大 524,288(512K)
  • 取值过小时可能在思考阶段就达到上限,返回 stop_reason=max_tokens 且没有 text 内容
必填范围: 1 <= x <= 524288
示例:

131072

system

系统提示词,用于设定 AI 角色与行为。支持字符串或文本内容块数组,通过顶层 system 字段传入。

示例:

"You are a helpful assistant."

temperature
number
默认值:1

采样温度

说明:

  • 范围 [0, 2],默认 1
  • 值越高越发散,越低越确定
  • 建议不要同时调整 temperature 与 top_p
必填范围: 0 <= x <= 2
示例:

1

top_p
number
默认值:0.95

核采样阈值

说明:

  • 范围 [0, 1],默认 0.95
  • 建议不要同时调整 temperature 与 top_p
必填范围: 0 <= x <= 1
示例:

0.95

stream
boolean
默认值:false

是否以 SSE 流式返回

  • true:Server-Sent Events 流式返回
  • false:完整响应后一次性返回(默认)
示例:

false

thinking
object

思考模式。MiniMax-M3.1-Flash 始终进行思考,仅支持 adaptive,可省略。思考内容以 type="thinking" 的 block 返回,按输出 token 计费

output_config
object

输出配置

tools
object[]

工具定义列表

说明:

  • 遵循 Anthropic tool 定义规范
  • input_schema 使用 JSON Schema 对象
tool_choice
object

工具选择策略,仅支持 auto(由模型决定是否调用工具)

metadata
object

请求元数据

响应

消息对象

Anthropic 风格的消息响应

id
string

消息唯一 ID

type
enum<string>

响应对象类型

可用选项:
message
role
enum<string>
可用选项:
assistant
model
string

实际使用的模型

示例:

"MiniMax-M3.1-Flash"

content
object[]

响应内容块列表

可能包含的 block type:

  • thinking:思考过程(简单问题可能不产生)
  • text:最终回答文本
  • tool_use:模型发起的工具调用
stop_reason
enum<string>

停止原因

  • end_turn:自然结束
  • max_tokens:达到 max_tokens 上限
  • tool_use:模型触发工具调用
可用选项:
end_turn,
max_tokens,
tool_use
usage
object

Token 使用统计(Anthropic 规范)

base_resp
object

状态码和错误详情