VoyageAI by MongoDB: voyage-4-lite
Voyage AIのvoyage-4-liteは、Voyage 4ファミリーの低レイテンシーを重視したテキスト埋め込みエディションです。32,000トークンの入力、4種類のベクトル次元、量子化表現に対応し、ほかのVoyage 4テキストモデルと互換性のある共通の埋め込み空間を持ちます。
モデルについて
この説明はモデルの機能を紹介するものです。Ailootで利用できる入力、出力、オプションは、選択したメソッドごとに以下に記載されています。
voyage-4-liteは、Voyage AIのVoyage 4ファミリーに属する、低レイテンシーを重視したテキスト埋め込みモデルです。汎用的な検索のために、クエリと文書を数値ベクトルで表現します。ファミリーとしての特徴は、voyage-4、voyage-4-large、voyage-4-nanoと埋め込み空間を共有し、クエリ用と文書用のモデルを別々に選べることです。
検索の役割から始める
ユーザーが必要とする情報をクエリ、検索対象の資料を文書として準備してください。Voyageは検索にquery/documentの入力型を推奨しています。公開された手順は、テキストをベクトル化する際に、対応する検索指示を追加します。
従業員ハンドブックのコレクションなら、未使用の休暇を次の期間へ繰り越すことについてのクエリを、該当するポリシーの節と比較する必要があります。インデックス化する文章に、ルール、その条件、関連する例外を残してください。アプリケーションが実際のポリシー本文を返せるよう、元の文書と節の識別子をベクトルとともに保持します。
入力型を指定しない場合はテキストを直接表現し、query/documentの役割を指定すると検索に適した表現に調整します。メーカーは、役割設定の有無にかかわらず生成された埋め込みに互換性があると述べていますが、準備方針を一貫させるとコレクションを評価しやすくなります。
Voyage 4テキストファミリーで空間を共有する
Voyageは、voyage-4-largeで文書をエンコードし、voyage-4-liteのクエリベクトルで検索する、非対称な検索ワークフローを明示的に文書化しています。これはファミリーレベルの互換性についての説明であり、2つのモデルが同じベクトル長を返すことから導いた結論ではありません。
コレクション側とクエリ側で、選択したベクトル次元と表現を一致させてください。共通の空間により、この名前付きVoyage 4テキストファミリー内では、既存文書を再度ベクトル化せずにクエリモデルを変更することもできます。クエリエディションを選ぶ際は、代表的な質問で得られる順位を評価してください。
Liteエディションの役割は、小型で低レイテンシーを重視したクエリとテキスト埋め込みの選択肢です。メーカーは、混合エキスパートのアーキテクチャをvoyage-4-large固有のものとして説明しています。ファミリー名だけではLiteがその構造を持つとはいえません。
コンテキスト、次元、結果形式
公開コンテキスト長はテキストあたり32,000トークンです。既定のベクトルは1024次元で、Matryoshka学習により256、512、2048次元も使用できます。メーカーのテキスト埋め込みフローには、voyage-4-liteの浮動小数点、符号付きと符号なし8ビット整数、ビットパックされたバイナリ表現が記載されています。
標準の浮動小数点ベクトルについて、Voyageの類似度ガイダンスは単位長の埋め込みを説明し、コサイン類似度と内積類似度が同等になります。量子化形式には、それぞれに対応する表現処理が必要です。たとえば、ビットパックされたバイナリリストは、各バイトに埋め込みの8ビットを保存するため、リスト長は意味的なベクトル次元と異なります。
Voyageの文書化されたバッチ手順では、この正確なLiteエディションのリストは最大1000テキスト、合計100万トークンです。長すぎる入力の既定動作は、個々のテキストをコンテキスト境界まで切り詰めます。別の設定では、長すぎる入力を拒否します。バッチの上限とテキストごとの上限は別です。
検索結果を準備して点検する
長い原本資料は、証拠として返せる、意味的につながった節に分割してください。32,000トークンのコンテキストは長い入力を許容しますが、有用な検索単位は、引き続き関連する原本の節へ導けるものであるべきです。ルールの解釈に必要な見出しや識別上の詳細を含めてください。
RAGでは候補の節を検索し、その元のテキストを出典との対応関係とともに回答作成段階へ渡します。埋め込みモデルはベクトルを生成し、ポリシーについての回答は生成しません。類似度は、選んだモデルと比較設定の下で候補に順位を付けます。問われている正確な条件は、実際の文章で確認してください。
voyage-4-liteのエディション固有の有用な組み合わせは、低レイテンシー重視のテキストモデル、柔軟な表現、32,000トークンのコンテキスト、Voyage 4テキストファミリー内で文書化された互換性です。それらの特性をインデックス化したコレクションとともに管理し、出典に裏付けられた検索結果で周囲のアプリケーションを支援してください。
Ailoot Ultra · 埋め込み POST /v1/embeddings voyageai/voyage-4-lite
voyageai/voyage-4-liteはじめに
Voyage AIのvoyage-4-liteは、Voyage 4ファミリーの低レイテンシーを重視したテキスト埋め込みエディションです。32,000トークンの入力、4種類のベクトル次元、量子化表現に対応し、ほかのVoyage 4テキストモデルと互換性のある共通の埋め込み空間を持ちます。
- 対応する入力
- テキスト · token_ids
- 結果
- embedding
Ailootで利用可能 · 入力とメソッド
Ailoot Ultra · 埋め込み POST /v1/embeddings
- 入力の種類
text,token_ids- 出力の種類
embedding- コンテキスト
- 32,000 tokens
- 出力形式
- json
| フィールド | 種類 | 要件 | 値と制限 | デフォルト |
|---|---|---|---|---|
フィールドmodel | 種類string | 要件必須 | 値と制限 voyageai/voyage-4-lite | デフォルト— |
フィールドinput | 種類string|string[]|integer[]|integer[][] | 要件必須 | 値と制限 最小項目数: 1 条件: 空でなく、要素の型が統一されたバッチ。トークン ID は非負の整数です。 入力の許容量: 最大値: 32,000 · テキスト単位: 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 | 仕様32000 |
パラメータmultimodal_objects | 仕様false |
パラメータmaterial_types | 仕様text, token_ids |
ライフサイクル: synchronous_json
各ベクトルのインデックスと次元数を保存してください。
モデル名がマルチモーダルであることを示していても、この正確なパスでは画像オブジェクトは受け付けられません。
料金
料金情報はリクエストの機能を追加しません。対応するパラメーターは選択したメソッドに記載されています。
- 高速モード
- 標準料金 高速モードが選択されている場合
- Flex モード
- 標準料金 flex モードが選択されている場合
- 最大推論量
- 標準料金 推論量が最大で、調整に既定値（default）を使用する場合
Ailootの料金
設定別の価格
| 設定 | 料金表 | 料金 |
|---|---|---|
| 設定トークンの基本単価 | 料金表基本料金 | 料金 入力 · 入力トークン $0.00004 / 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": "voyageai/voyage-4-lite", "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='voyageai/voyage-4-lite',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 voyageai/voyage-4-lite
メソッドパスのエイリアス
上記に表示されたメソッドパスを使用してください。
関連する呼び出し用ID
FAQ · VoyageAI by MongoDB: voyage-4-lite
- 利用できる入力と結果は何ですか？
POST /v1/embeddings·voyageai/voyage-4-lite:text,token_ids→embedding- リクエストはどの項目を使用しますか？
POST /v1/embeddings·voyageai/voyage-4-lite:model,input,encoding_format,provider- どの制限が適用されますか？
POST /v1/embeddings·voyageai/voyage-4-lite:ctx:32000;input.budget.maximum:32000(UTF8 バイト);input.min_items:1