cicora.ai
Русский
Спецификация APIFAQ для разработчиков

FAQ для разработчиков

Короткие ответы на практические вопросы о ключах, базовых URL, моделях, стоимости и диагностике интеграции.

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

С чего начать?

Создайте отдельный ключ, настройте OpenAI-style base URL https://cicora.ai/api/v1 и выполните GET /models. Затем отправьте минимальный chat-запрос с выбранным идентификатором модели.

Для Messages SDK используйте gateway root https://cicora.ai/api. При 404 сверяйте итоговый URL с протоколом клиента: один добавляет route после /v1, другой добавляет /v1/messages.

A safe first diagnostic request
bash
curl --include --request GET https://cicora.ai/api/v1/models \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Accept: application/json'

Частые решения

  • Не храните ключ в клиентском коде и не публикуйте его в issue или скриншоте.
  • Не воспринимайте пример цены как текущую цену: читайте каталог и метаданные ответов.
  • Не переносите параметры и возможности между моделями без проверки модели.

Когда нужна поддержка

Соберите время, method, URL без query-секретов, HTTP-статус, request id и обезличенное тело ошибки.

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

Дальше