跳转到主要内容
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": "gpt-5.1",
  "messages": [
    {
      "role": "user",
      "content": "请介绍一下你自己"
    }
  ],
  "temperature": 1
}
'
{
  "id": "chatcmpl-abc123",
  "model": "gpt-5.1",
  "object": "chat.completion",
  "created": 1698999496,
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "你好!有什么我可以帮助你的吗?",
        "reasoning_content": "让我一步一步思考这个问题..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 8,
    "completion_tokens": 292,
    "total_tokens": 300
  }
}

授权

Authorization
string
header
必填

所有接口均需要 Bearer Token 认证

获取 API Key:

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

添加到请求头:

Authorization: Bearer YOUR_API_KEY

请求体

application/json
model
enum<string>
必填

用于聊天补全的模型名称

  • gpt-5.1:基础模型,适用于通用任务
  • gpt-5.1-chat:对话优化版,针对会话场景进行优化
  • gpt-5.1-thinking:推理增强版,支持思维链输出(返回 reasoning_content 字段)
可用选项:
gpt-5.1,
gpt-5.1-chat,
gpt-5.1-thinking
示例:

"gpt-5.1"

messages
object[]
必填

对话消息列表,支持多轮对话和多模态输入

Minimum array length: 1
stream
boolean
默认值:false

是否启用流式响应

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

false

max_tokens
integer

生成响应的最大 token 数量

必填范围: x >= 1
示例:

2000

temperature
number
默认值:1

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

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

1

top_p
number
默认值:1

核采样参数

  • 控制从累积概率最高的 token 中进行采样
  • 例如 0.9 表示从累积概率前 90% 的 token 中采样
必填范围: 0 <= x <= 1
示例:

0.9

frequency_penalty
number
默认值:0

频率惩罚系数,取值范围 -2.0 到 2.0

  • 正值会根据 token 在文本中的出现频率进行惩罚,降低重复内容的概率
必填范围: -2 <= x <= 2
示例:

0

presence_penalty
number
默认值:0

存在惩罚系数,取值范围 -2.0 到 2.0

  • 正值会根据 token 是否已出现在文本中进行惩罚,鼓励模型讨论新话题
必填范围: -2 <= x <= 2
示例:

0

stop

停止序列,生成内容遇到这些序列时将停止

tools
object[]

用于 Function Calling 的工具列表

响应

聊天补全成功

id
string

本次聊天补全的唯一标识符

示例:

"chatcmpl-abc123"

model
string

实际使用的模型名称

示例:

"gpt-5.1"

object
enum<string>

响应对象类型

可用选项:
chat.completion
示例:

"chat.completion"

created
integer

响应创建时间(Unix 时间戳)

示例:

1698999496

choices
object[]

生成的补全选项列表

usage
object

Token 使用量统计