cicora.ai
Спецификация APICLI и интеграции

CLI и интеграции

Настраивайте клиент с ключом, моделью и базовым URL, соответствующим именно его протоколу; секрет остаётся в окружении.

Справочник интеграции: выбирайте параметры и доступные возможности из API-настроек аккаунта и каталога модели для своего окружения.

Выберите совместимый URL

Для OpenAI-style клиента установите CICORA_API_BASE_URL=https://cicora.ai/api/v1 и не добавляйте второй /v1.

Для Messages-клиента или Claude Code установите ANTHROPIC_BASE_URL=https://cicora.ai/api: этот клиент добавит /v1/messages сам. Проверяйте конфигурацию через каталог моделей до инференса.

Compatible client configuration
bash
export CICORA_API_BASE_URL=https://cicora.ai/api/v1
export CICORA_API_KEY=replace_with_your_key

curl "$CICORA_API_BASE_URL/models" \
  --header "Authorization: Bearer $CICORA_API_KEY"

Безопасный запуск

  • Передавайте переменные окружения через менеджер секретов или безопасный профиль.
  • Исключайте .env и экспортированные конфиги из коммитов.
  • Давайте каждому приложению свой ключ, чтобы отозвать доступ без остановки остальных.

Переносимый контракт

Сохраняйте request/response логи без Authorization и пользовательских данных, когда это разрешено вашим режимом хранения.

Если клиент формирует собственный путь, сверяйте итоговый URL в его debug-логе до первой генерации.