Примечание автора: пройдём весь путь через консоль и за 5 шагов подключим GPT-6.1 Terra API. Разберёмся, какой эндпоинт выбрать, каких ошибок в параметрах избегать и как работает ступенчатая тарификация с порогом в 272K.
Коротко: при подключении GPT-6.1 Terra важно выбрать между Responses и Chat Completions. Для вызова инструментов нужен Responses. Если инструменты не нужны, достаточно почти без изменений скопировать существующий код и заменить название модели.
GPT-6.1 Terra выпущена 2026-10-26. ID модели — gpt-6.1-terra. В официальной документации указаны эндпоинты, параметры и правила тарификации — всё это можно проверить. В статье мы будем следовать порядку действий в консоли: зарегистрироваться → создать токен → найти Base URL → указать название модели → выполнить первый запрос. На каждом шаге будет критерий проверки, а командная строка и код останутся необязательными вариантами.
Главное: дочитав статью, вы сможете проверить всю цепочку подключения GPT-6.1 Terra API через консоль и избежать самых распространённых ошибок 400.
📌 Текущее состояние платформы: по состоянию на 2026-10-27 в актуальном списке моделей APIYI apiyi.com пока нет
gpt-6.1-terra. Мы постараемся добавить эту модель как можно скорее. Уже доступны модели того же поколения:gpt-6-astra,gpt-6-sol,gpt-6.1-solиgpt-6-luna. Для проверки подключения пока можно использоватьgpt-6.1-sol. Актуальные модели и цены смотрите в списке моделей платформы.
Ключевые особенности GPT-6.1 Terra API
| Особенность | Описание | Что это значит для вас |
|---|---|---|
| ID модели | gpt-6.1-terra, выпущена 2026-10-26 |
Укажите это значение в поле model запроса |
| Доступные эндпоинты | Responses, Chat Completions, Batch | Эндпоинты Realtime, Assistants, Embeddings и другие не поддерживаются |
| Вызов инструментов | Поддерживается только в Responses | Если добавить tools в запрос к Chat, он завершится ошибкой |
| Контекст | Всего 1 050 000 токенов, до 922 000 на входе и 128 000 на выходе | Подходит для работы с длинными документами, но учитывайте тарифный порог в 272K |
| Модальности | На входе — текст и изображения, на выходе — текст | Изображения передаются через input_image в Responses |
| Дата отсечения знаний | 2026-06-01 | Чтобы получить актуальную информацию, используйте инструмент web_search |
Подробно о возможностях GPT-6.1 Terra
GPT-6.1 Terra поддерживает потоковую передачу ответов, структурированный вывод, вызов функций, file_search, ввод изображений, веб-поиск и кэширование промптов. Тонкая настройка и предсказанные выходные данные не поддерживаются. Если старый проект зависит от дообученной модели или предсказанных выходных данных, перенести его напрямую не получится.
В эндпоинте Responses можно подключить множество инструментов, включая web_search, file_search, image_generation, code_interpreter, hosted_shell, apply_patch, skills, computer_use, mcp и tool_search. Именно поэтому, если нужны инструменты, выбирайте Responses: в этой модели Chat Completions предназначен только для обычного диалога.
Как вызвать GPT-6.1 Terra API: 5 шагов в консоли
Шаг 1. Зарегистрируйте аккаунт
- Откройте APIYI apiyi.com и зарегистрируйте аккаунт, указав свои данные и следуя подсказкам на странице. Платформа требует, чтобы аккаунт регистрировал сам пользователь.
- В новом аккаунте есть пробный баланс 0,05 доллара — его хватит, чтобы выполнить один лёгкий вызов без пополнения.
- Критерий проверки: после входа откройте консоль — пробный баланс должен отображаться в кошельке или на странице баланса.
- Если возникли проблемы: если баланс не отображается, сначала убедитесь, что завершили регистрацию. Не спешите пополнять счёт.
Если вы используете официальный канал, создайте ключ на странице API Keys платформы OpenAI. Для этого аккаунт должен быть зарегистрирован в поддерживаемом регионе, а баланс на уровне Build — пополнен минимум на 5 долларов.
Шаг 2: Создайте токен и выберите подходящую группу
- Откройте страницу токенов в консоли:
api.apiyi.com/token, затем нажмите «Создать токен». - В поле «Выберите группу» выберите нужную группу. От неё зависят доступные модели, коэффициент тарификации и маршрут к вышестоящему сервису. В группах
defaultиsvipцены такие же, как у официального сервиса, аCodexReverseиспользует ресурсы обратной разработки. - Как проверить: после сохранения в списке токенов появится ключ, начинающийся с
sk-. - Если возникли проблемы: «Группа» на уровне пользователя и группа токена — не одно и то же. Применяется именно группа, выбранная для токена.
Шаг 3: Найдите Base URL
Base URL зависит от SDK — здесь чаще всего ошибаются:
- OpenAI SDK:
https://api.apiyi.com/v1, обязательно укажите/v1 - Anthropic SDK: используйте корневой домен без
/v1 - Google GenAI SDK: используйте корневой домен и установите
api_versionвv1beta
Как проверить: для моделей серии GPT-6.1 используйте OpenAI SDK или совместимый с OpenAI клиент. Указанный адрес должен заканчиваться на /v1. Если возникли проблемы: ошибка 404 в большинстве случаев означает, что /v1 пропущен или указан дважды.
Шаг 4. Укажите название модели
В поле модели в клиенте или инструменте для отладки укажите ID модели. Для начала рекомендуем проверить работу подключения на лёгкой модели, например gpt-5.4-mini, а затем перейти на gpt-6.1-sol. Когда gpt-6.1-terra появится на платформе, достаточно будет изменить одно поле. Платформа не поддерживает бесплатные маршруты вроде auto и auto:free, поэтому не пытайтесь их использовать.
Критерий проверки: название модели должно посимвольно совпадать с тем, как оно указано в списке моделей на платформе. Если возникла проблема: при ошибке о том, что модель не найдена, сначала проверьте написание в списке моделей, а затем убедитесь, что группа токена включает эту модель.
Шаг 5. Выполните первый запрос
Ниже — минимальный рабочий пример из пяти шагов. Можно использовать любой из двух вариантов:
- Задайте переменную окружения:
export OPENAI_API_KEY=sk-ваш_токен - Создайте клиент:
client = OpenAI(base_url="https://api.apiyi.com/v1")— ключ автоматически считывается из переменной окружения - Вариант Responses:
r = client.responses.create(model="gpt-6.1-sol", input="Представься одним предложением", reasoning={"effort": "low"}, max_output_tokens=800) - Вариант Chat:
c = client.chat.completions.create(model="gpt-6.1-sol", messages=[{"role": "developer", "content": "Отвечай кратко"}, {"role": "user", "content": "Привет"}], max_completion_tokens=800) - Выведите данные для проверки:
print(c.model, c.usage.prompt_tokens)
Критерии проверки: запрос возвращает HTTP 200, а usage.prompt_tokens содержит числовое значение (в Responses проверьте usage.input_tokens). После замены модели на gpt-6.1-terra в поле model ответа должно отображаться её название.
🚀 Быстрый старт: рекомендуем сначала проверить
gpt-6.1-solна пробном балансе APIYI apiyi.com. Убедитесь, что Key, группа и Base URL настроены правильно. Когда Terra появится на платформе, достаточно будет изменить название модели. Актуальный список моделей и цены смотрите на платформе.
| Шаг | Действие в консоли | Критерий проверки | Что проверить в первую очередь |
|---|---|---|---|
| 1. Регистрация | Зарегистрируйтесь под своим именем и войдите в аккаунт | Доступен пробный баланс 0,05 доллара | Завершена ли регистрация |
| 2. Токен | Создайте токен и выберите группу | В списке появился Key, начинающийся с sk- |
Не перепутаны ли группа токена и группа пользователя |
| 3. Base URL | Укажите в OpenAI SDK адрес с /v1 |
Адрес заканчивается на /v1 |
При ошибке 404 проверьте наличие /v1 |
| 4. Название модели | Укажите модель, например gpt-6.1-sol |
Посимвольное совпадение со списком моделей | Написание и доступность модели в выбранной группе |
| 5. Запрос | Выполните первый вызов | Ответ 200, в usage есть числовое значение | Код состояния, тело ответа, x-request-id |
Также можно воспользоваться более удобным подключением через Magpie. В графическом интерфейсе нужно указать Key и Base URL. Magpie автоматически подключит к одному шлюзу такие программные агенты, как Claude Code, Codex, Pi и Hermes, — не придётся менять конфигурационные файлы по отдельности.
Выбор API-эндпоинта GPT-6.1 Terra: Responses или Chat Completions
| Параметр | Responses (v1/responses) |
Chat Completions (v1/chat/completions) |
|---|---|---|
| Вызов инструментов | Поддерживается, можно подключить 10 типов встроенных инструментов | Не поддерживается: запросы с tools завершатся ошибкой |
| Системные инструкции | instructions |
Роль developer в messages — работает надёжнее, чем system |
| Уровень рассуждений | reasoning: {effort: ...} |
reasoning_effort |
| Лимит вывода | max_output_tokens |
max_completion_tokens |
| Формат входных данных | Строка или массив сообщений; для изображений используется input_image |
Массив messages |
| Продолжение многошагового диалога | include: ["reasoning.encrypted_content"]; передавайте вывод предыдущего шага без изменений |
Собирайте историю сообщений самостоятельно |
usage в потоковом режиме |
Возвращается по умолчанию | Нужно добавить stream_options: {include_usage: true} |
Сравнение с Chat Completions: вариант Chat проще адаптировать под старый код — в большинстве проектов достаточно изменить название модели. Но в Terra он не поддерживает вызов инструментов, а в некоторых группах системные сообщения system отбрасываются. Responses, напротив, изначально поддерживает инструменты и воспроизведение зашифрованных данных рассуждений, поэтому лучше подходит для создания агентов и сценариев с многошаговыми рассуждениями.
Уровень рассуждений имеет шесть значений: none, low, medium (по умолчанию), high, xhigh и max. Значения minimal нет. Токены рассуждений учитываются при расчёте стоимости и в лимите вывода. Поэтому оставляйте запас в max_output_tokens: иначе вывод может оборваться до завершения рассуждений.
Три подводных камня при работе с GPT-6.1 Terra API
| Подводный камень | Неправильно | Правильно | Последствие |
|---|---|---|---|
| Chat с tools | Передавать tools в chat.completions | Использовать эндпоинт Responses | Запрос завершится ошибкой |
| Устаревший параметр | Передавать max_tokens в Chat |
Заменить на max_completion_tokens |
400 |
| Конфликт параметров сэмплирования | Передавать temperature или top_p, если effort не равен none | Удалить temperature, top_p и top_logprobs; в Chat также удалить logprobs | 400 |
Кроме этих трёх случаев, в официальной документации перечислены и другие ситуации, которые приводят к ошибке 400: значение effort равно minimal, в prompt_cache_options.ttl передано недопустимое значение или размер входных данных превышает 922 000 токенов. Ссылку на изображение должно быть возможно скачать с сервера. Сайты с защитой от парсинга могут помешать загрузке — в таком случае надёжнее использовать data URL с base64.
При разборе ошибок полезно помнить: исходный текст ошибки появляется только один раз — в теле ответа. Фоновые логи нужны для учёта биллинга, и неудачные вызовы в них не попадают. Поэтому сохраняйте HTTP-статус, полный текст исходного тела ответа и заголовок x-request-id. Не вызывайте raise_for_status() до чтения тела — иначе сообщение об ошибке будет потеряно.
Цены на GPT-6.1 Terra API и порог 272K
Ниже указаны официальные цены в долларах за миллион токенов. Обратите внимание: тариф применяется ко всему запросу. Если объём входных данных превышает 272K, все позиции в этом запросе тарифицируются по второй ставке.
| Позиция | Вход ≤ 272K | Вход > 272K |
|---|---|---|
| Входные токены | 1 | 2 |
| Выходные токены (включая токены рассуждений) | 5 | 7.5 |
| Чтение из кэша | 0.05 | 0.1 |
| Запись в кэш (30 минут) | 1.25 | 2.5 |
| Запись в кэш (12 часов) | 2.50 | 5 |
При оценке стоимости учитывайте все четыре позиции: входные токены, выходные токены, чтение из кэша и запись в кэш. Для записи в кэш также нужно учитывать срок хранения — 30 минут или 12 часов. Если смотреть только на цены входных и выходных токенов, можно недооценить стоимость запросов с длинным контекстом и кэшированием. У моделей того же поколения, доступных на платформе, все четыре позиции тарифицируются так же, как на официальном сайте, с теми же двумя тарифными уровнями для всего запроса.
Ограничения скорости для официального тарифа Standard: Build — 5 000 RPM / 1 млн TPM, Launch — 10 000 RPM / 4 млн TPM, Grow — 15 000 RPM / 40 млн TPM.
💰 Совет по снижению затрат: для задач с длинными документами старайтесь удерживать объём входных данных в одном запросе в пределах 272K и используйте prompt caching — так можно заметно снизить стоимость. В APIYI apiyi.com группы
defaultиsvipпредлагают те же цены, что и официальный тариф. Точные модели и цены смотрите в списке моделей на платформе.
Напоминание о безопасности API GPT-6.1 Terra
Храните API-ключ в переменной окружения или сервисе управления секретами. Не прописывайте его в исходном коде и тем более не отправляйте в репозиторий Git. Рекомендуем добавить файл .env в .gitignore. Если API-ключ утёк, немедленно удалите его на странице токенов и создайте новый. Кроме того, правильно выбирайте группу для токена: ошибка может привести к тому, что модель окажется недоступна, или к списанию средств по неожиданному тарифу. Для разных проектов лучше использовать отдельные токены — так будет проще контролировать лимиты и отключать их по отдельности.
Часто задаваемые вопросы
Вопрос 1. Что такое GPT-6.1 Terra?
Это модель OpenAI, выпущенная 2026-10-26. Её ID — `gpt-6.1-terra`. Контекстное окно составляет 1 050 000 токенов. На вход можно подавать текст и изображения, на выходе модель генерирует текст. Вызвать её можно через три эндпоинта: Responses, Chat Completions и Batch.
Вопрос 2. Что выбрать для GPT-6.1 Terra: Responses или Chat Completions?
Если нужны вызовы инструментов, например function calling или web_search, выбирайте Responses. Для обычного диалога подойдёт и Chat, но замените параметр max_tokens на max_completion_tokens и не передавайте tools.
Вопрос 3. Можно ли уже вызывать gpt-6.1-terra через APIYI?
По состоянию на 2026-10-27 модель ещё не появилась на платформе. Мы постараемся добавить её как можно скорее. Пока можно проверить подключение через модель того же поколения `gpt-6.1-sol` на APIYI apiyi.com. Актуальные модели и цены смотрите в списке моделей на платформе.
Вопрос 4. Почему запрос с параметром temperature возвращает ошибку 400?
Если для параметра reasoning effort выбрано значение, отличное от none, передавать temperature, top_p и top_logprobs нельзя. Удалите эти параметры или задайте effort значение none.
Вопрос 5. Можно ли протестировать модель без пополнения счёта?
Да. При регистрации в APIYI apiyi.com новый аккаунт получает пробный баланс 0,05 доллара — этого хватит, чтобы выполнить один простой запрос. Рекомендуем сначала проверить подключение на `gpt-5.4-mini`, а затем переключиться на нужную модель.
Вопрос 6. Какие известные ограничения есть у GPT-6.1 Terra?
Модель не поддерживает fine-tuning и predicted outputs, а также эндпоинты Realtime, Assistants, Embeddings, Images, Audio и другие. Если запрос содержит больше 272K токенов, весь запрос тарифицируется по второй ступени. Запросы, превышающие 922 000 токенов, сразу возвращают ошибку 400.
Ключевые моменты API GPT-6.1 Terra
- Главный выбор: если нужны инструменты — используйте Responses. Для Chat достаточно изменить название модели.
- Три нюанса с параметрами: в Chat не передавайте
tools, используйтеmax_completion_tokens, а еслиeffortне равенnone, не указывайте параметры сэмплирования. - 5 шагов в консоли: зарегистрируйтесь, создайте токен и выберите группу, укажите Base URL с
/v1, введите название модели и отправьте запрос. - Признаки успешной проверки: ключ начинается с
sk-, запрос возвращает статус 200, вusageуказаны числовые значения, а полеmodelсодержит название модели. - Четыре составляющие цены: входные токены, выходные токены, чтение из кэша и запись в кэш. Если объём превышает 272K, ко всему запросу применяется второй тарифный уровень.
- Как начать: сначала проверьте весь процесс на
gpt-6.1-solв APIYI, а когда модель появится на Terra, просто измените её название.
Итоги
Подключение API GPT-6.1 Terra можно свести к трём основным пунктам:
- Сначала выберите конечную точку: решите, использовать Responses или Chat. От этого зависят формат параметров и возможность вызывать инструменты.
- Проверяйте каждый этап: для токена, Base URL, названия модели и первого запроса есть чёткие признаки успешной настройки.
- Заранее оцените расходы: порог 272K рассчитывается для всего запроса; при планировании бюджета учитывайте все четыре составляющие стоимости кэша.
Рекомендуем сначала проверить весь процесс на gpt-6.1-sol в APIYI apiyi.com. По состоянию на 2026-10-27 модель gpt-6.1-terra ещё не появилась на платформе. Мы постараемся добавить её как можно скорее. Актуальные названия моделей и цены смотрите в списке моделей на платформе.
📚 Источники
- Страница модели OpenAI — GPT-6.1 Terra: спецификации модели и поддерживаемые конечные точки
- Ссылка:
platform.openai.com/docs/models/gpt-6.1-terra -
Описание: официальная информация о контекстном окне, модальностях и доступных инструментах
-
Руководство OpenAI по актуальным моделям: перенос параметров и ограничения
- Ссылка:
platform.openai.com/docs/guides/latest-model -
Описание: правила для параметров
reasoning.effort,max_completion_tokensи других -
Страница с ценами OpenAI: ступенчатая тарификация и цены на кэширование
- Ссылка:
platform.openai.com/docs/pricing - Описание: два тарифных уровня для контекста объёмом 272K и цены с учётом времени записи в кэш
Автор: техническая команда APIYI
Технические вопросы: свяжитесь с нами через главную страницу сайта APIYI. Дополнительные инструкции по подключению доступны в центре документации на docs.apiyi.com.
