Skip to main content

OpenAI 互換 - 埋め込み

Alibaba Cloud Model Studio の埋め込みモデルは OpenAI API と互換性があります。既存の OpenAI アプリケーションを Model Studio に移行するには、以下の 3 つのパラメーターを調整するだけで済みます。

サポートされるモデル

  • シンガポール
  • 北京
  • 中国 (香港)
モデル埋め込みディメンション最大行数1 行あたりの最大トークン数（注）料金（1M 入力トークンあたり）サポート言語無料クォータ （注）
text-embedding-v4
Qwen3-Embedding シリーズ
2,048、1,536、1,024（デフォルト）、768、512、256、128、または 64108,192$0.07中国語、英語、スペイン語、フランス語、ポルトガル語、インドネシア語、日本語、韓国語、ドイツ語、ロシア語など 100 言語以上の主要言語100 万トークンModel Studio アクティベート後 90 日間有効
text-embedding-v31,024（デフォルト）、768、または 512中国語、英語、スペイン語、フランス語、ポルトガル語、インドネシア語、日本語、韓国語、ドイツ語、ロシア語など 50 言語以上の主要言語50 万トークンModel Studio アクティベート後 90 日間有効
qwen3.7-text-embedding2,560、2,048、1,536、1,024（デフォルト）、768、512、25620128,000$0.07中国語、英語、スペイン語、フランス語、ポルトガル語、インドネシア語、日本語、韓国語、ドイツ語、ロシア語など 201 種類の主要言語と方言無料クォータなし
qwen3-vl-embedding や tongyi-embedding-vision シリーズなどのマルチモーダル埋め込みモデルは、OpenAI 互換 API をサポートしていません。「マルチモーダル埋め込み」をご参照ください。

使用方法

呼び出し例

このセクションでは、Python（OpenAI SDK）および cURL（HTTP）を使用した文字列入力の例を紹介します。他のプログラミング言語または入力方法の例については、「テキスト埋め込みの始め方」をご参照ください。
  • OpenAI SDK
  • HTTP
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()
コードを実行すると、次のような結果が返されます。 
{
  "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 リファレンス

エラーコード

モデルの呼び出しに失敗してエラーメッセージが返された場合は、「エラーメッセージ」を参照して対処してください。