跳转到主要内容
POST
/
v1
/
chat
/
completions
智能模型路由
curl --request POST \
  --url https://api.evolink.ai/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "evolink/auto",
  "messages": [
    {
      "role": "user",
      "content": "介绍一下人工智能的发展历史"
    }
  ],
  "temperature": 0.7,
  "top_p": 0.9,
  "top_k": 40,
  "stream": false
}
'
{
  "id": "chatcmpl-20260308112637503180122ABCD1234",
  "model": "gpt-5.4",
  "object": "chat.completion",
  "created": 1741428397,
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "人工智能的发展历史可以追溯到20世纪50年代..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 15,
    "completion_tokens": 120,
    "total_tokens": 135
  }
}

功能介绍

EvoLink Auto 是智能模型路由功能,系统会根据您的请求内容自动选择最合适的 AI 模型,无需手动指定具体模型。

核心优势

  • 智能匹配:自动分析请求内容,选择最适合的模型处理
  • 成本优化:在保证质量的前提下,优先选择性价比高的模型
  • 负载均衡:自动在多个模型间分配请求,提高系统稳定性
  • 透明可见:响应中返回实际使用的模型名称,方便追踪和优化

使用场景

适用于不确定使用哪个模型,或希望系统自动优化模型选择的场景。
只需将 model 参数设置为 evolink/auto,系统将自动为您选择最合适的模型。

授权

Authorization
string
header
必填

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

获取 API Key:

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

使用时在请求头中添加:

Authorization: Bearer YOUR_API_KEY

请求体

application/json
model
enum<string>
默认值:evolink/auto
必填

使用智能路由

可用选项:
evolink/auto
示例:

"evolink/auto"

messages
object[]
必填

对话消息列表

Minimum array length: 1
示例:
[
{
"role": "user",
"content": "介绍一下人工智能的发展历史"
}
]
temperature
number

采样温度,控制输出的随机性

说明:

  • 较低值(如 0.2): 更确定、更聚焦的输出
  • 较高值(如 1.5): 更随机、更有创意的输出
必填范围: 0 <= x <= 2
示例:

0.7

top_p
number

核采样(Nucleus Sampling)参数

说明:

  • 控制从累积概率前多少的token中采样
  • 例如 0.9 表示从累积概率达到90%的token中选择
  • 默认值: 1.0(考虑所有token)

建议: 不要同时调整 temperature 和 top_p

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

0.9

top_k
integer

Top-K 采样参数

说明:

  • 例如 10 表示限制每次采样时只考虑概率最高的 10 个 token
  • 较小的值会使输出更加聚焦
  • 默认不限制
必填范围: x >= 1
示例:

40

stream
boolean
默认值:false

是否以流式方式返回响应

  • true: 流式返回,逐块实时返回内容
  • false: 等待完整响应后一次性返回
示例:

false

响应

请求成功

id
string

对话完成的唯一标识符

示例:

"chatcmpl-20260308112637503180122ABCD1234"

model
string

实际使用的模型名称

示例:

"gpt-5.4"

object
enum<string>

响应类型

可用选项:
chat.completion
示例:

"chat.completion"

created
integer

创建时间戳

示例:

1741428397

choices
object[]

对话生成的选择列表

usage
object

Token 使用统计信息