介面 / Vectors
Embeddings
POST
/v1/embeddings使用 OpenAI-compatible 用戶端建立向量 embedding。透過模型目錄確認哪些模型支援 embeddings，以及是否支援自訂 dimensions。
請求 Body
modelstringrequired
來自 /api/models/catalog 的 embedding 模型 ID。
inputstring | string[]required
文字輸入，或有序文字批次輸入。響應會保持輸入順序。
dimensionsintegernullable
支援截斷的模型可使用可選向量維度。
encoding_formatstringnullable
floatbase64上游支援時可選擇輸出編碼格式。
響應
objectstring通常為 list。
dataobject[]每個 input 對應一個 embedding item。
data[].embeddingnumber[] | string向量數值，或取決於 encoding_format 的 base64 編碼向量。
usage.prompt_tokensintegerembedding 使用的輸入 token 數。
批次建議
小批次可以直接傳陣列。大規模資料任務建議在用戶端分塊，確保每個請求都不超過 provider 的 body size 和 token 限制。