Alibaba Cloud Model Studio の埋め込みモデルは OpenAI API と互換性があります。既存の OpenAI アプリケーションを Model Studio に移行するには、以下の 3 つのパラメーターを調整するだけで済みます。
-
base_url：次の URL に置き換えます。
https://dashscope-intl.aliyuncs.com/compatible-mode/v1。中国 (北京) リージョンのモデルを使用する場合は、URL を https://dashscope.aliyuncs.com/compatible-mode/v1 に置き換えてください。中国 (香港) リージョンのモデルを使用する場合は、URL を https://cn-hongkong.dashscope.aliyuncs.com/compatible-mode/v1 に置き換えてください。
-
api_key：Model Studio API キーに置き換えます。
-
model：以下のリストからモデル名に置き換えます。
サポートされるモデル
シンガポール
| モデル | 埋め込みディメンション | 最大行数 | 1 行あたりの最大トークン数（注） | 料金（1M 入力トークンあたり） | サポート言語 | 無料クォータ （注） |
|---|---|---|---|---|---|---|
text-embedding-v4
| 2,048、1,536、1,024（デフォルト）、768、512、256、128、または 64 | 10 | 8,192 | $0.07 | 中国語、英語、スペイン語、フランス語、ポルトガル語、インドネシア語、日本語、韓国語、ドイツ語、ロシア語など 100 言語以上の主要言語 | 100 万トークン Model Studio アクティベート後 90 日間有効 |
text-embedding-v3 | 1,024（デフォルト）、768、または 512 | 中国語、英語、スペイン語、フランス語、ポルトガル語、インドネシア語、日本語、韓国語、ドイツ語、ロシア語など 50 言語以上の主要言語 | 50 万トークン Model Studio アクティベート後 90 日間有効 |
北京
| モデル | 埋め込みディメンション | 最大行数 | 1 行あたりの最大トークン数（注） | 料金（1M 入力トークンあたり） | サポート言語 |
|---|---|---|---|---|---|
text-embedding-v4
| 2,048、1,536、1,024（デフォルト）、768、512、256、128、または 64 | 10 | 8,192 | $0.072 | 中国語、英語、スペイン語、フランス語、ポルトガル語、インドネシア語、日本語、韓国語、ドイツ語、ロシア語など 100 言語以上の主要言語に加え、複数のプログラミング言語 |
中国 (香港)
| モデル | 埋め込みディメンション | 最大行数 | 1 行あたりの最大トークン数（注） | 料金（1M 入力トークンあたり） | サポート言語 |
|---|---|---|---|---|---|
text-embedding-v4
| 2,048、1,536、1,024（デフォルト）、768、512、256、128、または 64 | 10 | 8,192 | $0.07 | 中国語、英語、スペイン語、フランス語、ポルトガル語、インドネシア語、日本語、韓国語、ドイツ語、ロシア語など 100 言語以上の主要言語に加え、複数のプログラミング言語 |
qwen3-vl-embedding や tongyi-embedding-vision シリーズなどのマルチモーダル埋め込みモデルは、OpenAI 互換 API をサポートしていません。「マルチモーダル埋め込み」をご参照ください。
使用方法
呼び出し例
このセクションでは、Python（OpenAI SDK）および cURL（HTTP）を使用した文字列入力の例を紹介します。他のプログラミング言語または入力方法の例については、「テキスト埋め込みの始め方」をご参照ください。
OpenAI SDK
OpenAI SDK を使用してサービスを呼び出すには、まずOpenAI SDKをインストールする必要があります。
import os
from openai import OpenAI
def get_response():
client = OpenAI(
# API キーはリージョンによって異なります。API キーの取得先：https://www.alibabacloud.com/help/model-studio/get-api-key
api_key=os.getenv("DASHSCOPE_API_KEY"), # 環境変数を設定していない場合は、この値をご利用の API キーに置き換えてください。
# Model Studio サービスの base_url。中国 (北京) リージョンのモデルを使用する場合は、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", # 中国 (北京) リージョンのモデルを使用する場合は、モデル名を text-embedding-v4 に置き換えてください。
input='The quality of the clothes is excellent. They are beautiful. It was worth the wait. I like them and will buy from here again.',
encoding_format="float"
)
print(completion.model_dump_json())
if __name__ == '__main__':
get_response()
HTTP
インターフェイス呼び出しの送信
シンガポール：POST https://dashscope-intl.aliyuncs.com/compatible-mode/v1/embeddings
中国 (北京)：POST https://dashscope.aliyuncs.com/compatible-mode/v1/embeddings
コマンドラインからの呼び出し
# 中国 (北京) リージョンのモデルを使用する場合は、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": "The quality of the clothes is excellent. They are beautiful. It was worth the wait. I like them and will buy from here again.",
"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 リファレンス
エラーコード
モデルの呼び出しに失敗してエラーメッセージが返された場合は、「エラーメッセージ」を参照して対処してください。