cicora.ai
Русский
Спецификация APIКоманды и API-ключи

Команды и API-ключи

Разделяйте ключи, владельцев, бюджеты и следы использования между приложениями и рабочими пространствами.

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

Модель владения

Выпускайте ключ для конкретной интеграции и назначайте ему владельца, окружение и контакт для отзыва. Это превращает инцидент с ключом в точечную операцию, а не в остановку всей команды.

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

Verify an issued key without inference
bash
curl --request GET https://cicora.ai/api/v1/models \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Accept: application/json'

Контроль расходов

  • Используйте лимит на ключ как предохранитель, а не как способ оценивать стоимость.
  • Связывайте внутренний проект с ключом и request id.
  • Регулярно удаляйте неиспользуемые ключи после подтверждения владельца.

Разбор отклонений

Сопоставляйте usage с моделью, сценарием, ключом и временем. Общий расход без контекста не позволяет быстро исправить причину.

Храните только необходимые идентификаторы и предоставляйте доступ к расходам по роли, а не по удобству ссылки.

Дальше