how-tos

Руководство по GPT-6.2 API: первый запрос на cURL и Python, Responses и Chat Completions

Poyo.ai Team
8 min read
Share:

Руководство по GPT-6.2 API: первый запрос на cURL и Python

Это руководство по 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"
ФорматЭндпоинтКогда использовать
ResponsesPOST https://api.poyo.ai/v1/responsesНовый код, function tools, изображения на входе, уровень рассуждений
Chat CompletionsPOST 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 действуют для всех примеров ниже:

  1. Не передавайте temperature и top_p. OpenAI советует их убрать, а также logprobs и top_logprobs в Chat Completions и top_logprobs в Responses. В схемах PoYo temperature и top_p по-прежнему указаны для старых моделей.
  2. Не ставьте уровень рассуждений none: API его отклоняет.
  3. Помещайте стабильные инструкции в сообщение 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.

СитуацияЗначениеИсточник
Новая интеграцияmediumOpenAI: «Начните с medium для новой интеграции».
Раньше было none или minimallowЗаметка 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 или незадокументированное поле
401API-ключ отсутствует или недействителенПроверьте заголовок 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.

Share: