Как подключить Pi к ApiClo
Подключите coding-агент Pi к ApiClo через ~/.pi/agent/models.json: baseUrl=https://apiclo.com/v1, api=openai-completions, apiKey=$APICLO_API_KEY. Откройте /model для перечитывания файла и выбора custom provider. Инструкция относится к coding-агенту Pi.
Перед началом
- Создайте отдельный API-ключ ApiClo, проверьте баланс и текущий тариф выбранной модели.
- Используйте версию клиента, соответствующую документации по ссылке. Не храните ключи в файлах проекта.
Шаги
Подключение
Задайте APICLO_API_KEY в терминале, запускающем Pi. Добавьте JSON-провайдер ниже, не перезаписывая остальных.
Модель и авторизация
Укажите точный Model ID ApiClo и разрешайте image только vision-модели. В /model выберите apiclo/claude-sonnet-5 или свою запись.
Проверка
Если старые credentials перекрывают новый ключ, проверьте авторизацию конкретного провайдера Pi. Сначала проверьте короткий ответ, затем один tool call и отдельный запрос с изображением.
Примеры
macOS / Linux
export APICLO_API_KEY="YOUR_APICLO_KEY"
Windows PowerShell
$env:APICLO_API_KEY="YOUR_APICLO_KEY"
~/.pi/agent/models.json
{
"providers": {
"apiclo": {
"baseUrl": "https://apiclo.com/v1",
"api": "openai-completions",
"apiKey": "$APICLO_API_KEY",
"models": [{"id": "claude-sonnet-5", "input": ["text", "image"]}]
}
}
}
Проверка результата
Отправьте небольшой запрос и проверьте в ApiClo Logs точную модель, результат и расход. Инструменты и изображения проверяйте отдельно. Настройки кэша клиента не подтверждают попадание: смотрите реальные токены чтения и записи.
Если не работает
- Модель может загрузиться из JSON, но оставаться недоступной без разрешённого ключа. В отличие от примера OMP, подстановка переменной Pi использует $APICLO_API_KEY.
- При 401 проверьте действующий ключ и источник credentials; при 404 — адрес запроса и Model ID. Сохраните текст ошибки без секретов для поддержки.
Совместимость и оплата
ApiClo — независимый шлюз. Интеграция не включает подписку клиента и не гарантирует все его функции. Сравнивайте обычный вход, чтение и запись кэша, выход по текущим тарифам; попадания и экономия зависят от нагрузки.
Вся документация