Компаниям
Возможности
Пресеты
Пресет — именованный набор: модели, системный промпт и параметры. В 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указываете это имя.
На аккаунт — не больше 50 пресетов.
Имя
Латиница, цифры, точка, дефис и подчёркивание. Без пробелов и слешей. До 64 символов. Примеры: support-bot, cheap_coder, gpt5.fast.
Не пересекайтесь с каталогом
Если имя совпадёт с моделью из каталога — deepseek-r1, auto и т.д. — запрос уйдёт в эту модель, а не в пресет.
Модели и запасной вариант
В пресете от 1 до 5 моделей, по порядку. Первая обрабатывает запрос. Если она недоступна, AITUNNEL пробует следующую.
Имеет смысл ставить основную модель первой, а дешевле или стабильнее — следом.
Что можно сохранить
Пустое поле в пресете не трогает запрос. Заполненное применяется по правилу переопределения.
| Параметр | Зачем |
|---|---|
| Системный промпт | Роль и инструкции |
temperature / top_p | Случайность ответа (обычно одно из двух) |
frequency_penalty / presence_penalty | Повтор токенов |
top_k | Ограничение выбора токенов |
max_tokens | Потолок ответа |
seed | Повторяемость |
verbosity | Краткость ответа (где модель это умеет) |
| Рассуждения | Включить, effort, лимит токенов, скрыть цепочку. См. токены рассуждений |
| Веб-поиск | Вставить aitunnel:web_search. См. веб-поиск |
| Кеш промпта | cache_control: 5 минут или 1 час. См. кеширование промпта |
| Выбор провайдера | provider.sort: цена, throughput или задержка. См. выбор провайдера |
Переопределение
В панели это чекбокс «Перезаписывать параметры клиента». По умолчанию он включён: значения пресета важнее, чем то, что пришло в запросе — клиент не перебьёт temperature или системный промпт.
Если выключить, пресет заполняет только пустые поля — клиент может задать своё.
Модель из пресета подставляется всегда: в запрос уходит первая модель из списка. В ответе API в поле model будет уже настоящее имя модели, не имя пресета.
API-ключи
Имя пресета можно указать в белом списке моделей ключа. Тогда ключ вызовет только этот пресет (и другие имена из списка), а произвольную модель — нет. См. API-ключи.