埋め込みモデルは、テキスト、画像、動画などのデータをベクトルに変換し、セマンティック検索、レコメンデーション、クラスタリング、分類、異常検知などの下流タスクに利用します。
前提条件
API キーを取得し、API キーを環境変数としてエクスポートします。OpenAI SDK または DashScope SDK を使用して呼び出しを行う場合は、SDK をインストールします。
埋め込みの取得
- テキスト埋め込み
- 独立したマルチモーダルベクトル
- マルチモーダル融合ベクトル
- OpenAI 互換 API
- DashScope
モデルの選択
入力データの種類とユースケースに基づいて、適切なモデルを選択してください。
-
プレーンテキストまたはコードの処理:
qwen3.7-text-embeddingを使用します。これは最高のパフォーマンスを発揮するモデルで、タスク命令や疎ベクトルなどの高度な機能をサポートし、ほとんどのテキスト処理ユースケースをカバーします。 -
マルチモーダルコンテンツの処理:
- 融合埋め込み:クロスモーダル検索や画像検索などのユースケースで、単一モーダルまたは混合モーダルの入力を融合埋め込みとして表現するには、
qwen3-vl-embeddingを使用します。たとえば、シャツの画像と「より若々しく見える類似のスタイルを探す」というテキストを入力すると、モデルは画像とタスク命令を単一の埋め込みに融合して処理します。 - 独立した埋め込み:各入力部分 (画像とそれに対応するテキストキャプションなど) に対して独立した埋め込みを生成するには、
tongyi-embedding-vision-plus、tongyi-embedding-vision-flash、または汎用マルチモーダルモデルmultimodal-embedding-v1を使用します。
- 融合埋め込み:クロスモーダル検索や画像検索などのユースケースで、単一モーダルまたは混合モーダルの入力を融合埋め込みとして表現するには、
-
大規模データの処理:大規模で非リアルタイムのテキストデータを処理するには、
qwen3.7-text-embeddingまたはtext-embedding-v4を OpenAI 互換バッチ API とともに使用することで、コストを大幅に削減できます。
テキスト埋め込み
- 北京
- 香港
- シンガポール
| モデル名 | 埋め込み次元 | バッチサイズ | 最大バッチトークン数 (注) | 価格 / 100 万トークン | 言語 |
|---|---|---|---|---|---|
text-embedding-v4Qwen3-Embedding シリーズの一部 | 2,048、1,536、1,024 (デフォルト)、768、512、256、128、64 | 10 | 8,192 | $0.072 | 中国語、英語、スペイン語、フランス語、ポルトガル語、インドネシア語、日本語、韓国語、ドイツ語、ロシア語、および複数のプログラミング言語を含む 100 以上の主要言語 |
- 文字列配列入力:配列には最大 10 個の要素を含めることができます。
- ファイル入力:テキストファイルには最大 10 行を含めることができます。
マルチモーダル埋め込み
このモデルは、テキスト、画像、または動画の入力から埋め込みを生成します。これらの埋め込みを、動画および画像の分類、画像とテキストの検索、テキストによる画像検索またはテキストによる動画検索などのタスクに使用できます。
API は、単一のテキスト、画像、または動画の入力、およびテキストと画像のような組み合わせを受け入れます。一部のモデルは、複数の画像など、同じタイプの複数の入力をサポートします。詳細については、各モデルの制限事項をご参照ください。
- シンガポール
- 中国 (北京)
モデル | 埋め込み次元 | テキスト長の制限 | 画像サイズの制限 | 動画サイズの制限 | 価格 (100 万トークンあたり) | 無料クォータ(注) |
|---|---|---|---|---|---|---|
tongyi-embedding-vision-plus | 1152(デフォルト)、1024、512、256、128、64 | 1,024 トークン | 画像あたり最大 3 MB。最大 8 枚の画像をサポートします。 | 動画ファイルあたり最大 10 MB | 画像/動画:$0.09 テキスト:$0.09 | 100 万トークン この無料クォータは、Model Studio のアクティベーション日、モデルのリリース日、またはアプリケーションの承認日のうち、いずれか遅い方から 90 日間有効です。 |
tongyi-embedding-vision-flash | 768(デフォルト)、512、256、128、64 | 画像/動画:$0.03 テキスト:$0.09 |
入力と言語の制限
| 融合マルチモーダルモデル | ||||
|---|---|---|---|---|
| モデル | テキスト | 画像 | 動画 | リクエスト制限 |
| qwen3-vl-embedding | 中国語、英語、日本語、韓国語、フランス語、ドイツ語など、33 の主要言語をサポートします。
サポートされているすべての言語 中国語、日本語、韓国語、インドネシア語、ベトナム語、タイ語、英語、フランス語、ドイツ語、ロシア語、ポルトガル語、スペイン語、イタリア語、スウェーデン語、デンマーク語、チェコ語、ノルウェー語、オランダ語、フィンランド語、トルコ語、ポーランド語、スワヒリ語、ルーマニア語、セルビア語、ギリシャ語、カザフ語、ウズベク語、セブアノ語、アラビア語、ウルドゥー語、ペルシャ語、ヒンディー語/デーヴァナーガリー、ヘブライ語。 | JPEG、PNG、WEBP、BMP、TIFF、ICO、DIB、ICNS、SGI (URL または Base64 をサポート) | MP4、AVI、MOV (URL のみ) | 1 回のリクエストに含まれるコンテンツ要素の総数は 20 を超えることはできません。画像の数は 5 を超えることはできません。画像、テキスト、動画はこの制限を共有します。 |
| 独立したマルチモーダルモデル | ||||
| モデル | テキスト | 画像 | 動画 | リクエスト制限 |
| tongyi-embedding-vision-plus | 中国語/英語 | JPG、PNG、BMP (URL または Base64 をサポート) | MP4、MPEG、AVI、MOV、MPG、WEBM、FLV、MKV (URL のみ) | コンテンツ要素の数に制限はありません。入力トークンの合計数がトークン制限を超えてはなりません。 |
| tongyi-embedding-vision-flash | ||||
| multimodal-embedding-v1 | 1 回のリクエストに含まれるコンテンツ要素の総数は 20 を超えることはできません。リクエストには最大 1 枚の画像、1 つの動画、20 個のテキストエントリを含めることができます。これらのアイテムは合計制限を共有します。 | |||
コア機能
ベクトル次元のカスタマイズ
qwen3.7-text-embedding、text-embedding-v4、text-embedding-v3、tongyi-embedding-vision-plus、tongyi-embedding-vision-flash、qwen3-vl-embedding モデルは、カスタムベクトル次元をサポートしています。次元が高いほど、より多くのセマンティック情報が保持されますが、ストレージと計算コストが増加します。
- 一般的なユースケース (推奨):1024 次元は、パフォーマンスとコストの最適なバランスを提供し、ほとんどのセマンティック検索タスクに最適です。
- 高精度シナリオ:高精度を必要とするアプリケーションでは、1536 または 2048 次元を選択できます。これにより精度が向上しますが、ストレージと計算のオーバーヘッドが大幅に増加します。
- リソースに制約のある環境:コストに敏感なシナリオでは、768 以下の次元を選択します。これにより、一部のセマンティック情報を犠牲にして、リソース消費を大幅に削減します。
クエリ vs. ドキュメントテキスト (text_type)
このパラメーターは、DashScope SDK および API を通じてのみ利用可能です。検索タスクで最適な結果を得るには、その役割に基づいてコンテンツを異なる方法でベクトル化する必要があります。
text_type パラメーターはこの目的のために設計されています:
text_type: 'query':ユーザーが提供するクエリテキストに使用します。モデルは、より指向性が高く、情報検索に最適化された「タイトルのような」ベクトルを生成します。text_type: 'document'(デフォルト):ナレッジベースに保存されているドキュメントテキストに使用します。モデルは、より包括的な情報を含み、マッチングに最適化された「本文のような」ベクトルを生成します。
query と document を区別する必要があります。ただし、すべてのテキストが同じ役割を持つクラスタリングや分類などのタスクでは、このパラメーターを設定する必要はありません。
タスク命令 (instruct)
このパラメーターは、DashScope SDK および API を通じてのみ利用可能です。明確な英語のタスク命令を提供することで、
qwen3.7-text-embedding および text-embedding-v4 モデルを特定の検索シナリオに合わせてベクトル品質を最適化し、精度を向上させることができます。qwen3.7-text-embedding は text-embedding-v4 よりも命令追従能力が 16.4% 向上しているため、最初に使用することを推奨します。この機能を使用する場合、text_type パラメーターを query に設定する必要があります。
密ベクトルと疎ベクトル
このパラメーターは、DashScope SDK および API を通じてのみ利用可能です。
qwen3.7-text-embedding、text-embedding-v4、および text-embedding-v3 モデルは、さまざまな検索戦略に対応するために 3 つのベクトル出力タイプをサポートしています。qwen3.7-text-embedding の疎埋め込みは、新しい SPLADE のようなトレーニング戦略を使用しており、効果を 8.4% 向上させ、クロス言語検索のサポートを追加しています。
ベクトルタイプ (output_type) | 利点 | 制限事項 | ユースケース |
|---|---|---|---|
dense | 深いセマンティック理解により、同義語や文脈を特定し、より関連性の高い結果を提供します。 | 計算およびストレージコストが高い。キーワードの完全一致を保証しません。 | セマンティック検索、AI による Q&A、コンテンツレコメンデーション。 |
sparse | 高い計算効率で、キーワードの完全一致に焦点を当て、高速なフィルタリングを可能にします。 | セマンティック理解に欠け、同義語や文脈を処理できません。 | ログ検索、製品 SKU 検索、精密な情報フィルタリング。 |
dense&sparse | セマンティックマッチングとキーワードマッチングを組み合わせて、最適な検索結果を提供します。生成コストは変わらず、API 呼び出しのオーバーヘッドは単一ベクトルモードと同じです。 | より多くのストレージが必要であり、システムアーキテクチャと検索ロジックがより複雑になります。 | 高品質な本番環境グレードのハイブリッド検索エンジン。 |
ユースケース
以下のコードはデモンストレーションのみを目的としています。本番環境では、埋め込みを事前に計算し、ベクトルデータベースに保存してください。これにより、検索のためにクエリ埋め込みを生成するだけで済みます。
セマンティック検索
クエリ埋め込みとドキュメント埋め込みの間の類似度を計算することにより、正確なセマンティックマッチングを実行します。
レコメンデーションシステム
ユーザーの行動履歴の埋め込みを分析して興味を特定し、類似のアイテムを推奨します。
テキストクラスタリング
埋め込み間の距離を分析することで、類似したテキストをグループ化します。
テキスト分類
入力テキストの埋め込みと事前定義されたラベル埋め込みとの類似度を計算することで、ゼロショットテキスト分類を実行します。このプロセスは、事前にラベル付けされた例を必要とせずに、テキストを新しいカテゴリに分類します。
異常検知
テキストの埋め込みと正常なサンプルの中心埋め込みとの類似度を計算することで、異常データを特定します。このパターンから著しく逸脱したデータは異常と見なされます。
例の threshold はデモンストレーション目的です。理想的な値はデータの内容と分布によって異なるため、ご自身のデータセットを使用して調整する必要があります。
API リファレンス
- 一般的なテキスト埋め込み
- マルチモーダル埋め込み マルチモーダル埋め込み API
エラーコード
モデルの呼び出しが失敗し、エラーメッセージが返された場合は、解決策について「エラーコード」をご参照ください。
レート制限
モデルのレート制限条件については、「レート制限」をご参照ください。
モデルのパフォーマンス (MTEB/CMTEB)
評価ベンチマーク
- MTEB (Massive Text Embedding Benchmark):分類、クラスタリング、検索などのタスクにおけるテキスト埋め込みの汎用的なパフォーマンスを評価する包括的なベンチマークです。
- CMTEB (Chinese Massive Text Embedding Benchmark):中国語のテキスト埋め込みを評価するために特化した大規模なベンチマークです。
- スコアは 0 から 100 の範囲です。スコアが高いほど、パフォーマンスが良いことを示します。
モデル | MTEB | MTEB (検索タスク) | CMTEB | CMTEB (検索タスク) |
|---|---|---|---|---|
text-embedding-v3 (512 次元) | 62.11 | 54.30 | 66.81 | 71.88 |
text-embedding-v3 (768 次元) | 62.43 | 54.74 | 67.90 | 72.29 |
text-embedding-v3 (1024 次元) | 63.39 | 55.41 | 68.92 | 73.23 |
text-embedding-v4 (512 次元) | 64.73 | 56.34 | 68.79 | 73.33 |
text-embedding-v4 (1024 次元) | 68.36 | 59.30 | 70.14 | 73.98 |
text-embedding-v4 (2048 次元) | 71.58 | 61.97 | 71.99 | 75.01 |