Перейти к основному содержимому

Настройка pi.dev с Detta

pi подключается к Detta через расширение-провайдер из этого репозитория. Расширение регистрирует провайдер detta, получает доступные модели через API и отправляет запросы в OpenAI-compatible gateway Detta.

Что понадобится​

  • установленный pi.dev;
  • API-ключ Detta вида dk_...;
  • клон репозитория Detta или доступ к каталогу pi/detta-provider.

Внимание: ключ нельзя публиковать.

Не добавляйте API-ключ в Git, Markdown-файлы или публичные скриншоты.

1. Установите провайдер​

Перейдите в корень репозитория Detta и запустите pi с локальным расширением:

pi -e ./pi/detta-provider

Для постоянной локальной установки используйте:

pi install ./pi/detta-provider -l

Флаг -l оставляет расширение связанным с текущим каталогом. Изменения провайдера будут видны без копирования пакета в другое место.

2. Передайте API-ключ​

Для текущей shell-сессии:

export DETTA_API_KEY=dk_<ваш-ключ>

Затем запустите pi с расширением:

pi -e ./pi/detta-provider

Чтобы не задавать переменную вручную каждый раз, сохраните её в менеджере секретов или в конфигурации shell. Не сохраняйте реальный ключ в файлах, которые попадают в репозиторий.

3. Выберите модель Detta​

В интерфейсе pi:

  1. Откройте /model.
  2. Выберите провайдера detta.
  3. Выберите нужную модель, например detta/gpt-4o.

Список моделей запрашивается у GET https://api.detta.one/v1/models при запуске. В каталог попадают модели, доступные через текущий прайс-лист Detta; модели для embeddings, изображений, видео, аудио, TTS и других не-chat сценариев отфильтровываются.

Вариант: вход через /login​

Вместо DETTA_API_KEY можно выполнить в TUI:

/login detta

Вставьте ключ dk_.... pi сохранит его в ~/.pi/agent/auth.json. Сохранённый через /login ключ имеет приоритет над значением DETTA_API_KEY.

Локальный API во время разработки​

Если gateway Detta запущен локально, укажите его URL:

DETTA_BASE_URL=http://localhost:3000/v1 \
DETTA_API_KEY=dk_<ваш-ключ> \
pi -e ./pi/detta-provider

Для production ничего переопределять не нужно: по умолчанию используется https://api.detta.one/v1.

Проверка​

После запуска проверьте:

  • в /model есть провайдер detta;
  • выбрана модель с префиксом detta/;
  • тестовый запрос получает ответ;
  • ключ не выводится в команду, логи или содержимое документации.

Если каталог моделей не загрузился, провайдер использует небольшой резервный список. Проверьте сетевой доступ к https://api.detta.one и повторно запустите pi.