BGE-M3 · 傳送請求

BAAI 多語言文字向量模型，回傳 1024 維向量，適合多語言文件檢索。此 API 提供稠密向量，不提供稀疏權重或 ColBERT 多向量；查詢不需要特殊指令前綴。

2026-10-02 核查：在售渠道每百萬輸入 tokens $0.01 起。這是 APIMaster 渠道價格，並非供應商統一官方價；以即時模型卡片為準。 即時模型卡片

傳送請求

POST /v1/embeddings · model: bge-m3

cURL

export APIMASTER_API_KEY="YOUR_APIMASTER_API_KEY"
curl --fail-with-body "https://apimaster.ai/v1/embeddings" \
  -H "Authorization: Bearer $APIMASTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "bge-m3", "input": "Semantic search retrieves related documents.", "encoding_format": "float"}'

Python · OpenAI SDK

pip install openai

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["APIMASTER_API_KEY"],
    base_url="https://apimaster.ai/v1",
)
result = client.embeddings.create(
    model="bge-m3",
    input=["Semantic search retrieves related documents.", "猫在窗边休息。"],
    encoding_format="float",
)
for item in result.data:
    print(item.index, len(item.embedding))  # 1024
print(result.usage.prompt_tokens)

JavaScript · Node.js

const response = await fetch("https://apimaster.ai/v1/embeddings", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.APIMASTER_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "bge-m3",
    input: ["Semantic search retrieves related documents.", "猫在窗边休息。"],
    encoding_format: "float",
  }),
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const result = await response.json();
console.log(result.data.map((item) => [item.index, item.embedding.length]));
console.log(result.usage.prompt_tokens);

參數與限制

input 使用非空字串或非空字串陣列。使用 encoding_format: float 取得數值陣列，不要傳入 messages、max_tokens 或 stream。模型參考上限為每筆文字 8192 tokens；長文件請分段並控制批次大小。限制與分詞方式可能依渠道而異。

bge-m3 使用完整的 1024 維稠密向量，省略 dimensions。請求使用標準模型 ID bge-m3；response.model 可能顯示上游供應商別名。

讀取回應

讀取 data[i].embedding，透過 data[i].index 對應輸入。usage.prompt_tokens 與 usage.total_tokens 表示輸入用量。向量不是生成文字，不作為輸出 tokens 計費。base64 編碼亦已測試，float 則較易檢視。

單筆輸入、中英文批次、向量長度與重複輸入一致性皆已通過線上測試。此測試驗證 API 行為，不代表所有資料集的檢索品質。

語意搜尋與 RAG

將文件分段，產生並儲存每段向量；使用相同模型與維度產生查詢向量，按餘弦相似度排序，再將檢索文字交給另一個聊天模型。不同模型或維度的向量不可混用同一索引；更換模型時需重建索引。

常見問題

401 請檢查 API Key；400 請檢查模型 ID、非空 input 與選用參數；429 或上游逾時請降低併發並退避重試。渠道可用性與價格以模型廣場為準。

下一步與參考資料

• 文字向量概覽
• 取得 API Key
• 即時模型卡片
• 模型發布者文件