cicora.ai
Русский
Спецификация APIМодели и каталог

Модели и каталог

Стройте выбор модели на данных каталога, а не на захардкоженном списке в приложении.

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

Читайте каталог

Каталог — источник id, контекстного окна, поддерживаемых параметров, модальностей и отображаемых цен. Периодически обновляйте его в своей системе.

Для конкретного выбора сохраняйте модельный id вместе с параметрами, использованными в запросе.

Каталог моделей
bash
curl --request GET https://cicora.ai/api/v1/models \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Accept: application/json'

Фильтрация и совместимость

  • Отбирайте по input/output modalities для текста, изображений, аудио или видео.
  • Проверяйте supported_parameters до показа control в интерфейсе.
  • Не переносите параметры одной модели на другую только из-за похожего названия.

Цены и изменения

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

Считайте каталог изменяемым: модель может быть обновлена, снята или получить другой набор возможностей. Обновление кэша не должно ломать уже сохранённые истории.

Дальше