はじめに
text-embedding-3-large は、多言語検索に使う文書を標準で 3,072 次元のベクトルに変換します。出力を短縮して、小さなベクトル索引に合わせることもできます。コレクションの言語や文書形式に沿って検索結果を評価し、大きな表現を保存する価値があるか判断できる用途で検討してください。
主な機能とハイライト
3-large の多言語表現は、質問と出典文書の言語が異なる検索で役立ちます。ただし、どの翻訳や専門用語も同じ精度で見つかるとは限りません。実際の文書で検証してください。ベクトルは意味の関係を表す数値であり、引用、正しさの保証、完成した回答は含みません。
3-large の dimensions では、標準の出力を 1,024 次元などに短縮できます。今回の接続では、2 件の文章を 1,024 次元で処理し、別の入力で標準の長さも確認しました。出力長は容量と検索品質の判断に関わりますが、バッチの課金は実測入力トークン数に基づきます。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
dimensions | いいえ | 3-large は 1~3,072 次元を指定できます。2 件の文章を使い、1,024 次元の出力を確認しました。 |
embedding_input | はい | 3-large には回答の指示ではなく検索対象の本文を渡してください。バッチの結果には入力順の index が付きます。 |
料金
$0.000026 / 1,000 トークン
ユースケース
多言語の製品ナレッジを 3-large で検索すると、顧客の言語で書かれた質問に対して出典候補を選べます。言語、製品の版、文書の改訂情報を個別のメタデータとして保存し、関連性の高そうな旧版が現在の手順に優先されないようにしてください。
研究文書を 3-large で索引化する場合は、関連する技術的な段落を順位付けし、元の出典とともに後段の分析モデルへ渡せます。文書の境界と参照 ID を維持すると、最終的な説明を検索で得た根拠と照合できます。
プロンプトガイドと実践のヒント
3-large の評価には、利用者が使う言語の質問と、見つかるべき段落の組を用意します。略語、よく似た文書、適切な出典が存在しない質問も含めてください。索引の構造を決める前に 3,072 次元と 1,024 次元を比較します。次元数が同じでも、異なるモデルのベクトルを同じ空間で扱えるわけではありません。
3-large には、1 件の段落か、文字列またはトークン配列を同じ形式でそろえたバッチを送ります。プラットフォームの上限は 128 件、各入力 8,192 トークン、合計 300,000 トークンで、トークン ID 配列は 2,048 要素までです。保存する前に結果の index を確認し、検索クエリには同じモデルと次元数を使い、本文を変更した文書のベクトルは再生成してください。
{
"model": "openai/text-embedding-3-large/embedding",
"input": [
"A notebook about coastal birds.",
"An index of harbor observations."
]
}
API クイックスタート
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "openai/text-embedding-3-large/embedding",
"input": {
"embedding_input": "The customer asks for a refund after being billed twice."
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。


