Руководство по GPT-5.6 Terra API: возможности, ключ и доступ (2026)

GPT-5.6 — серия моделей OpenAI, представленная в июле 2026 года в трёх уровнях: Sol, Terra и Luna. Sol ориентирована на флагманские задачи, Terra — на баланс возможностей и стоимости, Luna — на лёгкие высоконагруженные сценарии. Для большинства команд Terra — первый уровень, который стоит подключать: она обслуживает поддержку, обработку документов, кодовых помощников и промежуточные шаги агентов, не проваливается на сложных задачах так легко, как лёгкий уровень, и не требует оплачивать каждый запрос по флагманскому тарифу.

Когда дело доходит до подключения, вопросы обычно сводятся к трём: как записать ID модели, где получить ключ и какие параметры изменить в существующем OpenAI SDK. Ниже — ответы в этом порядке, а также биллинг длинного контекста, кэш, диагностика ошибок и контроль затрат.

Примечание: OpenAI, GPT и ChatGPT — товарные знаки соответствующих правообладателей; материал носит технический характер. Спецификации, длина контекста и правила биллинга определяются официальной документацией OpenAI и разделом тарифов; конкретные цены здесь не фиксируются.

1. Что такое GPT-5.6 Terra

ID модели GPT-5.6 Terra — gpt-5.6-terra. Это универсальная модель диалога и рассуждений: принимает текст и изображения, возвращает текст. Основные характеристики:

Параметр	Официальная информация
ID модели	`gpt-5.6-terra`
Окно контекста	1 050 000 токенов
Максимальный вход	922 000 токенов
Максимальный выход	128 000 токенов
Вход/выход	Текст, изображения → текст
Отсечение знаний	16 февраля 2026 года
Глубина рассуждений	от none до max, по умолчанию medium
Основные интерфейсы	Chat Completions, Responses, Batch

Эта таблица говорит о двух вещах. Во-первых, миллионный контекст означает «можно вместить», а не «нужно вмещать»: чем длиннее вход, тем выше задержка и стоимость, а после определённого порога включается дополнительная тарификация. Во-вторых, предел выхода 128K подходит для длинных отчётов, кода и структурированного извлечения, но всё равно требует ограничения через max_tokens или max_output_tokens, чтобы модель не писала без границ.

С точки зрения выбора Terra подходит для:

ответов поддержки, классификации обращений, ответов на письма и комментарии;
суммаризации и извлечения полей из договоров, отчётов и веб-страниц;
объяснения кода, генерации юнит-тестов, первого этапа обзора кода;
планирования, выбора инструментов и обработки результатов в агентных сценариях;
пакетной офлайн-обработки: переписывания названий товаров, разметки отзывов.

Если задаче нужны максимально сильные многошаговые рассуждения, сложная математика или трудный рефакторинг, оценивайте уровень Sol. Если это только высокочастотная классификация коротких текстов, уровень Luna обычно выгоднее.

2. Длинный контекст и кэш: сначала правила биллинга

Биллинг GPT-5.6 Terra — это не «одна цена на все токены». В официальных правилах легче всего упустить надбавку за длинный контекст и различия кэша.

Сценарий биллинга	Официальное правило	Практическое влияние
Обычный вход	По цене входа	Системный промпт, история, определения инструментов считаются входом
Чтение кэша	Заметно ниже обычного входа	Чем стабильнее повторяемый префикс, тем заметнее экономия
Запись в кэш	Выше обычного входа; указано 1,25 цены входа	Кэшируйте только то, что точно будет повторяться
Вход свыше 272K	Весь запрос по входу с коэффициентом 2, по выходу — 1,5	Надбавка применяется ко всему запросу, а не к превышению
Выходные токены	По цене выхода	Длинные ответы и код обычно дороже входа

Самый важный пункт — «весь запрос». Когда вход превышает 272K токенов, множитель действует на весь вход и выход этого запроса, а не только на превышающий фрагмент. Отправить документ на 300K токенов одним куском и разбить его на два запроса по 150K — это могут быть совершенно разные счета.

Поэтому длинные документы рекомендуется обрабатывать так:

Сначала примените поиск или суммаризацию и оставьте в контексте только релевантные фрагменты.
Если нужна обработка полного текста, делите его по главам или границам бизнеса, удерживая вход одной партии в пределах 272K.
Если нужна сводка по партиям, сначала получите структурированные промежуточные результаты, затем сделайте второй раунд объединения.
Включите кэш для стабильного системного промпта и определений инструментов, не переписывайте их каждый раз.
Считайте по реальным логам использования, а не по придуманной «средней стоимости запроса».

Конкретные цены, коэффициенты кэша и правила длинного контекста смотрите в разделе тарифов и в актуальной официальной документации.

3. Два пути получения API-ключа

Путь первый: прямое подключение к платформе OpenAI

Зарегистрируйтесь и войдите в платформу разработчика OpenAI, настройте организацию, проект и биллинг.
На странице API Keys создайте ключ и назовите его по проекту или среде, например prod-customer-service.
Убедитесь в балансе проекта, лимитах скорости и правах на модель gpt-5.6-terra.
Поместите ключ в серверную переменную окружения или менеджер секретов; не добавляйте его во фронтенд и Git.

Base URL прямого подключения — https://api.openai.com/v1. Преимущества: понятная сторона биллинга и доступность модели сразу после публикации. Цена — необходимость зарубежного способа оплаты, стабильного сетевого доступа и самостоятельного решения вопросов курса и счетов.

Путь второй: ZSQH AI Gateway

Зарегистрируйтесь в ZSQH AI Gateway и создайте ключ. Один ключ даёт доступ к нескольким открытым моделям, а биллинг и расход собраны в одной панели. Шлюз предоставляет OpenAI-совместимый вход с Base URL https://ai.zhongshangqihang.com/v1; в существующем OpenAI SDK обычно нужно изменить три вещи: base_url, api_key и model.

Этот путь подходит командам с местной оплатой, потребностью в счетах в юанях и использованием нескольких поставщиков. Какие модели открыты и как заполнять их имена, смотрите на странице тарифов.

4. Base URL и совместимость

Параметр	Напрямую OpenAI	Шлюз ZSQH
Base URL	`https://api.openai.com/v1`	`https://ai.zhongshangqihang.com/v1`
API-ключ	Создан в платформе OpenAI	Создан в консоли шлюза
Имя модели	`gpt-5.6-terra`	По странице тарифов
SDK	OpenAI SDK	OpenAI SDK
Биллинг и счета	По правилам платформы	Счета в юанях по политике платформы

Самая частая ошибка конфигурации — лишний или недостающий /v1 в Base URL. Некоторые SDK автоматически добавляют /chat/completions, другие требуют полный путь; смешивание официального адреса и адреса шлюза обычно проявляется как 401 или 404. При диагностике сначала проверьте, на какой домен фактически ушёл запрос, затем путь.

5. Вызов через curl

export ZSQH_API_KEY="sk-ваш-ключ"

curl "https://ai.zhongshangqihang.com/v1/chat/completions" \
  -H "Authorization: Bearer $ZSQH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-terra",
    "messages": [
      {"role": "system", "content": "Ты технический редактор: отвечай конкретно и практично."},
      {"role": "user", "content": "Тремя пунктами объясни риски стоимости запросов с длинным контекстом."}
    ],
    "max_tokens": 800
  }'

Если возвращается model not found, сначала сверьте имя модели со страницей тарифов. Если приходит ошибка параметра, проверьте, принимает ли интерфейс max_tokens: часть новых интерфейсов использует max_output_tokens. Ориентируйтесь на официальную или внутреннюю документацию, не копируйте старые руководства.

6. Вызов через Python

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["ZSQH_API_KEY"],
    base_url="https://ai.zhongshangqihang.com/v1",
)

resp = client.chat.completions.create(
    model="gpt-5.6-terra",  # сверяйтесь со страницей тарифов
    messages=[
        {"role": "system", "content": "Ты помощник по проверке договоров; выводи только JSON."},
        {"role": "user", "content": "Извлеки этапы оплаты, суммы и ответственность за нарушение."},
    ],
    response_format={"type": "json_object"},
    max_tokens=1200,
)

print(resp.choices[0].message.content)

Два практических совета. Первый: при структурированном выводе добавляйте в код запасной разбор, не предполагайте, что модель всегда вернёт корректный JSON. Второй: если модель или шлюз отклоняет параметр сэмплирования, сначала уберите его и повторите; поддерживаемый диапазон уточняйте в официальной документации.

7. Чек-лист контроля затрат

Выбирайте уровень по задаче: простая классификация, извлечение и переписывание — лёгкий уровень; повседневное производство — Terra; сложные рассуждения — Sol.
Контролируйте входной префикс: системный промпт, определения инструментов и фиксированную базу знаний ставьте в начало и сохраняйте стабильность для попадания в кэш.
Дробите длинные запросы: когда вход приближается к 272K, делите его заранее, чтобы не включать множитель на весь запрос.
Ограничивайте выход: задайте max_tokens и просите сначала вывод, затем детали — это сокращает бесполезные длинные ответы.
Офлайн-задачи — в Batch: для пакетных задач без реального времени используйте Batch API, обычно там отдельная скидка.
Разделяйте ключи по проектам: одна бизнес-линия — один ключ, лимиты и оповещения помогают вовремя остановить аномалии.
Записывайте расход: как минимум request ID, модель, входные и выходные токены, попадания в кэш и время; раз в неделю делайте обзор.

Суть контроля затрат — не «экономить любой ценой», а «видеть картину». Без логов использования невозможно понять, что именно подняло счёт: длинный контекст, повторы или бесполезный вывод.

8. Частые ошибки

Ошибка	Частая причина	Действие
`401 Unauthorized`	Неверный ключ, нет Bearer, ключ удалён	Скопируйте ключ заново, проверьте заголовки
`404 Not Found`	Лишний или недостающий `/v1` в Base URL	Приведите адрес к документации
`model not found`	Неверное имя или модель не открыта	Скопируйте имя со страницы тарифов
`400 Bad Request`	Неподдерживаемый параметр или ошибка формата	Уберите подозрительный параметр, проверьте JSON
`429 Too Many Requests`	Превышены параллельность или частота	Снизьте параллельность, включите задержку
`context_length_exceeded`	Вход превышает предел контекста	Дробите, применяйте поиск или суммаризацию
`insufficient_quota`	Недостаточно баланса или квота исчерпана	Пополните или смените ключ

Диагностику рекомендуется начинать с авторизации: сначала минимальным запросом проверьте ключ, затем имя модели, и только потом подозревайте сеть и параметры. Так вы не будете раз за разом менять код в неверном направлении.

Частые вопросы

Как выбрать между GPT-5.6 Terra и GPT-5.5?

Terra — сбалансированный уровень серии GPT-5.6 с более поздним отсечением знаний, подходит для большинства повседневных производственных задач. GPT-5.5 по-прежнему хороша для существующих сценариев сложных рассуждений и комплексных агентов. Надёжнее всего провести A/B на собственном наборе задач и маршрутизировать по типу задачи, а не смотреть только на таблицу характеристик.

Поддерживает ли Terra изображения на входе?

Да. Официальная спецификация — текст и изображения на входе, текст на выходе; подходит для распознавания документов, понимания скриншотов и вопросов по изображениям. Изображения расходуют входные токены, поэтому перед пакетной обработкой оцените стоимость.

Можно ли загрузить целую книгу в контекст 1,05 млн токенов?

Технически можно, но не стоит делать это по умолчанию. Вход свыше 272K включает множитель длинного контекста, а задержка заметно растёт. Экономичнее найти нужные главы, сделать раздельные резюме и затем собрать итог.

Что нужно изменить в существующем OpenAI SDK?

Обычно три вещи: base_url направить на шлюз, api_key заменить на ключ шлюза, model записать так, как указано на странице тарифов. Остальная структура сообщений в основном не меняется, но поддержку новых параметров уточняйте в официальной или внутренней документации.

Почему за одинаковые запросы списывают разные суммы?

На списание влияют длина входа, длина выхода, попадание в кэш и срабатывание множителя длинного контекста. Сопоставляйте request ID с логами использования — так можно найти различие.

Что дальше

Сначала зарегистрируйтесь в ZSQH AI Gateway, создайте тестовый ключ, выполните минимальный запрос через curl и затем подключайте бизнес-код. Имена моделей, контекст и цены смотрите в разделе тарифов.