阿里雲百鍊的Embedding模型相容OpenAI介面規範。將原有 OpenAI 應用遷移至阿里雲百鍊只需調整三個參數:
-
base_url:替換為
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1,請將{WorkspaceId}替換為實際的業務空間ID其他地區請替換base_url:
- api_key:替換為阿里雲百鍊 API Key
- model:替換為以下模型列表中的模型名稱
支援的模型
- 新加坡
- 華北2(北京)
- 中國香港
| 模型名稱 | 向量維度 | 批次大小 | 單批次最大處理Token數(注) | 單價(每百萬輸入Token) | 支援語種 | 免費額度(注) |
|---|---|---|---|---|---|---|
text-embedding-v4屬於Qwen3-Embedding系列 | 2,048、1,536、1,024(預設)、768、512、256、128、64 | 10 | 8,192 | $0.07 | 中文、英語、西班牙語、法語、葡萄牙語、印尼語、日語、韓語、德語、俄羅斯語等100+主流語種 | 100萬Token有效期間:百鍊開通後90天內 |
| text-embedding-v3 | 1,024(預設)、768、512 | 中文、英語、西班牙語、法語、葡萄牙語、印尼語、日語、韓語、德語、俄羅斯語等50+主流語種 | 50萬Token有效期間:百鍊開通後90天內 |
多模態Embedding模型(例如qwen3-vl-embedding、tongyi-embedding-vision系列)不支援OpenAI相容介面。請參見多模態向量。
模型調用
調用樣本
本章節提供Python(OpenAI SDK)和cURL(HTTP介面)的字串輸入調用樣本,更多程式設計語言或輸入方式樣本請參考:文本與多模態向量化。
- 使用OpenAI SDK調用
- 使用HTTP介面調用
使用OpenAI SDK調用服務,您還需安裝OpenAI SDK。
運行結果
運行結果
異常響應樣本
在訪問請求出錯的情況下,輸出的結果中會通過code和message指明出錯原因。