
Это руководство по GPT-6.2 API проведёт вас от API-ключа до работающего запроса к gpt-6.2-sol или gpt-6.2-astra на cURL и через Python OpenAI SDK, на обоих эндпоинтах: Responses и Chat Completions. Каждое тело запроса соответствует опубликованной схеме PoYo и заметкам OpenAI о миграции на GPT-6.2 по состоянию на 18 ноября 2026 года. Сначала можно проверить промпты на странице модели GPT-6.2 Sol или странице модели GPT-6.2 Astra.
Впервые слышите об этих моделях? Обзор GPT-6.2 API описывает лимиты и позиционирование.
Перед началом
Создайте ключ в панели PoYo и храните его на сервере:
export POYO_API_KEY="your-poyo-key"
| Формат | Эндпоинт | Когда использовать |
|---|---|---|
| Responses | POST https://api.poyo.ai/v1/responses | Новый код, function tools, изображения на входе, уровень рассуждений |
| Chat Completions | POST https://api.poyo.ai/v1/chat/completions | Существующий код на Chat Completions, только текстовые сообщения, без инструментов |
Каждый запрос передаёт Authorization: Bearer $POYO_API_KEY. В примерах используется gpt-6.2-sol; для Astra замените его на gpt-6.2-astra. Структура запросов идентична.
Три правила из руководства OpenAI по GPT-6.2 действуют для всех примеров ниже:
- Не передавайте
temperatureиtop_p. OpenAI советует их убрать, а такжеlogprobsиtop_logprobsв Chat Completions иtop_logprobsв Responses. В схемах PoYotemperatureиtop_pпо-прежнему указаны для старых моделей. - Не ставьте уровень рассуждений
none: API его отклоняет. - Помещайте стабильные инструкции в сообщение
developerв началеinput. GPT-6.2 добавляетinstructionsверхнего уровня послеinput, и они выпадают из кэшируемого префикса.
Первый запрос к GPT-6.2 API через cURL
curl https://api.poyo.ai/v1/responses \
-H "Authorization: Bearer $POYO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6.2-sol",
"input": [
{"role": "developer", "content": "You are a code reviewer. Be specific and cite line numbers."},
{"role": "user", "content": "Review this function for race conditions: ..."}
],
"reasoning": {"effort": "medium"},
"max_output_tokens": 8000,
"store": false
}'
model и input обязательны. input — это обычная строка или массив элементов с role (developer, system, user, assistant) и content. Другие задокументированные поля, которые используются в этом руководстве: reasoning, max_output_tokens, stream, store, tools, tool_choice, previous_response_id и metadata.
В ответ напрямую приходит объект Responses. Текст находится в блоках output[].content[] с type: "output_text", статус вызова — в status, а число токенов — в usage.input_tokens, usage.output_tokens и usage.total_tokens.
Python и OpenAI SDK
Направьте SDK на PoYo:
import os
from openai import OpenAI
client = OpenAI(base_url="https://api.poyo.ai/v1", api_key=os.environ["POYO_API_KEY"])
resp = client.responses.create(
model="gpt-6.2-sol",
input=[
{"role": "developer", "content": "You are a senior backend engineer."},
{"role": "user", "content": "Write a migration plan from Celery 4 to Celery 5."},
],
reasoning={"effort": "medium"},
max_output_tokens=8000,
)
print(resp.output_text)
print(resp.status, resp.usage)
resp.output_text — это вспомогательное свойство SDK, которое склеивает все блоки output_text. Логируйте resp.usage при каждом вызове: раздел о стоимости ниже опирается на него.
Chat Completions для существующего кода
Если ваш код уже использует chat.completions.create, поменяйте модель и уберите поля сэмплирования:
resp = client.chat.completions.create(
model="gpt-6.2-sol",
messages=[
{"role": "system", "content": "You are a senior backend engineer."},
{"role": "user", "content": "Explain the CAP theorem with one example per trade-off."},
],
max_tokens=4000,
)
print(resp.choices[0].message.content, resp.choices[0].finish_reason)
Тот же запрос на cURL:
curl https://api.poyo.ai/v1/chat/completions \
-H "Authorization: Bearer $POYO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-6.2-sol",
"messages": [{"role": "user", "content": "Explain vector databases in one sentence."}],
"max_tokens": 1000
}'
Схема Chat Completions в PoYo описывает model, messages (строковый content; роли system, user, assistant), max_tokens, stream, stop, n и поля штрафов. Поле tools в ней не описано, а OpenAI указывает, что вызов инструментов в GPT-6.2 требует Responses, поэтому агентам место на /v1/responses.
Настройка уровня рассуждений в GPT-6.2 API
В OpenAI это поле называется reasoning.effort в Responses и reasoning_effort в Chat Completions. Справочник PoYo по Responses описывает reasoning (пример {"effort": "medium"}); в справочнике по Chat Completions reasoning_effort пока не указан, поэтому в этом руководстве уровень задаётся только в Responses.
| Ситуация | Значение | Источник |
|---|---|---|
| Новая интеграция | medium | OpenAI: «Начните с medium для новой интеграции». |
Раньше было none или minimal | low | Заметка OpenAI о миграции на GPT-6.2 |
| Длинные или сложные задачи | Уровень выше | OpenAI: более высокий уровень «может помочь модели довести до конца финальные проверки» |
none | Отклоняется | Страницы моделей OpenAI |
Руководство OpenAI по рассуждениям перечисляет среди возможных значений low, medium, high, xhigh и max, но оговаривает, что набор зависит от модели. На страницах моделей GPT-6.2 допустимые значения не перечислены, поэтому отправьте один тестовый запрос, прежде чем жёстко прописывать уровень выше medium. Токены рассуждений оплачиваются как выходные и учитываются в max_output_tokens; OpenAI возвращает их в usage.output_tokens_details.reasoning_tokens.
Стриминг ответов GPT-6.2 API
При "stream": true PoYo возвращает text/event-stream. Каждая строка data: — это JSON, в котором type называет событие; текст приходит в событиях response.output_text.delta, а response.completed несёт итоговый объект с usage. Отдельных строк event: PoYo не отправляет, и поток завершается data: [DONE].
stream = client.responses.create(
model="gpt-6.2-sol",
input="Write a 100-word product introduction for a log search tool.",
reasoning={"effort": "low"},
max_output_tokens=2000,
stream=True,
store=False,
)
usage = None
for event in stream:
if event.type == "response.output_text.delta":
print(event.delta, end="", flush=True)
elif event.type == "response.completed":
usage = event.response.usage
elif event.type == "response.failed":
raise RuntimeError(event.response)
print("\n", usage)
В Chat Completions stream=True возвращает события chat.completion.chunk; текст находится в choices[0].delta.content, а последний чанк содержит usage.
Изображения на входе
GPT-6.2 принимает изображения вместе с текстом. В PoYo отправляйте их в Responses как блоки input_image с публичным URL или полным Data URI (data:image/png;base64,...). Документация PoYo рекомендует ставить текст перед изображениями:
{
"model": "gpt-6.2-sol",
"input": [
{
"role": "user",
"content": [
{"type": "input_text", "text": "List every service in this architecture diagram that writes to the database."},
{"type": "input_image", "image_url": "https://example.com/diagram.png"}
]
}
],
"max_output_tokens": 3000
}
Чтение usage и расчёт стоимости запроса
Цены PoYo за 1M токенов: Sol — $1.60 за вход, $8 за выход, $0.08 за чтение из кэша, $2 за запись в кэш; Astra — $6.40, $32, $0.32, $8 (1 кредит = $0.005).
Руководство OpenAI по кэшированию возвращает оплачиваемые чтения из кэша в usage.input_tokens_details.cached_tokens, а записи — в usage.input_tokens_details.cache_write_tokens. Схема PoYo содержит input_tokens_details и output_tokens_details, но не перечисляет их ключи, поэтому читайте их с защитой от отсутствующих полей:
PRICES = { # PoYo USD per 1M tokens: input, output, cache read, cache write
"gpt-6.2-sol": (1.60, 8.00, 0.08, 2.00),
"gpt-6.2-astra": (6.40, 32.00, 0.32, 8.00),
}
def estimate_cost_usd(model: str, usage) -> float:
p_in, p_out, p_read, p_write = PRICES[model]
details = getattr(usage, "input_tokens_details", None)
cached = getattr(details, "cached_tokens", 0) or 0
written = getattr(details, "cache_write_tokens", 0) or 0
fresh = usage.input_tokens - cached - written
return (fresh * p_in + cached * p_read + written * p_write
+ usage.output_tokens * p_out) / 1_000_000
Считайте это оценкой и сверяйте её с журналом использования PoYo. Все цены здесь — тарифы для короткого контекста. Выше 272K входных токенов OpenAI берёт больше, поэтому для таких больших запросов сверяйтесь со страницей модели. Разобранные примеры — в статье Цены GPT-6.2 API.
Ошибки, которые стоит обрабатывать
| HTTP | Причина | Что делать |
|---|---|---|
| 400 | Некорректное поле (validation_error, детали перечислены) | Исправьте тело запроса; сюда может привести уровень none или незадокументированное поле |
| 401 | API-ключ отсутствует или недействителен | Проверьте заголовок Authorization |
| 402 | Недостаточно кредитов | Пополните баланс перед повтором |
| 404 | Неизвестная модель (model_not_found) | Проверьте ID: gpt-6.2-sol, gpt-6.2-astra |
| 429 | Превышен лимит запросов | Подождите и повторите |
| 500 / 502 / 503 | Ошибка сервера или вышестоящего провайдера | Повторите с экспоненциальной задержкой |
Документация PoYo сообщает, что LLM-эндпоинты сейчас не ограничены по частоте запросов, но 429 всё равно обрабатывайте. В OpenAI SDK перехватывайте openai.APIStatusError и ветвитесь по status_code. Повторяйте только 5xx и 429: ошибка 400 будет повторяться, пока не изменится тело запроса. Полные тела ответов — в разделе Коды ошибок PoYo.
Чек-лист перед запуском
- Храните
POYO_API_KEYна сервере; никогда не включайте его в браузерный или мобильный код. - Уберите
temperatureиtop_pиз всех путей запросов к GPT-6.2, включая общие вспомогательные функции. - Всегда задавайте
max_output_tokens(илиmax_tokens) и оставляйте в этом лимите место для токенов рассуждений. - Логируйте
status/finish_reasonи весь блокusageрядом с собственным ID запроса, чтобы видеть обрезанные ответы и скачки стоимости. - Помещайте длинный стабильный контекст в первое сообщение
developer, а меняющийся вопрос — в конец: так у кэширования промптов появляется шанс сработать. - Закрепите ID модели в конфигурации, чтобы переключаться между
gpt-6.2-solиgpt-6.2-astraбез деплоя.
Об инструментах, стриминге вызовов инструментов и кэшировании в долгих агентных сессиях читайте дальше в статье GPT-6.2 API для агентов разработки.
Часто задаваемые вопросы
Как вызвать GPT-6.2 API на Python?
Используйте OpenAI SDK с base_url="https://api.poyo.ai/v1", своим ключом PoYo и model="gpt-6.2-sol" или "gpt-6.2-astra" в client.responses.create.
Поддерживает ли GPT-6.2 API стриминг?
Да, на обоих эндпоинтах. Задайте stream: true; Responses отправляет типизированные события, например response.output_text.delta, а Chat Completions — события chat.completion.chunk. Оба потока завершаются data: [DONE].
Как задать уровень рассуждений в GPT-6.2 API?
Передайте "reasoning": {"effort": "medium"} в /v1/responses. OpenAI рекомендует начинать с medium и отклоняет none.
Почему запрос к GPT-6.2 API с temperature завершается ошибкой?
OpenAI советует не передавать temperature и top_p для GPT-6.2. Уберите их и управляйте длиной ответа через max_output_tokens или max_tokens.
Как отправить изображение в GPT-6.2 API?
Используйте /v1/responses с блоком input_image (URL или Data URI) после блока input_text. Схема Chat Completions в PoYo описывает только строковый content.