Mistral: Mistral Embed 2312
Mistral Embed 2312は、意味検索、情報検索、関連テキスト分析のために、テキストを1,024次元のベクトルへ変換します。メーカーのページには8kのコンテキストが記載されています。結果は生成された回答ではなく、各入力に結び付いた数値表現です。
モデルについて
この説明はモデルの機能を紹介するものです。Ailootで利用できる入力、出力、オプションは、選択したメソッドごとに以下に記載されています。
Mistral Embed 2312は、意味を数値で表現するMistral AIのテキスト埋め込みモデルです。テキスト文字列または文字列のリストを受け取り、入力ごとに埋め込みを返します。結果は、会話形式の説明ではなく、アプリケーションが類似度比較、検索、分類、クラスタリングに使うベクトルです。メーカーの固定モデルページには、mistral-embed-2312というIDが示されています。
入力、コンテキスト、ベクトルの形
この正確なモデルページには、8kというコンテキスト表記が記載されています。各テキスト項目を適用される入力容量の範囲内で準備し、その項目の識別情報をベクトルとともに保持してください。長い原本文書は有用な文章単位に分割しながら、その後で正しい資料を返すために必要な文書タイトル、節、出典の位置を残せます。
メーカーのMistral Embedガイドは、入力の見た目の長さにかかわらず、各テキストの埋め込みを1,024次元と指定しています。したがって、短い質問と長めの文章は、内容やトークン数が異なっても同じ形のベクトルになります。これは出力表現の次元であり、回答トークンの上限や、保持される原文の単語数を示す尺度ではありません。
文書化された応答には、埋め込みとトークン使用量情報が含まれます。エンドポイントの例は、各ベクトルを入力インデックスに対応付けています。複数のテキストを処理する際は、その対応関係を維持してください。有用な検索結果を表示したり、後の工程に出典資料を提供したりするために、アプリケーションには数値結果に加えて元のテキストと識別子も必要です。
意味的な類似度
ガイドは、関連するテキストは埋め込み空間で近くなる傾向があると説明しています。これにより、同じ話題や要件を異なる言葉で表現した文章を見つけやすくなります。ナレッジベースのクエリの例なら、アクセスを回復する方法を質問し、関連手順では同じ操作に別の表現を使っている場合があります。アプリケーションは、完全な単語一致だけに頼らず、クエリのベクトルを保存済み文章のベクトルと比較できます。
メーカーの例では、単位長に正規化した埋め込みを使用しています。そのようなベクトルでは、コサイン類似度、内積、ユークリッド距離の数値は同一ではなくても、一貫した類似順位が得られます。適切な比較方法を1つ選び、クエリと文書の表現全体に一貫して適用してください。
類似していることは、2つの記述を置き換えられる証明ではありません。原文を残し、質問に重要な条件、日付、識別子を点検してください。2つの文章が同じ話題を扱いながら、異なる手順や例外を説明することもあります。埋め込みは検索信号を提供し、選ばれた文章の解釈はタスクの別の部分です。
検索と出典に基づく回答
実用的な文書ワークフローでは、ナレッジベースの文章にベクトルを準備し、その識別子と原文を保存して、新しい質問をそのコレクションと比較します。関連する文章を出典の位置とともに返してください。アプリケーションは、それらの文章を直接表示することも、検索資料に基づいて回答を書くテキスト生成モデルに渡すこともできます。
有用な検索結果のために、文書タイトル、節、文章、それを見つけるための識別子を残してください。そうすればサポートアシスタントは、ユーザーの質問に関連する手順を検索し、回答作成段階に渡せます。Mistral Embedが行うのは数値表現の段階です。最終的な説明を起草したり、外部の行動を実行したりするわけではありません。
その他の文書化された用途
メーカーは、埋め込みワークフローとして、言い換えの検出、分類、クラスタリング、バッチ処理も挙げています。比較タスクでは、確認のために意味の関連する文章を検索できます。分類ワークフローでは、入力をラベル付きの例と比較したり、ベクトルを別の分類器の特徴量として使ったりできます。クラスタリングのワークフローでは、似た項目をグループにまとめ、その後で人やアプリケーションの段階が説明を付けられます。
データを準備する前に、表現の目的を定義してください。意味検索に使う文章は、検索後に必要になる情報を残すべきです。分類の例には、そのクラスを区別する表現を含めるべきです。クエリと保存された項目が比較可能な資料を表現するよう、準備方式を一致させてください。
エディションと出力の境界
文書とそのクエリには、同じモデルエディションと互換性のある表現を使用してください。別のモデルから得た同じ座標数のベクトルが、自動的に同じ意味空間に属するわけではありません。モデルや表現を置き換える場合も、保存済みの項目とクエリの整合性を保つ必要があります。
この項目は、メーカーの8kコンテキストと、Mistral Embedで文書化された1,024次元表現を持つ、テキスト入力と数値ベクトル出力を説明しています。Codestral Embedの設定可能な次元や量子化形式は、別名のコードモデルに属し、ここで使えると想定するべきではありません。画像、音声、文章生成、ツール実行は、このテキスト埋め込み結果の範囲外にある別の機能です。
Ailoot Ultra · 埋め込み POST /v1/embeddings mistralai/mistral-embed-2312
mistralai/mistral-embed-2312はじめに
Mistral Embed 2312は、意味検索、情報検索、関連テキスト分析のために、テキストを1,024次元のベクトルへ変換します。メーカーのページには8kのコンテキストが記載されています。結果は生成された回答ではなく、各入力に結び付いた数値表現です。
- 対応する入力
- テキスト · token_ids
- 結果
- embedding
Ailootで利用可能 · 入力とメソッド
Ailoot Ultra · 埋め込み POST /v1/embeddings
- 入力の種類
text,token_ids- 出力の種類
embedding- コンテキスト
- 8,192 tokens
- 出力形式
- json
| フィールド | 種類 | 要件 | 値と制限 | デフォルト |
|---|---|---|---|---|
フィールドmodel | 種類string | 要件必須 | 値と制限 mistralai/mistral-embed-2312 | デフォルト— |
フィールドinput | 種類string|string[]|integer[]|integer[][] | 要件必須 | 値と制限 最小項目数: 1 条件: 空でなく、要素の型が統一されたバッチ。トークン ID は非負の整数です。 入力の許容量: 最大値: 8,192 · テキスト単位: UTF8 バイト · トークン単位: トークン配列の要素 | デフォルト— |
フィールドencoding_format | 種類string | 要件任意 | 値と制限 float | デフォルトfloat |
フィールドdimensions | 種類integer | 要件非対応 | 値と制限 最小値: 1 | デフォルト— |
フィールドuser | 種類json_value | 要件任意 | 値と制限 条件: ソースではこの JSON メタデータフィールドが許可されています。上流側での正確な意味はモデルによって異なります。 | デフォルト— |
フィールドsession_id | 種類json_value | 要件任意 | 値と制限 条件: ソースではこの JSON メタデータフィールドが許可されています。上流側での正確な意味はモデルによって異なります。 | デフォルト— |
フィールドtrace | 種類json_value | 要件任意 | 値と制限 条件: ソースではこの JSON メタデータフィールドが許可されています。上流側での正確な意味はモデルによって異なります。 | デフォルト— |
フィールドprovider | 種類object | 要件任意 | 値と制限 条件: provider.options は拒否されます | デフォルト— |
入力素材の組み合わせ
text_to_embedding
メソッドのパラメータとライフサイクル
| パラメータ | 仕様 |
|---|---|
パラメータcontent_type | 仕様application/json |
パラメータrequired | 仕様model, input |
パラメータinput_shapes | 仕様string, string[], nonnegative_integer_token_array, nonnegative_integer_token_array[] |
パラメータencoding_format | 仕様float |
パラメータdimensions_override | 仕様false |
パラメータmax_input_budget_units | 仕様8192 |
パラメータmultimodal_objects | 仕様false |
パラメータmaterial_types | 仕様text, token_ids |
ライフサイクル: synchronous_json
各ベクトルのインデックスと次元数を保存してください。
モデル名がマルチモーダルであることを示していても、この正確なパスでは画像オブジェクトは受け付けられません。
料金
料金情報はリクエストの機能を追加しません。対応するパラメーターは選択したメソッドに記載されています。
- 高速モード
- 標準料金 高速モードが選択されている場合
- Flex モード
- 標準料金 flex モードが選択されている場合
- 最大推論量
- 標準料金 推論量が最大で、調整に既定値(default)を使用する場合
Ailootの料金
設定別の価格
| 設定 | 料金表 | 料金 |
|---|---|---|
| 設定トークンの基本単価 | 料金表基本料金 | 料金 入力 · 入力トークン $0.0002 / 1K トークン 出力 · 出力トークン $0 / 1K トークン 入力 · キャッシュ読み取り — / 1K トークン 入力 · キャッシュ書き込み — / 1K トークン 入力 · キャッシュ書き込み、1時間 — / 1K トークン |
Ailootはリクエスト前に見積額を確保します。結果の取得後、実測使用量に基づいて最終料金を精算します。ストリーミング時の精算には最終の使用量記録を使用します。金額の確保と精算の仕組み →
リクエスト例
Ailoot Ultra · 埋め込み
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "mistralai/mistral-embed-2312", "input": ["First document", "Second document"]}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/embeddings \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path("result.json").read_text())
for x in r.get("data",[]): print(json.dumps({"index":x.get("index"),"embedding":x.get("embedding")}))
PY_RESULT
from openai import OpenAI
import os
client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)
result=client.embeddings.create(model='mistralai/mistral-embed-2312',input=["First document","Second document"])
print(result)
for item in result.data:print(item.index,item.embedding)
結果を受け取って保存
Ailoot Ultra · 埋め込み
json
完了した結果をすべて保存
返された完全なレスポンス、ファイル、コンテンツ部分をすべて保存してください。
すべてのベクトルを、そのインデックスとともに保存してください。ベクトル数は入力数と一致し、次元数は統一されている必要があります。
元のレスポンスを確認する場合
埋め込みジョブ用のエンドポイントは新設されません。
レスポンスのフィールド
| フィールド | 種類 |
|---|---|
フィールドobject | 種類string |
フィールドmodel | 種類string |
フィールドdata[].index | 種類integer |
フィールドdata[].embedding | 種類finite float[] |
フィールドusage | 種類object |
エラーと次の手順
| レスポンス | 条件 | 次の手順 |
|---|---|---|
レスポンス400 · invalid_request_error | 条件必須フィールド、素材の表現形式、またはパラメーター値が不正です | 次の手順新しい生成リクエストを送る前に、指定されたフィールドを修正してください。 |
エイリアス
モデルのエイリアス
Ailoot Ultra mistralai/mistral-embed-2312
メソッドパスのエイリアス
上記に表示されたメソッドパスを使用してください。
関連する呼び出し用ID
FAQ · Mistral: Mistral Embed 2312
- 利用できる入力と結果は何ですか?
POST /v1/embeddings·mistralai/mistral-embed-2312:text,token_ids→embedding- リクエストはどの項目を使用しますか?
POST /v1/embeddings·mistralai/mistral-embed-2312:model,input,encoding_format,provider- どの制限が適用されますか?
POST /v1/embeddings·mistralai/mistral-embed-2312:ctx:8192;input.budget.maximum:8192(UTF8 バイト);input.min_items:1