Responses API completion_window:2h・8hの割引設定

Responses APIのバックグラウンド処理で割引を使うための入れ子設定を解説します。soonest・2h・8hの料金を比較し、結果の取得、後続リクエストの優先条件、会話履歴の引き継ぎを確認します。

目次
Responses API completion_window:2h・8hの割引設定

チームでAPIによるレビューを実行し、結果を数時間待てるなら、Responses APIの完了時間枠を指定して対象のトークン料金を抑えられます。background_options.completion_windowを2hまたは8hに設定し、background: trueとservice_tier: "default"を併用します。公式の完了時間枠の設定に従い、completion_windowを最上位に置かず、割引対象の時間枠ではストリーミングを有効にしないでください。

soonest・2h・8hの選び方

モデルが考える時間ではなく、最初の応答がいつまでに必要かを基準に時間枠を選びます。2026-11-19時点のOpenAIのバックグラウンドモードガイドでは、次の選択肢と割引率が示されています。

時間枠Standardに対するモデルのトークン料金の割引選ぶ場面
soonest割引なし。既定値です。利用者がその場で結果を待っている場合です。
2h30%後の会議や次の処理工程までにレビューが終わればよい場合です。
8h40%夜間のレビューや文書分析の結果を翌朝まで待てる場合です。

background: trueだけでは割引を選択したことになりません。完了時間枠を指定しないリクエストはsoonestを使います。2hと8hの目標時間は、APIが最初のリクエストを受け付けた時点から数え、その応答に適用されます。後続のツール呼び出しや追加リクエストを含めた処理全体の完了期限ではありません。

トークン料金だけの試算として、Astraへのリクエストにキャッシュを使わない入力トークンが100,000、課金対象の出力トークンが10,000あるとします。キャッシュへの書き込み、有料ツール、保存料金、処理リージョンによる追加料金は発生しないと仮定します。

2026-11-19時点のOpenAIのStandard料金表では、短いコンテキストでのAstraの料金は入力1Mトークンあたり$8、出力1Mトークンあたり$40です。Astraのモデルカードでは、入力トークンが272Kを超えると長いコンテキストの料金調整が適用されます。この例の入力100,000トークンは、その基準を下回ります。

Standardでのモデルのトークン料金の見積もりは、次のとおりです。

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

同じトークン数なら、2hでは$1.20 × 0.70 = $0.84、8hでは$1.20 × 0.60 = $0.72になります。これは計算例であり、実際にリクエストを実行して確認した請求額ではありません。この試算では同じモデルと同じ入出力トークン数を固定し、完了時間枠だけを変えています。処理全体の費用を見積もる場合は、割引対象外の費目を別に加えます。

割引は、後続リクエストを含む対象リクエストのモデルのトークン料金に適用されます。請求書の他の費目に同じ割引率を掛けないでください。キャッシュを使う処理では、プロンプトキャッシュの費用ガイドを参考に、書き込みと読み取りの料金を分けて計算します。

対象モデルを確認してアクセス方法を選ぶ

文書化された完了時間枠の設定を使うには、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の支払い設定または利用可能なAPIクレジットが必要です。利用料金はChatGPTのサブスクリプションとは別に計算されます。2hや8hの設定が必要な場合です。特に、後のリクエストが前の結果に依存する処理に適しています。
OpenAI Batch APIAPIへのアクセスと支払いの条件は同じです。独立したリクエストをファイルで送信する仕組みも必要です。すべての入力が事前に決まっている場合です。依存関係のあるリクエストを順に制御する代わりに、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が必要です。すべてのコードブロックを同じシェル、同じ作業ディレクトリで実行してください。readが入力を待ったら、OpenAIのAPIキーを貼り付けてEnterを押します。キーは画面に表示されず、シェルのコマンド履歴にも入りません。

この例では後で2回目のリクエストを送るため、継続IDを生成します。APIに応答の保存を要求し、ローカルにもJSONファイルを書き込みます。機密文書に差し替える前に、データの取り扱い要件を確認してください。

入力例は、空の値を許容する列を追加し、データを分割して補完してから読み取り先を切り替え、最後にNOT NULL制約を付ける移行計画です。モデルには、この計画のリスクをレビューするよう依頼しています。

要求本文はbackground-request.json、返された応答はbackground-response.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

送信成功の最初の確認点は、応答のidが返され、background-response-id.txtに保存されることです。ステータスがqueuedまたはin_progressなら、結果はまだ準備中です。同じ処理を再送信せず、このIDを保持してください。継続IDは送信前にアプリケーションが生成しますが、結果の取得に使う応答IDはAPIが返すものです。この2つを取り違えないようにします。

保存した応答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ファイルを保持し、送信ではなくポーリングのブロックを再実行してください。

正常終了後は、応答全体をID付きのJSONファイルにも保存し、トークン使用量とレビュー本文を表示します。正常終了しなかった場合は、errorとincomplete_detailsが診断の手掛かりになります。処理中の状態をエラーと決めつけず、ループが待機する状態と終了する状態を分けて確認します。

本番運用ではシェルを開き続ける代わりに、Webhookの受信手順を使います。response.completedの通知を受け取り、受信した署名を検証して、event.data.idで指定された応答を取得します。通知そのものをレビュー本文として使わず、IDで取得した応答から本文を読み取ります。後続の処理を始める前にwebhook-idで重複配信を排除し、正常終了しなかった場合の処理も用意してください。

会話履歴と優先度を保ちながら処理を続ける

関連するリクエストがキューで高い優先度を得る条件を満たすよう、完了時間枠、継続ID、モデル、APIプロジェクトを再利用します。後続リクエストでもStandardでの処理とバックグラウンド実行を有効にしておきます。OpenAIの後続リクエストの手順では、優先処理はスケジュールに左右され、即時開始は保証されません。

それぞれのIDには別の役割があります。background_options.continuation_idは、処理のスケジュールに使う、アプリケーションが指定する識別子です。会話履歴を渡すものではありません。previous_response_idは前の応答を参照し、その応答がまだ利用できる間、会話を引き継ぎます。

最初のリクエストが完了したら、次のブロックでモデル、時間枠、継続ID、処理設定をそのまま再利用します。前の応答IDと新しい指示を追加する構成です。全体を通して同じAPIプロジェクトのキーを使ってください。

新しい指示では、最初のレビューで指摘されたリスクの高い2項目を、受け入れテストに変換させます。最初の計画を単独で再評価するのではなく、前のレビューを引き継いで次の成果物を作る例です。

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

新しい応答を取得するには、ポーリングのブロックをもう一度実行します。後続リクエストの送信後、IDファイルには新しく返された応答IDが入るため、このIDを使って次の結果を取得します。後続リクエストも別途課金され、対象となるモデルのトークン料金に選択した割引が適用されます。継続設定をそろえると優先度の条件を満たしますが、割引が追加されるわけではありません。引き継いだ会話履歴も引き続き課金対象の入力トークンに含まれます。

関数呼び出しでツールを使う処理では、元のcall_idと、outputにツールの結果を入れたfunction_call_output入力項目を送信します。このやり取りは関数呼び出しガイドに記載されています。継続IDを会話履歴の仕組みの代わりに使わないでください。継続IDでは期限切れの応答を復元できません。

利用を増やす前にキューの制限と請求を確認する

割引付きのバックグラウンド処理は、Batch処理と合わせて計画します。2hまたは8hのリクエストはBatch/Background Rate Limitを共有し、入力トークンは送信時に計上されます。予定している処理量を増やす前に、この共有枠の空きを確認してください。利用可能な金銭残高とは別の制約です。

送信に失敗した場合は、エラーで示されたパラメーターをリクエスト仕様と照合してから、小さな処理で再試行します。状況に応じて、入れ子構造、モデルの対象条件、Standard処理、ストリーミングを無効にする条件を確認してください。IDが返れば受付は確認できますが、生成が実際に完了したかは応答を取得して確認する必要があります。

割引が反映されていないように見える場合は、保存したリクエストにbackground: trueだけでなく、2hまたは8hが明示されているかを確認します。応答のservice_tierは実際に使われた処理モードを示します。送信したJSONと返されたusageを保存し、最初の処理を現在のAPI料金と照合してから、キュー全体に設定を適用してください。

LLM ワークフローを最適化しませんか?

単一 API でモデルを接続し、キーと AI コストを管理できます。

無料で始める