cicora.ai
Спецификация APIФайлы и вложения

Файлы и вложения

Загружайте файл отдельной операцией, храните его id и передавайте ссылку на него в последующем совместимом запросе.

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

Загрузите исходник

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

Передавайте бинарный контент через multipart там, где это требует маршрут. Не кодируйте большой файл в JSON, если операция ожидает multipart.

Upload a file for a later request
bash
curl --request POST https://cicora.ai/api/v1/files \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --form 'file=@analysis.pdf'

Привязка к запросу

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

Удаление и аудит

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

В журнале храните id и метаданные файла, а не копию его содержимого, если контент не нужен для сценария поддержки.