青云TOP API使用教程&开发文档小白用户&专业开发者快速使用指南
控制台
返回模型调用 API 参考
POST/v1/responses/compact

Responses 上下文压缩

条件开放的 `POST /v1/responses/compact` 可将较长的 Responses 输入压缩成后续调用可重用的项目；它不是普通 Responses 请求的必经步骤。

API Key application/json

功能与开放范围

仅当所选模型和上游渠道支持该动作时才能使用。路由可能返回模型/渠道不支持错误；遇到错误时改由应用端保留必要的对话项目并继续使用普通 POST /v1/responses。不要把压缩成功或输入输出比例当作固定承诺。

支持模型与组合

请求至少包含当前有权限使用的 model 与要压缩的 input。模型必须与输入历史兼容；不要只传从旧响应对象猜出的 ID，也不要依赖本站未公开的 Response 查询接口。

第一步：设置鉴权

使用青云TOP API 的 API Key：Authorization: Bearer YOUR_API_KEY，替换占位符并保留 Bearer 后的空格。

第二步：提交待压缩上下文

发送 POST https://top.qingyuntop.ai/v1/responses/compact，设置 JSON Content-Type。示例使用简短文本演示请求形状；实际应用应将自己保存的、需要继续使用的完整历史项目提交给该接口。

Responses API

调用与返回说明

OpenAI 新项目的首选模型调用协议。它以 output 项目表达文本、工具调用和推理结果，不能按 Chat Completions 的 choices 结构读取。

请求时注意

  • 模型 ID 不要从示例中照抄。先调用 GET /v1/models，再选择返回列表中实际可用且支持当前协议的完整 ID。
  • Responses API 的 input 可以是字符串，也可以是带 role/content 的输入项目数组；图片、文件和工具调用必须使用官方规定的输入项目类型。
  • 不要把 Chat Completions 的 choices、message 或 delta 结构混用于 Responses API。

返回时注意

  • 先检查 HTTP 状态码，再检查 response.status。只有 status=completed 才应视为完整成功；incomplete、failed 等状态必须进入业务失败或补偿流程。
  • 文本优先读取 SDK 的 response.output_text；直接 HTTP 客户端应遍历 output，并提取 message 内容中的 output_text 项。
Request

请求

/v1/responses/compact

Body

必填
Bodyapplication/json
Bodyobject
modelstring必填

模型 ID。本站账号可用模型以模型列表和实际权限为准；示例使用 gpt-6-astra。

示例gpt-6-astra
inputoneOf必填

文本或输入项目数组；数组可包含 user/developer 消息、input_text、input_image、input_file。

满足其中一个分支
分支 1string
示例用一句话介绍青云TOP API。
instructionsstring

作为开发者指令加入本次上下文；与 previous_response_id 一起使用时不会自动继承上一轮指令。

previous_response_idstring

用于多轮状态；仅在上游/渠道保留 Responses 状态时可用，失败时改用完整 input 历史。

Response

返回响应 200

压缩结果
响应 200application/json
响应 200object
idstring必填

响应唯一标识。需要关联或排查请求时保存它。

示例resp_...
objectstring必填

固定为 response。不要用 choices 判断 Responses API 的返回。

固定值：response
statusstring必填

响应状态，常见值包括 completed、incomplete、failed、in_progress。业务成功判定应检查此字段。

可选值：queued、in_progress、completed、failed、incomplete
modelstring

实际使用的模型 ID。

示例gpt-6-astra
outputarray<oneOf>必填
元素array<object>

输出项目数组，可能包含 message、function_call、reasoning 等不同类型。

满足其中一个分支
分支 1object
idstring

响应唯一标识。需要关联或排查请求时保存它。

示例msg_...
typeunknown必填
固定值：message
roleunknown必填
固定值：assistant
contentarray<object>必填
元素object
typeunknown必填
固定值：output_text
textstring必填
annotationsarray<object>
元素object
errorobject|null

失败信息。HTTP 200 仍可能对应 failed 或 incomplete 状态，必须同时检查此字段。

incomplete_detailsobject|null

响应未完成时的原因和细节。

usageobject

token 用量，通常包含 input_tokens、output_tokens、total_tokens 及其 details。

input_tokensinteger
output_tokensinteger
total_tokensinteger
Responses API

调用与返回说明

OpenAI 新项目的首选模型调用协议。它以 output 项目表达文本、工具调用和推理结果，不能按 Chat Completions 的 choices 结构读取。

请求时注意

  • 模型 ID 不要从示例中照抄。先调用 GET /v1/models，再选择返回列表中实际可用且支持当前协议的完整 ID。
  • Responses API 的 input 可以是字符串，也可以是带 role/content 的输入项目数组；图片、文件和工具调用必须使用官方规定的输入项目类型。
  • 不要把 Chat Completions 的 choices、message 或 delta 结构混用于 Responses API。

返回时注意

  • 先检查 HTTP 状态码，再检查 response.status。只有 status=completed 才应视为完整成功；incomplete、failed 等状态必须进入业务失败或补偿流程。
  • 文本优先读取 SDK 的 response.output_text；直接 HTTP 客户端应遍历 output，并提取 message 内容中的 output_text 项。

常见错误与参考

404/400：检查当前模型是否开放 compact、路径是否完整以及输入项目是否有效；401：检查本站 API Key；413：缩短输入并核对渠道限制。压缩并不代替应用自己的数据保留策略。

Responses compact 官方参考 · 创建 Response