Пресеты

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

Как вызвать

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

curl https://aitunnel.83.141.93.205.nip.io/__api/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.

Как создать

  1. Откройте пресеты

  2. Создайте пресет

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

  3. Вызывайте по имени

    Дальше в любом клиенте в 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_formatJSON Schema (имя, схема, strict) или любой JSON. В /responses уходит в text.format, в /messages — в output_config.format, там только JSON Schema. См. структурированный вывод
РассужденияВключить, effort, лимит токенов, скрыть цепочку. См. токены рассуждений
Веб-поискВставить aitunnel:web_search: движок и, у Exa и Parallel, режим mode. См. веб-поиск
Поиск по базе знанийВставить aitunnel:file_search: до 5 баз знаний, число результатов и реранкинг. Модель ищет по вашим файлам, а клиенту достаточно назвать пресет. См. база знаний
Кеш промпта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_tierflex — дешевле и медленнее, priority — быстрее и дороже. См. уровни обслуживания

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

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

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

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

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

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

API-ключи

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