Responses API completion_window:2h 与 8h 折扣配置

正确设置 Responses API 后台请求的嵌套字段,对比 soonest、2h 和 8h 的折扣与成本。按完整示例提交请求并取回结果,在后续请求中保留排队优先级资格和对话历史,同时核对共享限额与实际计费。

本文内容
Responses API completion_window:2h 与 8h 折扣配置

如果团队通过 API 执行的审查任务可以等上几个小时,就可以用 Responses API 的完成窗口降低符合条件的模型 token 费用。将 background_options.completion_window 设为 2h 或 8h,同时设置 background: true 和 service_tier: "default"。按照文档中的完成窗口配置操作:不要把 completion_window 放在顶层,也不要为这些折扣窗口启用流式输出。

如何选择 soonest、2h 或 8h

选择窗口时,要看首个响应何时需要,而不是估计模型会思考多久。截至 2026-11-19,OpenAI 的后台模式指南列出了以下选项和折扣。

窗口模型 token 费用相对 Standard 的降幅适用场景
soonest无折扣;默认选项有人正在等待结果,需要按需响应。
2h30%审查任务可以在稍后的会议或下一处理阶段前完成。
8h40%隔夜审查或文档分析可以等到次日早晨。

只设置 background: true 不会自动获得折扣。没有指定完成窗口时,请求使用 soonest。对于 2h 和 8h,目标完成时间从 API 接受初始请求时开始计算,只适用于该次响应。这不是涵盖所有后续工具调用和追加请求的整条工作流截止时间。

下面只估算 token 费用。假设一次 Astra 请求包含 100,000 个未缓存的输入 token,以及 10,000 个计费输出 token。假设没有缓存写入、付费工具、存储费用或区域处理附加费。

截至 2026-11-19,OpenAI 的 Standard 价格表列出的 Astra 短上下文费率为:每 1M 输入 token 收取 $8,每 1M 输出 token 收取 $40。Astra 模型卡说明,输入超过 272K token 时会适用长上下文价格调整。本例的输入量为 100,000 token,低于这一阈值。

按 Standard 费率估算,模型 token 成本为:

(100,000 / 1,000,000 × $8) + (10,000 / 1,000,000 × $40) = $1.20

在 token 数量相同的情况下,2h 的费用为 $1.20 × 0.70 = $0.84,8h 则为 $1.20 × 0.60 = $0.72。这些只是计算示例,并非实际请求的账单记录。

折扣适用于符合条件的模型 token 费率,包括后续请求。不要把同一折扣比例直接套到其他账单费用上。如果任务使用缓存,请参考提示词缓存成本指南,分别计算写入和读取费用。

核对支持模型并选择接入方式

需要使用文档明确支持的完成窗口设置时,直接调用 OpenAI 的 Responses API。截至 2026-11-19,适用模型列表列出的公开测试模型包括 GPT-6.2 Astra、GPT-6.2 Sol、GPT-6.1 Terra 和 GPT-6 Luna。GPT-6.2 的模型 ID 分别是 gpt-6.2-astra 和 gpt-6.2-sol。

模型选型与迁移细节可参考 GPT-6.2 Astra 和 Sol API 指南。接入方式要与模型分开选择:

接入方式所需条件何时选择
OpenAI Responses APIAPI 项目和密钥,从支持的国家或地区访问,并已配置 API 计费或拥有可用的 API 余额。使用费用与 ChatGPT 订阅分开计算。需要 2h 或 8h 设置,尤其是后续请求依赖前面结果时。
OpenAI Batch API同样的 API 访问和计费条件,另需通过文件提交独立请求。所有输入都已提前确定。此时采用 Batch API 流程,不必编排相互依赖的多轮请求。
BetterToken自己的账户和 API 密钥、兼容客户端,以及控制台提供的付款方式。用量按各模型的计费单位结算。比较更多按量付费的模型接入方案时。查看 BetterToken 价格,并在通过网关运行这套流程前,单独核实完成窗口的支持情况。

不要因为持有 ChatGPT 或 Codex 订阅,就认为可以设置这些请求选项。这里使用的是文档支持的 Responses API 请求,其 API 计费独立于 ChatGPT。Codex 的 API 密钥认证使用 API 计费,而不是套餐内包含的额度;这本身不能证明 Codex 提供完成窗口设置。

正确设置 background_options 的嵌套字段

将 completion_window 和 continuation_id 放进 background_options。按照 Responses 请求结构,让 background、service_tier 和 stream 保持在顶层。折扣窗口要求使用 Standard 处理模式,service_tier: "default" 用来选择该模式。

下面的 Bash 示例需要 curl、jq 和 uuidgen。所有代码块都应在同一个 shell 会话和工作目录中运行。read 等待输入时,粘贴 OpenAI API 密钥并按 Enter;密钥不会回显,也不会写入 shell 命令历史。

示例会生成延续 ID,供第二轮请求复用。它会请求 API 保存响应,并在本地写入 JSON 文件。把输入替换为敏感文档前,请先检查数据处理要求。

set +x
set -euo pipefail

read -rs OPENAI_API_KEY && export OPENAI_API_KEY
CONTINUATION_ID=$(uuidgen)

jq -n --arg continuation_id "$CONTINUATION_ID" '{
  model: "gpt-6.2-astra",
  input: "Review this migration plan for risks: add a nullable column, backfill it in batches, switch reads, then enforce NOT NULL.",
  background: true,
  service_tier: "default",
  stream: false,
  store: true,
  background_options: {
    completion_window: "8h",
    continuation_id: $continuation_id
  }
}' > background-request.json

curl --fail-with-body --silent --show-error \
  https://api.openai.com/v1/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @background-request.json \
  --output background-response.json

jq -er '.id' background-response.json > background-response-id.txt
jq '{id, status, service_tier}' background-response.json

首先确认 API 返回了响应 id,并将其保存到 background-response-id.txt。状态为 queued 或 in_progress 表示结果尚未就绪。保留这个 ID,不要重新提交同一任务。

根据响应 ID 轮询,或用 webhook 接收通知

使用 GET /v1/responses/{response_id}取回已有响应。下面的轮询循环仅在状态为 queued 或 in_progress 时继续;遇到 completed 就正常结束,其他终止状态则输出诊断信息。30 秒的轮询间隔只是本例的选择,不是 API 的要求。

RESPONSE_ID=$(cat background-response-id.txt)

while :; do
  curl --fail-with-body --silent --show-error \
    "https://api.openai.com/v1/responses/$RESPONSE_ID" \
    -H "Authorization: Bearer $OPENAI_API_KEY" \
    --output background-response.json

  STATUS=$(jq -r '.status' background-response.json)
  case "$STATUS" in
    queued|in_progress) sleep 30 ;;
    completed) break ;;
    *)
      jq '{id, status, error, incomplete_details}' background-response.json
      exit 1
      ;;
  esac
done

cp background-response.json "$RESPONSE_ID.json"
jq '{id, status, service_tier, usage}' background-response.json
jq -r '.output[]? | select(.type == "message") |
  .content[]? | select(.type == "output_text") | .text' \
  background-response.json

对这个纯文本示例,成功意味着状态为 completed,并且从响应消息中提取、输出了审查正文。提取逻辑会检查各项的类型,而不是假定第一个输出项就包含文本。如果 HTTP 获取请求失败,保留 ID 文件,重新运行轮询代码块,而不是提交代码块。

生产环境应按 webhook 接收指南配置通知,不必让 shell 一直运行。订阅 response.completed,验证收到的事件签名,再按 event.data.id 获取对应响应。触发后续任务前,用 webhook-id 对重复投递去重,并为未正常完成的结果准备处理路径。

继续执行任务,同时保留历史和优先级资格

复用相同的完成窗口、延续 ID、模型和 API 项目,让关联请求满足提高队列优先级的条件。后续请求同样要启用 Standard 处理和后台执行。OpenAI 的后续请求流程说明,实际启动时机取决于调度,不保证立即开始。

这两个标识的用途不同。background_options.continuation_id 由应用指定,用于调度关联请求,本身不提供对话历史。previous_response_id 指向前一次响应,在该响应仍可用时延续对话。

初始请求完成后,下面的代码块保留原有模型、窗口、延续 ID 和处理设置,再加入前一次响应 ID 与新指令。整个流程中都应使用同一个 API 项目的密钥。

RESPONSE_ID=$(cat background-response-id.txt)

jq --arg previous_response_id "$RESPONSE_ID" \
  '.previous_response_id = $previous_response_id |
   .input = "Turn the two highest-risk findings into acceptance tests."' \
  background-request.json > background-followup.json

curl --fail-with-body --silent --show-error \
  https://api.openai.com/v1/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @background-followup.json \
  --output background-response.json

jq -er '.id' background-response.json > background-response-id.txt

再次运行轮询代码块,即可获取新响应。后续请求单独计费,符合条件的模型 token 费率仍享受所选折扣。保持延续设置一致,是为了获得优先级资格,不会叠加一层折扣。链式对话中的历史内容仍会计入计费输入 token。

使用函数工具时,发送 function_call_output 输入项,其中包含原始 call_id,并将工具结果放在 output 中。函数调用指南说明了这一交互方式。不要用延续 ID 替代对话历史机制;它无法重建已经过期的响应。

扩大任务量前,核对队列限额和实际账单

折扣后台请求应与 Batch 作业一起规划。使用 2h 或 8h 的请求共享 Batch/Background Rate Limit,输入 token 在提交时就计入限额。增加定时任务量之前,先检查这个共享限额的剩余容量;账户资金余额与它是不同的限制。

提交失败时,先将报错指出的参数与请求结构对照,再重试一个小任务。根据问题检查字段嵌套、模型是否符合条件、Standard 处理模式,以及禁用流式输出的要求。返回 ID 只确认请求已被接受;生成是否真正完成,需要通过获取响应来验证。

如果账单看起来没有折扣,检查保存的请求是否明确指定了 2h 或 8h,而不只是 background: true。再检查响应中的 service_tier,它反映实际使用的处理模式。保存提交的 JSON 和返回的 usage,将首个任务的费用与当前 API 价格核对后,再把配置应用到整个队列。

BetterToken · 企业采购
企业专属价
支持开发票对公转账 / 支付宝 / 微信支付全系列文本 / 编程、图像、视频模型
文本 / 编程
图像
视频
专属技术支持领取企业折扣价目表 →