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

使用时在请求头中添加:

请求体

application/json
model
enum<string>
必填

模型 ID

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

"MiniMax-M3.1-Flash"

input
必填

模型输入

  • 字符串形态:整段文本按一条 user 消息处理
  • 数组形态:输入项列表,支持 message、function_call、function_call_output、reasoning

多模态:在 message 项的 content 数组里混合 input_text、input_image、input_video 块。

多轮对话:接口无状态,续接对话必须把完整历史放进数组。

示例:

"Explain recursion in one sentence."

instructions
string

系统级指令,等价于插入在最前面的一条 system 消息,用于设定角色、语气与输出约束。

示例:

"You are a technical documentation assistant. Keep your answers concise."

stream
boolean
默认值:false

是否流式返回

  • false(默认):一次性返回完整响应对象
  • true:以语义化 SSE 事件推送,终止事件为 response.completed,不会发送 [DONE]
示例:

false

max_output_tokens
integer

本次生成的最大输出 token 数,包含思考和回答

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

131072

reasoning
object

思考配置。MiniMax-M3.1-Flash 始终进行思考,思考内容以 reasoning 输出项返回,其 token 计入输出并按输出价计费。

temperature
enum<number>
默认值:1

采样温度,固定为 1

可用选项:
1
示例:

1

top_p
number
默认值:0.95

核采样阈值,默认 0.95。

必填范围: 0 <= x <= 1
示例:

0.95

tools
工具定义 · object[]

可供模型调用的工具列表,目前只支持 function 类型。函数由客户端执行,并把结果以 function_call_output 输入项回传。

tool_choice
enum<string>
默认值:auto

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

可用选项:
auto
示例:

"auto"

text
object

文本输出格式配置,format.type 仅支持 text

metadata
object

请求元数据,键和值都是字符串

响应

生成成功

Responses 接口的响应对象。除下列字段外,响应还会回显本次请求的配置(tools、tool_choice、temperature、top_p、text、reasoning、max_output_tokens 等)。

id
string

本次响应的唯一标识

示例:

"072514d63605b7a0c83f1672230c398c"

object
string

对象类型,固定为 response

示例:

"response"

created_at
integer

创建时间,Unix 时间戳(秒)

示例:

1792401878

status
enum<string>

响应状态

  • completed:正常完成
  • incomplete:被截断,原因见 incomplete_details
  • failed:生成失败,原因见 error
可用选项:
completed,
incomplete,
failed
示例:

"completed"

model
string

实际生成本次响应的模型 ID

示例:

"MiniMax-M3.1-Flash"

output
object[]

输出项列表,按生成顺序排列:

  • reasoning:思考过程,id 形如 <id>_rs,含 content(reasoning_text 块列表)、summary(空数组)、encrypted_content
  • message:最终回答,id 形如 <id>_msg,含 content(output_text 块列表)
  • function_call:模型发起的函数调用,id 形如 <id>_fc_<序号>,含 call_id、name、arguments,需客户端执行后以 function_call_output 回传
output_text
string | null

便捷字段:所有 output_text 文本拼接后的结果;没有文本输出时为 null

error
object | null

失败原因,成功时为 null

incomplete_details
object | null

截断原因,未截断时为 null。reason 为 max_output_tokens(输出达到上限)或 content_filter(内容安全)

usage
object

Token 使用统计信息(含缓存与思考分项)