cicora.ai
API 規格向量搜尋

嵌入向量

將文字或支援的輸入轉換為向量,用於搜尋、分群與推薦。

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

建立向量

input 欄位可接受單一項目或一個批次。請保留每個輸入的位置;回覆索引必須能對應至來源文件。

若無明確移轉計畫,請勿在同一索引中混用不同模型或維度產生的向量。

嵌入向量請求
bash
curl --request POST https://cicora.ai/api/v1/embeddings \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "openai/text-embedding-3-small",
    "input": ["First support note", "Second support note"],
    "encoding_format": "float"
  }'

建立索引

  • 建立索引與搜尋時,應採用相同方式標準化文字。
  • 每個索引都應保留模型 ID 與維度。
  • 建立嵌入向量前,先將長文件分割為有意義的區塊。

搜尋與評估

使用餘弦相似度或向量引擎要求的衡量方式,再視需要對小型候選集合套用重新排序。

定期使用真實查詢評估品質。數值相似度高不保證能提供實用的使用者答案。