# API GPT Terra 6.1 (https://wanapi.app/ru/docs/gpt-6-1-terra)





Используйте **GPT Terra 6.1** в формате OpenAI Responses или Chat Completions с вашим ключом Wan API. [Сравнить модели GPT](/ru/docs/gpt-api).

## Параметры модели [#параметры-модели]

| Параметр             | GPT Terra 6.1                                   |
| -------------------- | ----------------------------------------------- |
| ID модели в запросе  | `gpt-6.1-terra`                                 |
| Вход / выход         | Текст и изображения / текст                     |
| Контекстное окно     | 1,050,000 токенов                               |
| Максимальный вход    | 922,000 токенов                                 |
| Максимальный выход   | 128,000 токенов, включая рассуждения            |
| Уровень рассуждений  | `none`, `low`, `medium`, `high`, `xhigh`, `max` |
| Уровень по умолчанию | medium                                          |

Это собственные ограничения модели. Выполнение запросов также зависит от доступного канала и лимитов аккаунта. Входные аудио и видео не поддерживаются.

## Подключение и отправка запроса [#подключение-и-отправка-запроса]

Создайте ключ в [настройках API-ключей](/ru/settings/apikeys). Храните его на сервере в `WAN_API_KEY`. Один ключ и общий предоплаченный баланс работают со всеми моделями и группами. Указывайте точный ID модели, включая точку в ID версии 6.1.

```bash
curl https://api.wanapi.app/v1/responses \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6.1-terra",
    "input": "Explain the purpose of a database index in three sentences.",
    "reasoning": {"effort": "low"},
    "max_output_tokens": 1024
  }'
```

```python
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["WAN_API_KEY"],
    base_url="https://api.wanapi.app/v1",
)
response = client.responses.create(
    model="gpt-6.1-terra",
    input="Explain the purpose of a database index in three sentences.",
    reasoning={"effort": "low"},
    max_output_tokens=1024,
)
print(response.output_text)
```

## Параметры Responses [#параметры-responses]

| Поле                                                                 | Обязательно | Описание                                                                                           |
| -------------------------------------------------------------------- | ----------- | -------------------------------------------------------------------------------------------------- |
| `model`                                                              | Да          | `gpt-6.1-terra`.                                                                                   |
| `input`                                                              | Да          | Строка запроса или массив входных элементов.                                                       |
| `instructions`                                                       | Нет         | Системные инструкции или инструкции разработчика.                                                  |
| `max_output_tokens`                                                  | Нет         | Лимит вывода, включая рассуждения; до 128,000 токенов.                                             |
| `reasoning.effort`                                                   | Нет         | none, low, medium, high, xhigh, max.                                                               |
| `reasoning.summary`                                                  | Нет         | `auto`, `concise` или `detailed`.                                                                  |
| `text.verbosity`                                                     | Нет         | `low`, `medium` или `high`.                                                                        |
| `text.format`                                                        | Нет         | Текст или структурированный вывод, например по поддерживаемой JSON Schema.                         |
| `stream`                                                             | Нет         | `true` для потока серверных событий SSE; иначе возвращается полный ответ.                          |
| `tools`, `tool_choice`                                               | Нет         | Объявления инструментов и выбор инструмента. Клиентские функции выполняет ваше приложение.         |
| `parallel_tool_calls`, `max_tool_calls`                              | Нет         | Параллельное выполнение инструментов и лимиты вызовов, если они поддерживаются.                    |
| `include`                                                            | Нет         | Дополнительные поля ответа, например `reasoning.encrypted_content`.                                |
| `metadata`, `store`                                                  | Нет         | Метаданные и настройка хранения ответа.                                                            |
| `previous_response_id`                                               | Нет         | ID предыдущего ответа, пока он доступен у провайдера, обрабатывающего запрос.                      |
| `truncation`                                                         | Нет         | Правило сокращения входных данных.                                                                 |
| `prompt_cache_key`, `prompt_cache_retention`, `prompt_cache_options` | Нет         | Маршрутизация кеша и срок хранения, если канал их поддерживает.                                    |
| `reasoning.mode`, `reasoning.context`                                | Нет         | Передаются провайдеру с учётом ограничений конкретной модели. Не передавайте их без необходимости. |
| `context_management`, `conversation`, `prompt`                       | Нет         | Настройки контекста или сохранённого промпта, если провайдер их поддерживает.                      |

## Рассуждения и инструменты [#рассуждения-и-инструменты]

Terra поддерживает `none` для запросов без рассуждений. Для вызова инструментов требуется Responses API, в том числе при отключённых рассуждениях.

При включённых рассуждениях не передавайте `temperature`, `top_p` и `top_logprobs`. В Chat Completions также не передавайте `logprobs`; в Responses не запрашивайте `message.output_text.logprobs` через `include`.

Лимит вывода включает и рассуждения, и видимый текст. Он может быть достигнут до завершения ответа. Более высокий уровень рассуждений может потребовать больше выходных токенов и времени.

Для структурированного вывода задайте `text.format` с `type: "json_schema"`, именем и схемой, которую поддерживает модель. Схема задаёт формат, но не гарантирует точность фактов. Продолжая диалог с инструментами, возвращайте результаты клиентских функций с исходным ID вызова.

## Текущие возможности API [#текущие-возможности-api]

Шлюз принимает `POST /v1/responses` и `POST /v1/chat/completions`. Доступность модели определяется настроенными каналами; перед интеграцией проверьте её через `GET /v1/models` с авторизацией. Отсутствие цены ниже не означает, что модель готова к вызовам.

Слой совместимости передаёт распознанные поля, а не произвольный JSON. Текущий DTO Responses не содержит нативных полей `access_programs`, `image` и `background`. Игнорируемое поле не влияет на запрос. Настройки канала также могут отфильтровывать `service_tier` и `safety_identifier`.

Эта интеграция не предоставляет Files API, Batch API или опрос состояния фоновых ответов. Используйте синхронные ответы или SSE. Доступность встроенных инструментов зависит от провайдера, и за них может взиматься отдельная плата; само объявление инструмента не гарантирует доступность полного сеанса работы с ним.

## Ввод изображений [#ввод-изображений]

Используйте общедоступный HTTP(S) URL изображения, размещённого вами. Добавьте изображение и вопрос во входной элемент пользователя:

```json
{"role":"user","content":[
  {"type":"input_image","image_url":"https://example.com/chart.png"},
  {"type":"input_text","text":"What does this chart show?"}
]}
```

Замените URL из примера ссылкой на своё изображение. Эта интеграция не предоставляет загрузку или хранение медиафайлов.

## Chat Completions [#chat-completions]

```bash
curl https://api.wanapi.app/v1/chat/completions \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6.1-terra",
    "messages": [{"role":"user","content":"Explain what a database index does."}],
    "reasoning_effort": "low",
    "max_completion_tokens": 1024
  }'
```

Читайте `choices[0].message.content`. Chat Completions использует `messages`, `reasoning_effort` и `max_completion_tokens`; Responses — `input`, `reasoning.effort` и `max_output_tokens`. Для сообщений с изображениями в Chat Completions используйте `type: "image_url"` и `image_url: {"url":"https://..."}`.

## Цены [#цены]

USD за 1 миллион токенов

Текущие тарифы включают множитель каждой группы. Цены кешируются на срок до 2 минут.

Один API-ключ работает со всеми моделями и группами. Метка «По умолчанию» обозначает первую подходящую группу в порядке автоматической маршрутизации; запрос оплачивается по тарифам фактически выбранной группы.

### GPT Terra 6.1

`gpt-6.1-terra`

| Оплачиваемые токены | gpt · По умолчанию · ≤ 272 000 входных токенов | gpt · По умолчанию · > 272 000 входных токенов |
| --- | ---: | ---: |
| Вход (без кеша) | 0,1 $ | 0,2 $ |
| Выход | 0,5 $ | 0,75 $ |
| Чтение из кеша | 0,005 $ | 0,01 $ |
| Запись в кеш | 0,125 $ | 0,25 $ |

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

— означает, что подтверждённая цена недоступна, а не что услуга бесплатна.

Тарифы кеша применяются только тогда, когда в ответе указано соответствующее использование кеша. Не учитывайте кешированные токены повторно как некешированный вход.

Умножьте количество токенов каждой оплачиваемой категории на её тариф и разделите на 1,000,000. Рассуждения включены в выходные токены и не оплачиваются повторно. Кешированные входные токены нельзя повторно учитывать как некешированные. Используйте только данные об использовании кеша из ответа; строка записи в кеш в таблице не означает поддержку всех режимов хранения.

Если цена зависит от длины входа, выбранный диапазон тарифов применяется ко всему запросу. Проверяйте порог и способ подсчёта входных токенов в таблице, не предполагая фиксированную цену. Запросы без заголовка группы используют `gpt`. Чтобы выбрать группу для Responses или Chat Completions, передайте `X-Model-Group: gpt` или `X-Model-Group: gpt-0.7`. `gpt-0.7` доступна только для Luna, Sol и Astra; Terra поддерживает только `gpt`. При явном выборе переход в другую группу не выполняется. Не меняйте ID модели: суффиксы групп не поддерживаются.

## Ответы и потоковая передача [#ответы-и-потоковая-передача]

Завершённый результат Responses содержит `id`, `model`, `status`, `output` и `usage`. В `output` могут быть рассуждения, вызовы инструментов и сообщения; первый элемент не обязательно содержит текст. Вспомогательное свойство `output_text` в OpenAI SDK собирает текст ответа.

Для SSE задайте `stream: true` и используйте `curl -N`. Обрабатывайте `response.created`, `response.output_text.delta`, `response.completed`, незавершённые ответы и ошибки. Завершающий ответ содержит данные об использовании. Chat Completions передаёт поток `choices[].delta`; задайте `stream_options: {"include_usage":true}`, чтобы получить финальный фрагмент со статистикой использования.

## Журналы использования и ошибки [#журналы-использования-и-ошибки]

[Журнал LLM](/ru/usage) показывает завершённые вызовы за последние 7 дней: модель, входные и выходные токены, стоимость. Выберите фильтр `gpt-6.1-terra`. Для изображений и видео используйте [журнал задач](/ru/tasks).

При ошибке проверьте HTTP-статус и объект `error`. Проверьте ключ, [баланс](/ru/docs/balance), точный ID модели и сочетание параметров. Если запрос или поток прервался, перед повтором проверьте журналы: новый запрос может привести к новому списанию.

## Справочные материалы [#справочные-материалы]

* [Официальная спецификация GPT Terra 6.1](https://developers.openai.com/api/docs/models/gpt-6.1-terra)
* [Справочник Responses](https://developers.openai.com/api/reference/resources/responses/methods/create)
* [Модели GPT и рассуждения](https://developers.openai.com/api/docs/guides/latest-model)
