阿里雲百鍊的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(北京)、新加坡、中國香港地區推出了業務空間專屬網域名稱,能夠為推理請求提供卓越的效能和更高的穩定性,建議遷移至新網域名稱:
- 華北2(北京)地區:從
https://dashscope.aliyuncs.com遷移至https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com - 新加坡地區:從
https://dashscope-intl.aliyuncs.com遷移至https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com - 中國香港地區:從
https://cn-hongkong.dashscope.aliyuncs.com遷移至https://{WorkspaceId}.cn-hongkong.maas.aliyuncs.com
其中 {WorkspaceId} 為您的業務空間 ID,可在百鍊控制台的業務空間詳情頁面查看。現有網域名稱仍可正常使用。
支援的模型
新加坡
| 模型名稱 | 向量維度 | 批次大小 | 單行最大處理Token數(注) | 單價(每百萬輸入Token) | 支援語種 | 免費額度(注) |
|---|---|---|---|---|---|---|
text-embedding-v4
| 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天內 | |||
qwen3.7-text-embedding | 2,560、2,048、1,536、1,024(預設)、768、512、256 | 20 | 128,000 | $0.07 | 中文、英語、西班牙語、法語、葡萄牙語、印尼語、日語、韓語、德語、俄羅斯語等201種主流語種與方言 | 無免費額度 |
華北2(北京)
| 模型名稱 | 向量維度 | 批次大小 | 單行最大Token數(注) | 單價(每百萬輸入Token) | 支援語種 |
|---|---|---|---|---|---|
text-embedding-v4
| 2,048、1,536、1,024(預設)、768、512、256、128、64 | 10 | 8,192 | $0.072 | 中文、英語、西班牙語、法語、葡萄牙語、印尼語、日語、韓語、德語、俄羅斯語等100+主流語種及多種編程 |
中國香港
| 模型名稱 | 向量維度 | 批次大小 | 單行最大Token數(注) | 單價(每百萬輸入Token) | 支援語種 |
|---|---|---|---|---|---|
text-embedding-v4
| 2,048、1,536、1,024(預設)、768、512、256、128、64 | 10 | 8,192 | $0.07 | 中文、英語、西班牙語、法語、葡萄牙語、印尼語、日語、韓語、德語、俄羅斯語等100+主流語種及多種編程 |
多模態Embedding模型(例如qwen3-vl-embedding、tongyi-embedding-vision系列)不支援OpenAI相容介面。請參見多模態向量。
模型調用
調用樣本
本章節提供Python(OpenAI SDK)和cURL(HTTP介面)的字串輸入調用樣本,更多程式設計語言或輸入方式樣本請參考:文本與多模態向量化。
使用OpenAI SDK調用
使用OpenAI SDK調用服務,您還需安裝OpenAI SDK。
import os
from openai import OpenAI
def get_response():
client = OpenAI(
# 各地區的API Key不同。擷取API Key:https://www.alibabacloud.com/help/zh/model-studio/get-api-key
api_key=os.getenv("DASHSCOPE_API_KEY"), # 如果您沒有配置環境變數,請在此處用您的API Key進行替換
# 以下為新加坡地區base_url,調用時請將{WorkspaceId}替換為真實的業務空間ID,各地區URL不同。
base_url="https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
)
completion = client.embeddings.create(
model="text-embedding-v3", # 如果在華北2(北京)地區使用,需要將模型名稱替換為:text-embedding-v4
input='衣服的品質杠杠的,很漂亮,不枉我等了這麼久啊,喜歡,以後還來這裡買',
encoding_format="float"
)
print(completion.model_dump_json())
if __name__ == '__main__':
get_response()
使用HTTP介面調用
提交介面調用
新加坡:POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/embeddings
華北2(北京):POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1/embeddings
命令列調用
# 以下為新加坡地區URL,調用時請將{WorkspaceId}替換為真實的業務空間ID,各地區URL不同。
curl --location 'https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/embeddings' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "text-embedding-v3",
"input": "衣服的品質杠杠的,很漂亮,不枉我等了這麼久啊,喜歡,以後還來這裡買",
"encoding_format": "float"
}'
運行代碼可以獲得以下結果:
運行結果
{
"data": [
{
"embedding": [
0.0023064255,
-0.009327292,
....
-0.0028842222
],
"index": 0,
"object": "embedding"
}
],
"model":"text-embedding-v3",
"object":"list",
"usage":{"prompt_tokens":23,"total_tokens":23},
"id":"f62c2ae7-0906-9758-ab34-47c5764f07e2"
}
異常響應樣本
在訪問請求出錯的情況下,輸出的結果中會通過code和message指明出錯原因。
{
"error": {
"message": "Incorrect API key provided. ",
"type": "invalid_request_error",
"param": null,
"code": "invalid_api_key"
}
}
API參考
錯誤碼
如果模型調用失敗並返回報錯資訊,請參見錯誤碼進行解決。