Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
164 changes: 82 additions & 82 deletions docs/zh/.translation-manifest.json

Large diffs are not rendered by default.

806 changes: 408 additions & 398 deletions docs/zh/api/docs/changelog.md

Large diffs are not rendered by default.

44 changes: 22 additions & 22 deletions docs/zh/api/docs/guides/background.md
Original file line number Diff line number Diff line change
@@ -1,22 +1,22 @@
# 后台模式
# Background mode

> 如需完整的文档索引,请参阅 [llms.txt](/llms.txt). 文档页面的 Markdown 版本可通过在页面 URL 后追加 `.md` 获得
> 如需查看完整文档索引,请参阅 [llms.txt](/llms.txt)文档页面的 Markdown 版本可通过在页面 URL 后追加 `.md` 来获取

智能体 [Codex](https://openai.com/index/introducing-codex/) 和 [Deep Research](https://openai.com/index/introducing-deep-research/) 都表明推理模型可能要花费数分钟来解决复杂问题。后台模式可让你在 GPT-5.2 和 GPT-5.2 Pro 等模型上可靠地执行长时间运行的任务,无需担心超时或其他连接问题
智能体,例如 [Codex](https://openai.com/index/introducing-codex/) 和 [Deep Research](https://openai.com/index/introducing-deep-research/) 表明推理模型可能需要数分钟才能解决复杂问题。后台模式使你能够在 GPT-5.2 和 GPT-5.2 Pro 等模型上可靠地执行长时间运行的任务,而无需担心超时或其他连接问题

后台模式会异步启动这些任务,开发者可以轮询响应对象来随时查看状态。若要在后台启动响应生成,请发起一个 API 请求,并附带 `background` 设置为 `true`:
后台模式会异步启动这些任务,开发者可以轮询响应对象以随时查看状态。要在后台启动响应生成,请发出包含以下内容的 API 请求 `background` 设置为 `true`:

零数据留存 (ZDR) 项目发起的后台请求会使用
`store=false`。运行。响应数据会临时存储到磁盘约 10
分钟,以便异步执行和轮询
属于零数据保留 (ZDR) 项目的后台请求将使用
`store=false`。运行。响应数据会临时存储到磁盘上约 10
分钟,以支持异步执行和轮询

对于使用 [Modified Abuse
Monitoring](https://developers.openai.com/api/docs/guides/your-data#modified-abuse-monitoring),的项目,包括
增强版 Modified Abuse Monitoring,前台请求遵循标准
留存策略,当 `store` 省略或设置为 `true`。时。后台响应仅在
被显式提供时,才会在轮询期 `store=true` 之后继续保留
如果 `store` 省略或设置为 `false` 对于后台请求,响应
会在约 10 分钟后被删除。
增强版 Modified Abuse Monitoring,
被省略或被设置为 `store` 时,前台请求遵循标准的 `true`。保留策略。后台响应仅在显式提供
时,才会在轮询期结束后继续保留。 `store=true` 时被显式提供
如果 `store` 时,前台请求遵循标准的 `false` 对于后台请求,响应
将在大约 10 分钟后被删除。

在后台生成响应

Expand Down Expand Up @@ -139,9 +139,9 @@ puts(response.status)

## 轮询后台响应

要检查后台请求的状态,请使用针对 Responses 的 GET 端点。当请求处于 queued 或 in_progress 状态时持续轮询。一旦离开这些状态,就表示它已到达最终(终态)状态。
要检查后台请求的状态,请使用 响应接口 的 GET 端点。在请求处于 queued 或 in_progress 状态时持续轮询。当请求离开这些状态时,即表示已进入最终(终止)状态。

获取在后台执行的 response
检索在后台执行的响应

```bash
curl https://api.openai.com/v1/responses/resp_123 \
Expand Down Expand Up @@ -309,7 +309,7 @@ puts(response.output_text)

## 取消后台响应

你也可以像这样取消一个进行中的响应:
你也可以按如下方式取消一个进行中的响应:

取消正在进行的响应

Expand Down Expand Up @@ -396,15 +396,15 @@ puts(response.status)
```


重复取消是幂等的,后续调用只会返回最终的 `Response` 对象。
重复取消是幂等的——后续调用只会简单地返回最终的 `Response` 对象。

## 流式传输后台响应

你可以创建一个后台 Response并立即开始从中流式传输事件。如果你预计客户端会中断流,并希望保留稍后恢复的选项,这会很有用。要实现这一点,需要在创建 Response 时同时指定 `background` 和 `stream` 设置为 `true`。你需要跟踪一个 “cursor”(游标),它对应于每个流式事件中收到的 `sequence_number` 。
你可以创建一个后台 Response 并立即开始从中流式传输事件。如果你预期客户端会中断流式传输,并希望保留稍后重新接续的选项,这会很有用。方法是创建一个同时设置了以下两个选项的 Response`background` 和 `stream` 设置为 `true`。你需要跟踪每个流式事件中收到的 `sequence_number` 的“游标”

目前,从后台响应中收到首个 token 的时间
高于从同步响应中收到的时间。我们将在未来几周内着力缩短
这一延迟差距
高于同步响应。我们正在努力在未来几周内
缩小这一延迟差距

生成并流式传输后台响应

Expand Down Expand Up @@ -687,7 +687,7 @@ last_sequence_number = -1
response_id = ""
stream.each do |event|
puts(event.type)
last_sequence_number = event.sequence_number
last_sequence_number = event.sequence_number || last_sequence_number
if event.is_a?(OpenAI::Models::Responses::ResponseCreatedEvent)
response_id = event.response.id
end
Expand All @@ -706,5 +706,5 @@ puts("Response #{response_id}; last sequence number #{last_sequence_number}")

1. 后台请求可以使用 `store=false`,但响应数据会被临时
存储以支持异步执行和轮询。
2. 若要取消同步响应,请终止连接
3. 仅当使用以下方式创建后台响应时,才能从该响应开启新的流 `stream=true`.
2. 要取消同步响应,请终止连接
3. 只有使用以下方式创建的后台响应才能开启新的流式传输 `stream=true`.
Loading