Пресеты

Пресет — именованный набор: модели, системный промпт и параметры. В API вы указываете имя пресета в поле model, как будто это обычная модель. AITUNNEL подставляет настройки до отправки запроса.

Как вызвать

Имя пресета ставите в model. Код клиента не меняется.

curl https://api.aitunnel.ru/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-aitunnel-xxx" \
  -d '{
    "model": "support-bot",
    "messages": [
      { "role": "user", "content": "Как вернуть заказ?" }
    ]
  }'

Работает в /chat/completions, /responses и /messages.

Как создать

Откройте пресеты
Панель → Пресеты
Создайте пресет
Нажмите «Новый» или, если пресетов ещё нет, начните с шаблона. Задайте имя и модели, через «Добавить параметр» добавьте только нужные параметры. Справа видно, какой запрос уйдёт провайдеру.
Вызывайте по имени
Дальше в любом клиенте в model указываете это имя.

Готовый пресет можно дублировать: копия откроется в редакторе с именем имя-copy. Если модели из пресета больше нет в каталоге, панель пометит пресет предупреждением.

На аккаунт — не больше 50 пресетов.

Имя

Латиница, цифры, точка, дефис и подчёркивание. Без пробелов и слешей. До 64 символов. Примеры: support-bot, cheap_coder, gpt5.fast.

Модели и запасной вариант

В пресете от 1 до 5 моделей, по порядку. Первая обрабатывает запрос. Если она недоступна, AITUNNEL пробует следующую.

Помимо id из каталога сюда можно поставить алиас последней версии линейки — ~anthropic/claude-opus-latest. См. последняя версия семейства.

Имеет смысл ставить основную модель первой, а дешевле или стабильнее — следом.

Что можно сохранить

Параметр, который не добавлен в пресет, не трогает запрос. Добавленный применяется по правилу переопределения.

Параметр	Зачем
Системный промпт	Роль и инструкции
`temperature` / `top_p`	Случайность ответа (обычно одно из двух)
`frequency_penalty` / `presence_penalty`	Повтор токенов
`top_k`	Ограничение выбора токенов
`max_tokens`	Потолок ответа
`seed`	Повторяемость
`verbosity`	Краткость ответа (где модель это умеет)
`stop`	До 4 строк, на которых ответ обрывается. В `/messages` уходит как `stop_sequences`
`response_format`	JSON Schema (имя, схема, `strict`) или любой JSON. В `/responses` уходит в `text.format`, в `/messages` — в `output_config.format`, там только JSON Schema. См. структурированный вывод
Рассуждения	Включить, effort, лимит токенов, скрыть цепочку. См. токены рассуждений
Веб-поиск	Вставить `aitunnel:web_search`: движок и, у Exa и Parallel, режим `mode`. См. веб-поиск
Кеш промпта	`cache_control`: 5 минут или 1 час. См. кеширование промпта. У Claude и Qwen кеша нет, пока маркер не пришёл в запросе. Cline, Claude Code, Hermes и OpenClaw его сами не ставят (OpenCode 2 ставит сам — настройка): добавьте параметр «Кэширование промптов» и в программе укажите имя пресета вместо каталожного id. Пять минут дешевле записывают кеш, час дольше его держит. Если у ключа белый список моделей, добавьте туда и имя пресета.
Выбор провайдера	`provider.sort` (цена, throughput или задержка) и предпочтения провайдеров: `order`, `only`, `ignore`, `allow_fallbacks`, `data_collection`, `zdr`, `quantizations`, `require_parameters`, `preferred_min_throughput`, `preferred_max_latency`. См. выбор провайдера
`service_tier`	`flex` — дешевле и медленнее, `priority` — быстрее и дороже. См. уровни обслуживания

Переопределение

В панели это переключатель «Значения пресета важнее». По умолчанию он включён: значения пресета важнее, чем то, что пришло в запросе — клиент не перебьёт temperature или системный промпт.

Если выключить, пресет заполняет только пустые поля — клиент может задать своё.

Системный промпт при включённом переключателе вытесняет все промпты клиента, а не только первый: в /chat/completions убираются лишние сообщения с role: system и developer, в /responses такие элементы удаляются из input и промпт уходит в instructions, в /messages перезаписывается поле system. Если переключатель выключен, а клиент прислал свой системный промпт где угодно в запросе — промпт пресета не подставляется.

Пустая заглушка вроде { "role": "system", "content": "" } — которую многие обёртки над SDK шлют всегда — за системный промпт клиента не считается: пресет запишет свой промпт в неё при любом положении переключателя.

Модель из пресета подставляется всегда: в запрос уходит первая модель из списка. В ответе API в поле model будет уже настоящее имя модели, не имя пресета.

API-ключи

Имя пресета можно указать в белом списке моделей ключа. Тогда ключ вызовет только этот пресет (и другие имена из списка), а произвольную модель — нет. См. API-ключи.