Responses API completion_window: скидки с окнами 2h и 8h
Настройте фоновые запросы Responses API со скидкой и правильной вложенностью полей. Сравните soonest, 2h и 8h, получите результат и сохраните историю диалога и право на повышенный приоритет следующих запросов.
Содержание

Если команда запускает проверки через API и может ждать несколько часов, окно завершения Responses API позволит сократить расходы на токены. Задайте background_options.completion_window: 2h или 8h, а также background: true и service_tier: "default". Следуйте настройкам из документации: не выносите completion_window на верхний уровень и не включайте потоковую передачу для этих окон.
Когда выбирать soonest, 2h или 8h
Выбирайте окно по сроку, к которому нужен первый ответ, а не по предполагаемой длительности работы модели. По состоянию на 2026-11-19 руководство по фоновому режиму описывает следующие варианты и скидки.
| Окно | Скидка на токены модели относительно Standard | Когда выбирать |
|---|---|---|
soonest | Нет; вариант по умолчанию | Пользователь ждёт результат сейчас. |
2h | 30% | Проверку можно отложить до следующего совещания или этапа обработки. |
8h | 40% | Документы можно проанализировать ночью, чтобы получить результат к утру. |
Сам по себе параметр background: true не даёт скидку. Без явного выбора окна запрос использует soonest. Для 2h и 8h отсчёт целевого срока начинается, когда API принимает первый запрос, и относится к ответу на него. Это не общий срок выполнения всей цепочки с последующими вызовами инструментов и запросами.
Рассмотрим расчёт только для токенов: запрос к Astra содержит 100,000 входных токенов без кеширования и 10,000 оплачиваемых выходных токенов. Предположим, что нет записей в кеш, платных инструментов, платы за хранение и надбавки за регион обработки.
По состоянию на 2026-11-19 в таблице цен Standard для Astra с коротким контекстом указаны $8 за 1M входных токенов и $40 за 1M выходных. Согласно карточке 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. Это расчётные примеры, а не фактические списания за выполненные запросы.
Скидка действует на ставки токенов модели для каждого подходящего запроса, включая последующие. Не распространяйте этот процент на остальные статьи счёта. При использовании кеша отдельно учитывайте запись и чтение: расчёт разобран в руководстве по стоимости кеширования промптов.
Какие модели доступны и как выбрать способ доступа
Для документированных настроек окон завершения используйте прямые запросы к Responses API OpenAI. По состоянию на 2026-11-19 в списке поддерживаемых моделей для публичной бета-версии указаны GPT-6.2 Astra, GPT-6.2 Sol, GPT-6.1 Terra и GPT-6 Luna. Идентификаторы моделей GPT-6.2: gpt-6.2-astra и gpt-6.2-sol.
Выбор модели и переход на неё разобраны в руководстве по API GPT-6.2 Astra и Sol. Способ доступа выбирайте отдельно от модели:
| Способ | Что требуется | Когда выбирать |
|---|---|---|
| OpenAI Responses API | Проект API и ключ, доступ из поддерживаемой страны или территории, настроенная оплата API либо доступные API-кредиты. Использование оплачивается отдельно от подписки ChatGPT. | Нужны настройки 2h или 8h, особенно если следующие запросы зависят от предыдущих результатов. |
| OpenAI Batch API | Те же условия доступа и оплаты API, плюс отправка независимых запросов через файл. | Все входные данные известны заранее. Используйте Batch API, а не цепочку зависимых запросов. |
| BetterToken | Собственный аккаунт, API-ключ и совместимый клиент. Поддерживается оплата в рублях, доступ к API BetterToken из России не требует VPN. Способы оплаты зависят от консоли; расходы считают по единице тарификации модели. | Нужен доступ к моделям с оплатой по использованию. Посмотреть цены BetterToken. Перед переносом запросов через шлюз отдельно проверьте поддержку окон завершения. |
Условие «без VPN» относится к API BetterToken, а не к сторонним сайтам, загрузкам, входу в аккаунты, магазинам приложений и обновлениям.
Не рассчитывайте, что подписка ChatGPT или Codex сама по себе открывает эти параметры. Здесь описан запрос к Responses API, причём оплата API отделена от ChatGPT. При входе в Codex с API-ключом действует оплата API вместо включённых в подписку кредитов. Однако это ещё не подтверждает наличие настройки окна завершения в Codex.
Как правильно передать background_options
Поместите completion_window и continuation_id внутрь background_options. Параметры background, service_tier и stream оставьте на верхнем уровне, как указано в схеме запроса Responses. Требуется обработка Standard; её выбирает service_tier: "default".
Пример рассчитан на Bash с установленными curl, jq и uuidgen. Запускайте все блоки в одной оболочке и из одного рабочего каталога. Когда read начнёт ждать ввод, вставьте API-ключ OpenAI и нажмите Enter. Ключ не появится на экране и в истории команд.
Пример создаёт continuation_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
Первый признак успешной отправки — возвращённый id ответа, сохранённый в background-response-id.txt. Статус queued или in_progress означает, что результат ещё не готов. Сохраните этот ID, а не отправляйте ту же задачу заново.
Как получить результат: опрос статуса или вебхук
Получайте существующий ответ через 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 и повторите блок опроса, а не отправки.
Для рабочего сервиса настройте приём вебхуков вместо постоянно открытой оболочки. Вебхук уведомит приложение о завершении запроса. Подпишитесь на response.completed, проверьте подпись входящего события и получите ответ по event.data.id.
Перед запуском следующего запроса исключайте повторную обработку доставок с одинаковым webhook-id. Также предусмотрите обработку ошибок и других неуспешных исходов.
Как продолжить задачу и сохранить историю
Чтобы связанные запросы могли получить повышенный приоритет в очереди, повторно используйте окно завершения, идентификатор продолжения, модель и проект API. В следующем запросе оставьте Standard и фоновое выполнение. В описании последовательных запросов OpenAI указывает зависимость от планирования очереди: повышенный приоритет не гарантирует немедленного запуска.
Идентификаторы решают разные задачи. background_options.continuation_id задаётся приложением для планирования связанных запросов и не передаёт историю диалога. Параметр previous_response_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
Повторите блок опроса, чтобы получить новый ответ. Следующий запрос оплачивается отдельно; к подходящим ставкам токенов применяется выбранная скидка. Совпадение настроек продолжения даёт право на повышенный приоритет, а не дополнительную скидку. История диалога в цепочке по-прежнему увеличивает объём оплачиваемых входных токенов.
При работе с вызовами функций передавайте входной элемент function_call_output, содержащий исходный call_id и результат инструмента в output. Этот обмен описан в руководстве по вызовам функций. Идентификатор продолжения не заменяет историю диалога и не восстанавливает ответ, срок хранения которого истёк.
Проверьте лимиты очереди и списания до массового запуска
Планируйте фоновые запросы со скидкой вместе с заданиями Batch. Запросы с 2h и 8h используют общий Batch/Background Rate Limit, а входные токены учитываются при отправке. Прежде чем увеличивать объём запланированных задач, проверьте свободную ёмкость общей очереди. Денежный баланс и этот лимит — разные ограничения.
Если отправка не удалась, сопоставьте параметр из сообщения об ошибке со схемой запроса, затем повторите небольшую задачу. В зависимости от ошибки проверьте вложенность полей, поддержку модели, обработку Standard и отключённую потоковую передачу. Возвращённый ID подтверждает приём запроса, но завершение генерации нужно проверить отдельно.
Если скидка не видна в списаниях, найдите в сохранённом запросе явное окно 2h или 8h, а не только background: true. Проверьте service_tier в ответе: это поле показывает фактически использованный режим обработки. Сохраните отправленный JSON и возвращённый usage, затем сверьте первую задачу с текущими ценами API. После проверки применяйте настройки ко всей очереди.