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(内置生图工具)目前仅 gpt-6-astra / gpt-6.1-sol / gpt-6-sol / gpt-6-luna 支持,其余模型不可用;单独生成图像也可使用图像系列模型接口。
用 gpt-6-astra / gpt-6.1-sol / gpt-6-sol / gpt-6-luna 直接出图:在 tools 中声明 {"type": "image_generation"},模型会在对话中按需生成图片。
  • 选择图像模型:用工具的 model 字段指定,可选 gpt-image-2(默认)、gpt-image-2.5-sunburst、gpt-image-2.5-flare;quality、size、partial_images 等参数与图像模型的官方参数一致(xhigh / max 两档仅 2.5 系列可用)
  • 获取图片:图片以 base64 返回在 output 中 type 为 image_generation_call 的输出项的 result 字段,不是 URL,请自行保存
  • 图生图:在 input 中附带 input_image(公网 URL 或 data:image/png;base64,...),并在文字中说明修改要求
  • 多轮改图:用上一轮的 id 作为 previous_response_id,直接描述要怎么改
  • 流式:设置 partial_images(0-3)可在生成过程中收到预览图事件 response.image_generation_call.partial_image
  • 张数上限:未传 max_tool_calls 时,单次请求最多生成 4 张;需要更多请显式设置
  • 计费:文本与图像生成分别按 token 收费;图像生成的 token 用量见响应中的 tool_usage.image_gen
多轮对话:用上一轮返回的 id 作为下一轮的 previous_response_id 即可续接上下文。响应有留存期限,过期后该 ID 不再有效,请求会按新会话处理;对上下文准确性有强要求的场景,建议自行维护完整的 input 历史。

授权

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"

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。

GPT-6 Astra / Sol / Luna 与 GPT-6.1 Sol 最大输出为 128,000 tokens,此预算包含推理 token。

示例:

2048

reasoning
object

推理控制。

effort(推理深度)可选值随模型不同:

summary(推理摘要):auto / concise / detailed。

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

mode(推理模式):standard / pro,gpt-6-astra / gpt-6-sol / gpt-6-luna 与 gpt-5.6 家族支持。

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

context(推理上下文范围):auto / current_turn / all_turns,gpt-6-astra 与 gpt-5.6 家族支持。

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

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

GPT-6 Sol / Luna 已支持:model 可选 gpt-6-sol 或 gpt-6-luna,上下文窗口为 1,050,000 tokens,最大输出 128,000 tokens(含推理)。reasoning.effort 支持 none、low、medium(默认)、high、xhigh、max;Astra 与 6.1 Sol 不支持 none。需要推理与工具调用时,使用本接口。

text
object

输出文本控制:

  • format:{"type": "text"}(默认)、{"type": "json_object"},或 {"type": "json_schema", "name": "...", "schema": {...}, "strict": true} 输出结构化结果
  • verbosity:low / medium / high,控制回答详略

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

tools
object[]

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

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

注意 image_generation 仅 gpt-6-astra / gpt-6.1-sol / gpt-6-sol / gpt-6-luna 支持,其余模型不可用;单独生成图像请使用图像系列模型接口。

示例:
tool_choice

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

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

本次响应中允许的工具调用总次数上限(所有内置工具合计)。

注意 gpt-6-astra / gpt-6.1-sol / gpt-6-sol / gpt-6-luna 使用 image_generation 且未传该参数时,单次请求最多生成 4 张图;需要更多请显式设置。

示例:

5

parallel_tool_calls
boolean
默认值:true

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

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

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

注意 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 Sol / Luna 与 GPT-6.1 Sol:store: false 关闭留存的行为尚未完成渠道实测,不能据此字段已被接收就认定响应未被留存。

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

注意 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 与 gpt-6.1-sol 不支持 message.output_text.logprobs。

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

示例:
temperature
number

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

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

既有模型:gpt-5.4 / gpt-5.2 / gpt-5.1 上 temperature: 0 按默认值 1 处理;需要更确定的输出时可使用 0.01 等大于 0 的值。

必填范围: 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。

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

1

top_logprobs
integer

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

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.6 家族与 gpt-5.5 支持;其余模型不支持该参数。

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

2

frequency_penalty
number

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

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

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

注意 gpt-5.6 家族支持调节;其余既有模型不支持该参数。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.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-6-sol / gpt-6-luna 与 gpt-5.6 家族支持;其余模型不支持该参数。

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

prompt_cache_key
string

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

示例:

"app-agent-v1"

prompt_cache_retention
enum<string>

旧模型的缓存保留策略。GPT-6 / GPT-5.6 请使用 prompt_cache_options.ttl: "30m",不要把 24h 写入新字段。

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

"in_memory"

prompt
object

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

metadata
object

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

示例:
safety_identifier
string

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

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

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

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

示例:

"user-1024"

user
string

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

示例:

"user-1024"

prompt_cache_options
object

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

示例:

响应

响应生成成功(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.1-sol"

created_at
integer

创建时间戳

示例:

1786705221

output
object[]

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

incomplete_details
object

status 为 incomplete 时说明原因

usage
object

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

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

tool_usage
object

内置工具用量。使用 image_generation 时,image_gen 为图像生成消耗的 token,与 usage 分开统计、分开按 token 收费

metadata
object

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