使用OpenAI兼容接口调用Embedding模型 - Alibaba Cloud Model Studio

阿里雲百鍊的Embedding模型相容OpenAI介面規範。將原有 OpenAI 應用遷移至阿里雲百鍊只需調整三個參數：

base_url：替換為https://dashscope-intl.aliyuncs.com/compatible-mode/v1
如果使用華北2（北京）地區的模型，需要將url替換為：https://dashscope.aliyuncs.com/compatible-mode/v1
api_key：替換為阿里雲百鍊 API Key
model：替換為以下模型列表中的模型名稱

支援的模型

新加坡

模型名稱

向量維度

最大行數

單行最大處理Token數（注）

單價（每百萬輸入Token）

支援語種

免費額度（注）

text-embedding-v4

屬於Qwen3-Embedding系列

2,048、1,536、1,024（預設）、768、512、256、128、64

8,192

$0.07

中文、英語、西班牙語、法語、葡萄牙語、印尼語、日語、韓語、德語、俄羅斯語等100+主流語種

100萬Token

有效期間：百鍊開通後90天內

text-embedding-v3

1,024（預設）、768、512

中文、英語、西班牙語、法語、葡萄牙語、印尼語、日語、韓語、德語、俄羅斯語等50+主流語種

50萬Token

有效期間：百鍊開通後90天內

北京

模型名稱

向量維度

最大行數

單行最大處理Token數

支援語種

單價

（每百萬輸入Token）

text-embedding-v4

屬於Qwen3-Embedding系列

2,048、1,536、1,024（預設）、768、512、256、128、64

8,192

中文、英語、西班牙語、法語、葡萄牙語、印尼語、日語、韓語、德語、俄羅斯語等100+主流語種及多種程式設計語言

$0.072

模型調用

調用樣本

本章節提供Python（OpenAI SDK）和cURL（HTTP介面）的字串輸入調用樣本，更多程式設計語言或輸入方式樣本請參考：文本與多模態向量化。

使用OpenAI SDK調用

使用OpenAI SDK調用服務，您還需安裝OpenAI SDK。

import os
from openai import OpenAI

def get_response():
    client = OpenAI(
        api_key=os.getenv("DASHSCOPE_API_KEY"), # 如果您沒有配置環境變數，請在此處用您的API Key進行替換
        # 阿里雲百鍊服務的base_url，如果使用華北2（北京）地區的模型，需要將url替換為：https://dashscope.aliyuncs.com/compatible-mode/v1
        base_url="https://dashscope-intl.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://dashscope-intl.aliyuncs.com/compatible-mode/v1/embeddings
華北2（北京）：POST https://dashscope.aliyuncs.com/compatible-mode/v1/embeddings

命令列調用

# 如果使用華北2（北京）地區的模型，需要將url替換為：https://dashscope.aliyuncs.com/compatible-mode/v1/embeddings \
curl --location 'https://dashscope-intl.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參考

通用文本向量介面API詳情

錯誤碼

如果模型調用失敗並返回報錯資訊，請參見錯誤資訊進行解決。