Skip to main content
POST
GPT 对话补全(全模型,完整参数)
BaseURL 说明:默认 BaseURL 为 https://direct.evolink.ai,对文本模型支持更好,支持长连接;https://api.evolink.ai 是多模态主力地址,对文本模型作为备用地址使用。
服务端工具(联网搜索、代码执行、文档检索、MCP)仅在 Responses 接口提供;Chat Completions 接口只支持普通 function 工具调用。
GPT-6:Sol / Luna 在本接口调用函数工具时,需设置 reasoning_effort: "none";Astra 与 6.1 Sol 的函数调用,以及 GPT-6 的 max 档位,请使用 Responses 接口。

授权

Authorization
string
header
必填

##所有接口均需 Bearer Token 认证##

获取 API Key:

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

添加到请求头:

请求体

application/json
model
enum<string>
必填

要调用的模型:

可用选项:
gpt-6.1-sol,
gpt-6-astra,
gpt-6-sol,
gpt-6-luna,
gpt-5.6-sol,
gpt-5.6-terra,
gpt-5.6-luna,
gpt-5.5,
gpt-5.4,
gpt-5.2,
gpt-5.1
示例:

"gpt-6.1-sol"

messages
object[]
必填

对话消息列表,支持多轮上下文与多模态输入。

role 可选 system / developer / user / assistant / tool。

content 可以是字符串,也可以是内容块数组。块类型支持 text(文本)、image_url(图像)两种:

图像

  • image_url.url 传入图片的公网 URL
  • image_url 也可直接写成字符串,等价于 { "url": "..." }
  • detail 控制图像解析精度,可选 auto(默认)/ low / high / original
  • 图片需能被正常下载,否则返回 400

注意 本接口的块类型与 Responses 接口不同(Responses 用 input_text / input_image),两者不可混用,写错会返回 400。

GPT-6 / GPT-5.6 显式缓存断点,放在内容块上;每次请求最多写入 4 个断点(隐式断点占 1 个)。 prompt_cache_breakpoint: {"mode": "explicit"}.

示例:
stream
boolean
默认值:false

是否以流式方式返回(SSE 事件流,以 data: [DONE] 结束)。默认 false。

示例:

false

max_completion_tokens
integer

生成的最大 token 数,包含推理 token。推荐使用 max_completion_tokens。GPT-6 兼容旧字段 max_tokens:仅传旧字段时会转换;同时传入时保留 max_completion_tokens 并移除 max_tokens。GPT-6 Astra / Sol / Luna 与 GPT-6.1 Sol 最大输出为 128,000 tokens。

示例:

2048

reasoning_effort
enum<string>

推理深度控制。可选值随模型不同:

推理 token 按输出 token 计费,并计入 usage.completion_tokens_details.reasoning_tokens。

GPT-6 默认使用 medium。gpt-6-astra 与 gpt-6.1-sol 不支持 none;gpt-6-sol / gpt-6-luna 支持 none。GPT-6 的 max 档位仅在 Responses 使用。

可用选项:
none,
low,
medium,
high,
xhigh
示例:

"medium"

verbosity
enum<string>

回答详略程度,可选 low / medium / high。

GPT-6 Sol / Luna 与 GPT-6.1 Sol:此参数的支持范围尚未确认,基础请求建议省略。

以下为既有模型规则(不含 GPT-6 Sol / Luna 与 GPT-6.1 Sol):

注意 gpt-6-astra、gpt-5.6-sol、gpt-5.6-terra、gpt-5.6-luna 与 gpt-5.5 支持;其余模型不支持该参数。

可用选项:
low,
medium,
high
示例:

"low"

temperature
number

采样温度,取值 0 ~ 2,值越低输出越确定。

GPT-6:gpt-6-astra 与 gpt-6.1-sol 请省略此参数;gpt-6-sol / gpt-6-luna 仅在推理档位为 none 时可调节,其他档位请省略。省略推理档位时默认为 medium,不等于 none。

既有模型:gpt-5.5 / gpt-5.4 / gpt-5.2 / gpt-5.1 支持调节;gpt-5.6 家族只接受默认值 1。

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

1

top_p
number

核采样参数,取值 0 ~ 1。建议不要与 temperature 同时调整。

GPT-6:gpt-6-astra 与 gpt-6.1-sol 请省略此参数;gpt-6-sol / gpt-6-luna 仅在推理档位为 none 时可调节,其他档位请省略。省略推理档位时默认为 medium,不等于 none。

既有模型:gpt-5.5 / gpt-5.4 / gpt-5.2 / gpt-5.1 支持调节;gpt-5.6 家族只接受默认值 1。

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

1

frequency_penalty
number

频率惩罚,取值 -2 ~ 2。正值按 token 出现频率进行惩罚,降低重复内容的概率。

GPT-6 Sol / Luna 与 GPT-6.1 Sol:此参数的支持范围尚未确认,基础请求建议省略。

以下为既有模型规则(不含 GPT-6 Sol / Luna 与 GPT-6.1 Sol):

注意 仅 gpt-5.4 / gpt-5.2 / gpt-5.1 支持调节;gpt-5.6 家族与 gpt-5.5 不支持调节。gpt-6-astra 只接受默认值 0,传入其他值会返回 400。

必填范围: -2 <= x <= 2
示例:

0

presence_penalty
number

存在惩罚,取值 -2 ~ 2。正值鼓励模型讨论新话题。

GPT-6 Sol / Luna 与 GPT-6.1 Sol:此参数的支持范围尚未确认,基础请求建议省略。

以下为既有模型规则(不含 GPT-6 Sol / Luna 与 GPT-6.1 Sol):

注意 仅 gpt-5.4 / gpt-5.2 / gpt-5.1 支持调节;gpt-5.6 家族与 gpt-5.5 不支持调节。gpt-6-astra 只接受默认值 0,传入其他值会返回 400。

必填范围: -2 <= x <= 2
示例:

0

logprobs
boolean
默认值:false

是否返回每个输出 token 的对数概率。

GPT-6:Astra 与 6.1 Sol 不支持输出 logprobs。Sol / Luna 仅在推理档位为 none 时使用;其他档位请移除 logprobs、top_logprobs,并从 Responses 的 include 中移除 message.output_text.logprobs。

以下为既有模型规则(不含 GPT-6 Sol / Luna 与 GPT-6.1 Sol):

注意 仅 gpt-5.4 / gpt-5.2 / gpt-5.1 支持;gpt-5.6 家族与 gpt-5.5 不支持该参数。

GPT-6 Astra 与 GPT-6.1 Sol 不支持该参数。

示例:

true

top_logprobs
integer

每个位置返回的候选 token 数量,取值 0 ~ 20,需与 logprobs: true 同时使用。

注意 支持范围同 logprobs。

GPT-6:Astra 与 6.1 Sol 不支持输出 logprobs。Sol / Luna 仅在推理档位为 none 时使用;其他档位请移除 logprobs、top_logprobs,并从 Responses 的 include 中移除 message.output_text.logprobs。

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

2

n
integer
默认值:1

生成的候选回复数量,返回 choices 数组中的多个结果。全部 token(含每个候选的输出)都会计费。

GPT-6 Sol / Luna 与 GPT-6.1 Sol:此参数的支持范围尚未确认,基础请求建议省略。

示例:

1

seed
integer

随机种子。相同的种子与参数组合下,模型会尽量返回一致的结果(尽力而为,不保证完全可复现)。

GPT-6 Sol / Luna 与 GPT-6.1 Sol:此参数的支持范围尚未确认,基础请求建议省略。

示例:

42

response_format
object

输出格式控制:

  • {"type": "text"}:默认的自由文本
  • {"type": "json_object"}:返回合法 JSON,要求 messages 中出现 json 字样,否则返回 400
  • {"type": "json_schema", "json_schema": {...}}:按给定 JSON Schema 输出结构化结果,配合 "strict": true 强制贴合 schema
tools
object[]

工具列表,用于 Function Calling(客户端函数调用,无按次费用)。

服务端工具(联网搜索、代码执行等)不在本接口提供,请改用 Responses 接口。

GPT-6:gpt-6-sol / gpt-6-luna 默认使用 medium 推理;只有显式设置 reasoning_effort: "none" 时,才能在 Chat Completions 中使用函数工具。gpt-6-astra 与 gpt-6.1-sol 不支持 none,函数调用请使用 Responses 接口。GPT-6 的 max 档位请使用 Responses,本接口不支持。

tool_choice

工具选择控制:"auto"(默认)/ "none" / "required",或用对象指定某个函数,如 {"type": "function", "function": {"name": "get_weather"}}。

可用选项:
none,
auto,
required
parallel_tool_calls
boolean
默认值:true

是否允许模型在一轮中并行调用多个工具。默认 true,设为 false 可强制逐个调用。

GPT-6 Sol / Luna 与 GPT-6.1 Sol:此参数的支持范围尚未确认,基础请求建议省略。

示例:

true

prompt_cache_key
string

缓存分组键。GPT-6 / GPT-5.6 自动处理缓存路由,不需要此字段来优化路由;可为不同用户或客户使用不同键,区分缓存复用与计费。同一组需复用前缀的请求应保持键一致。较早模型可使用稳定的键帮助缓存路由。

示例:

"app-chat-v1"

user
string

终端用户标识,用于区分调用来源。

示例:

"user-1024"

prompt_cache_options
object

GPT-6 与 GPT-5.6 的 Prompt 缓存配置。默认使用隐式断点;mode: "explicit" 只使用显式断点,没有断点时不缓存。

示例:

响应

对话生成成功(JSON 对象;stream=true 时为 SSE 事件流,以 data: [DONE] 结束)

id
string

本次对话的唯一标识

示例:

"chatcmpl-CvJ2p8mQxK7nR4wS"

object
enum<string>

响应类型

可用选项:
chat.completion
示例:

"chat.completion"

created
integer

创建时间戳

示例:

1786705221

model
string

实际使用的模型名称

示例:

"gpt-6.1-sol"

choices
object[]

生成结果列表(长度等于请求中的 n)

usage
object

Token 用量统计。Prompt 缓存自动生效,命中缓存的输入 token 按更低的缓存价计费。

GPT-6 按普通输入、缓存读取、缓存写入与输出分别计费。输入超过 272,000 tokens 时,整个请求的输入与两种缓存价格为常规价格的 2 倍,输出为 1.5 倍。内置生图另计费。当前价格见 模型价格。