cicora.ai
API 規格附件

檔案與附件

透過專用操作上傳檔案、保留其 ID,並在後續相容請求中傳送參照。

整合參考:請從帳戶 API 設定及適用於您環境的模型目錄中選擇參數與可用功能。

上傳來源

傳送前先檢查檔案類型、大小、權利與保留期間。檔案應取得穩定 ID,不應依賴使用者可變更的名稱。

路由要求時,請透過 multipart 傳送二進位內容。若操作預期 multipart,請勿將大型檔案編碼進 JSON。

上傳檔案供後續請求使用
bash
curl --request POST https://cicora.ai/api/v1/files \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --form 'file=@analysis.pdf'

附加至請求

  • 將檔案 ID 與擁有者、專案及保留日期建立關聯。
  • 只能使用模型支援的附件類型。
  • 將來源檔案與擷取文字及衍生成品分開保存。

刪除與稽核

依保留排程與擁有者要求刪除暫存附件。

若支援作業不需要檔案內容,請在日誌中保留檔案 ID 與中繼資料,不要複製其內容。