跳转到主要内容
POST
/
v1
/
messages
curl --request POST \
  --url https://direct.evolink.ai/v1/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "MiniMax-M3",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "你好,世界"
    }
  ]
}
'
{
  "id": "066a381bdc3c0ded310e27c9a46d16e7",
  "type": "message",
  "role": "assistant",
  "model": "MiniMax-M3",
  "content": [
    {
      "type": "thinking",
      "thinking": "用户问的是日本首都,这是基础地理知识问题,答案是东京,直接给出即可。",
      "signature": "066a381bdc3c0ded310e27c9a46d16e7"
    },
    {
      "type": "text",
      "text": "日本的首都是**东京**。"
    }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 7,
    "output_tokens": 77,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.evolink.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

授权

Authorization
string
header
必填

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

获取 API Key

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

使用时在请求头中添加

Authorization: Bearer YOUR_API_KEY

备注:虽然 Anthropic 原生 API 使用 x-api-key 头,EvoLink 对 /v1/messages 统一采用 Bearer Token 鉴权。

请求体

application/json
model
enum<string>
必填

要调用的模型

可用选项:
MiniMax-M3
示例:

"MiniMax-M3"

messages
object[]
必填

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

说明

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

指定生成内容长度的上限(Token 数)

说明

  • MiniMax-M3 推荐 131,072(128K),上限 524,288(512K)
  • thinking 产生的 token 也计入该上限
  • 超过上限的内容会被截断;如果生成因 length 原因中断,请尝试调高此值
必填范围: 1 <= x <= 524288
示例:

1024

system

系统提示词,用于设定 AI 角色与行为

说明

  • 支持字符串或字符串数组
  • 不同于 OpenAI 端点的 system 消息,Anthropic 端点使用顶层 system 字段
示例:

"You are a helpful assistant."

temperature
number
默认值:1

采样温度

说明

  • 范围 [0, 2]
  • 默认 1;值越高越发散,越低越确定
必填范围: 0 <= x <= 2
示例:

1

top_p
number
默认值:0.95

核采样阈值

说明

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

0.95

stream
boolean
默认值:false

是否以 SSE 流式返回

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

false

thinking
object

控制深度思考。启用 thinking 后,多轮对话中需要原样回带 thinking 块

说明

  • 默认 adaptive:模型根据问题难度自适应决定是否深度思考
  • 启用时响应 content 数组中会出现 type="thinking" 的推理过程 block(按输出 token 计费)
tools
object[]

工具定义列表

说明

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

工具选择策略。仅支持 auto 和 none

metadata
object

请求元数据

响应

消息对象

Anthropic 风格的消息响应

id
string

消息唯一 ID

type
enum<string>

响应对象类型

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

实际使用的模型

示例:

"MiniMax-M3"

content
object[]

响应内容块列表

可能包含的 block type

  • thinking:推理过程(仅 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 规范)