Skip to main content
POST
GPT Responses（全模型，完整参数）
BaseURL 说明：默认 BaseURL 为 https://direct.evolink.ai，对文本模型支持更好，支持长连接；https://api.evolink.ai 是多模态主力地址，对文本模型作为备用地址使用。
服务端工具（web_search、code_interpreter、file_search、mcp）在服务端执行，无需客户端回传结果，仅在本接口提供。Chat Completions 接口只支持普通 function 工具调用。
注意 本接口仅支持同步与流式两种模式：不支持 background: true 的后台异步模式，也不提供按响应 ID 查询、取消、删除响应的端点。需要长时间生成时，请使用 stream: true 保持连接。image_generation 工具在本系列模型上不可用，图像生成请使用图像系列模型接口。
多轮对话：用上一轮返回的 id 作为下一轮的 previous_response_id 即可续接上下文。响应有留存期限，过期后该 ID 不再有效，请求会按新会话处理；对上下文准确性有强要求的场景，建议自行维护完整的 input 历史。

授权

​
Authorization
string
header
必填

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

获取 API Key：

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

添加到请求头：

请求体

application/json
​
model
enum<string>
必填

要调用的模型：

可用选项:
gpt-6-astra,
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-astra"

​
input
必填

模型输入：纯字符串，或输入项数组。

输入项的 content 支持 input_text（文本）、input_image（图像）两种块：

图像

  • image_url 传入图片的公网 URL
  • image_url 必须是字符串；写成 { "url": "..." } 会返回 400
  • detail 与 image_url 同级（不是嵌套在里面），可选 auto（默认）/ low / high / original
  • 图片需能被正常下载，否则返回 400

工具结果

  • 数组中也可回填上一轮的 function_call_output 等工具结果项

注意 本接口的块类型与 Chat Completions 接口不同（Chat 用 text / image_url），两者不可混用，写错会返回 400。

示例:

"搜索最近一周的 AI 新闻并用三句话总结。"

​
instructions
string

系统级指令，等价于在 input 最前面插入一条系统消息。使用 previous_response_id 续轮时，本参数不会从上一轮继承，需要每轮传入。

示例:

"你是一个简洁的助手，回答不超过三句话。"

​
stream
boolean
默认值:false

是否流式返回（SSE 事件流，以 response.completed 结束）。默认 false。

示例:

false

​
max_output_tokens
integer

生成的最大 token 数（含推理 token）。达到上限时 status 为 incomplete。

示例:

2048

​
reasoning
object

推理控制。

effort（推理深度）可选值随模型不同：

summary（推理摘要）：auto / concise / detailed，全系可用。开启后 output 中会出现 reasoning 项。

mode（推理模式）：standard / pro，gpt-6-astra 与 gpt-5.6 家族支持。

context（推理上下文范围）：auto / current_turn / all_turns，gpt-6-astra 与 gpt-5.6 家族支持。

推理 token 按输出 token 计费，并计入 usage.output_tokens_details.reasoning_tokens。

​
text
object

输出文本控制：

  • format：{"type": "text"}（默认）、{"type": "json_object"}，或 {"type": "json_schema", "name": "...", "schema": {...}, "strict": true} 输出结构化结果
  • verbosity：low / medium / high，控制回答详略
​
tools
object[]

工具声明。服务端工具在服务端执行，无需客户端回传结果：

同时支持普通 function 工具（客户端函数调用）。

注意 image_generation 在本系列模型上不可用，请改用图像系列模型接口。

示例:
​
tool_choice

工具选择控制："auto"（默认）/ "none" / "required"，或用对象指定某个工具，如 {"type": "web_search"}。

可用选项:
none,
auto,
required
​
max_tool_calls
integer

本次响应中允许的工具调用总次数上限。

示例:

5

​
parallel_tool_calls
boolean
默认值:true

是否允许模型在一轮中并行调用多个工具。默认 true。

注意 gpt-6-astra、gpt-5.6 家族与 gpt-5.5 支持设为 false；在 gpt-5.4 / gpt-5.2 / gpt-5.1 上该参数不生效，始终按 true 处理。

示例:

true

​
previous_response_id
string

上一轮响应的 id，用于串联多轮对话，无需重复上传历史消息。

注意 需配合 store: true（默认值）使用。响应有留存期限，过期后该 ID 不再有效；此时请求会按新会话处理，不会继承上下文。对上下文准确性有强要求的场景，建议自行维护完整的 input 历史。

示例:

"resp_0f5c2b2c20c39e8a006a7ef545443081979e478b10927984b5"

​
store
boolean
默认值:true

是否在服务端留存本次响应，留存后才能被 previous_response_id 引用。默认 true。

注意 gpt-6-astra、gpt-5.6 家族与 gpt-5.5 支持设为 false；在 gpt-5.4 / gpt-5.2 / gpt-5.1 上该参数不生效，始终按 true 处理。如不希望存储响应，请选择支持关闭存储的模型。

示例:

true

​
include
string[]

要求在响应中额外返回的内容，可选值：

  • reasoning.encrypted_content
  • message.output_text.logprobs
  • web_search_call.results
  • web_search_call.action.sources
  • file_search_call.results
  • code_interpreter_call.outputs
  • message.input_image.image_url
  • computer_call_output.output.image_url

注意 gpt-6-astra 不支持 message.output_text.logprobs。

示例:
​
temperature
number

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

注意 gpt-5.4 / gpt-5.2 / gpt-5.1 上取值 0 不生效（等同于不传，按默认值 1 处理）；需要更确定的输出请使用 0.01 等大于 0 的值。GPT-6 Astra 只接受默认值 1，传入其他值会返回 400。

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

1

​
top_p
number

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

GPT-6 Astra 只接受默认值 1，传入其他值会返回 400。

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

1

​
top_logprobs
integer

每个位置返回的候选 token 数量，取值 0 ~ 20，需配合 include: ["message.output_text.logprobs"] 使用。

注意 仅 gpt-5.6 家族与 gpt-5.5 支持；其余模型不支持该参数。

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

2

​
frequency_penalty
number

频率惩罚，取值 -2 ~ 2，降低重复内容的概率。

注意 gpt-5.6 家族支持调节；其余既有模型不支持该参数。GPT-6 Astra 不支持调节，只接受默认值 0，传入其他值会返回 400。

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

0

​
presence_penalty
number

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

注意 gpt-5.6 家族支持调节；其余既有模型不支持该参数。GPT-6 Astra 不支持调节，只接受默认值 0，传入其他值会返回 400。

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

0

​
truncation
enum<string>
默认值:disabled

上下文超出窗口时的处理方式：disabled（默认，直接报错）或 auto（自动截断中间内容）。

可用选项:
auto,
disabled
示例:

"auto"

​
context_management
object[]

长会话自动压缩配置，例如 [{"type": "compaction", "compact_threshold": 100000}]：上下文超过阈值时自动压缩历史。

注意 仅 gpt-6-astra 与 gpt-5.6 家族支持；其余模型不支持该参数。

​
prompt_cache_key
string

缓存分组键。为同一类前缀相同的请求传入相同的值，可提升 Prompt 缓存命中率。

示例:

"app-agent-v1"

​
prompt_cache_retention
enum<string>

Prompt 缓存保留策略：in_memory（默认）或 24h（延长缓存留存时间）。

可用选项:
in_memory,
24h
示例:

"in_memory"

​
prompt
object

引用已创建的 Prompt 模板，形如 {"id": "pmpt_xxx", "version": "1", "variables": {...}}。

​
metadata
object

自定义键值对，随响应原样返回，便于业务侧标记。键与值均为字符串。

示例:
​
safety_identifier
string

终端用户的稳定标识，用于滥用行为追踪。

注意 仅 gpt-6-astra 与 gpt-5.6 家族支持；其余模型不支持该参数。

示例:

"user-1024"

​
user
string

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

示例:

"user-1024"

响应

响应生成成功（JSON 对象；stream=true 时为 SSE 事件流，以 response.completed 结束）

​
id
string

响应的唯一标识，可作为下一轮的 previous_response_id

示例:

"resp_0f5c2b2c20c39e8a006a7ef545443081979e478b10927984b5"

​
object
enum<string>

响应类型

可用选项:
response
示例:

"response"

​
status
enum<string>

响应状态：completed 正常结束，incomplete 因达到 max_output_tokens 等原因未写完，failed 生成失败

可用选项:
completed,
incomplete,
failed
示例:

"completed"

​
model
string

实际使用的模型名称

示例:

"gpt-6-astra"

​
created_at
integer

创建时间戳

示例:

1786705221

​
output
object[]

按生成顺序排列的输出项：reasoning 项（推理摘要 / 加密推理内容）、工具调用项（如 web_search_call、code_interpreter_call），以及最后含 output_text 内容的 message 项。

​
incomplete_details
object

status 为 incomplete 时说明原因

​
usage
object

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

​
metadata
object

请求中传入的自定义键值对，原样返回