はじめに
text-embedding-3-small は、メモ、ヘルプ記事、文書の段落を類似検索用の数値ベクトルに変換します。標準の出力は 1,536 次元で、必要に応じて短縮できます。新しい検索コレクションで、保存サイズと検索品質を合わせて評価する用途に適しています。返されるのは入力の表現であり、文章による回答ではありません。
主な機能とハイライト
3-small の出力長を調整すると、メモアプリで 256 次元の小さな索引と標準の表現を比較できます。短いベクトルは保存容量を抑えられますが、実際の利用者が入力する質問で精度とのバランスを確かめてください。同じコレクションの文書と検索クエリには、共通の次元数を使用します。
3-small のバッチ処理では、各段落に対して個別のベクトルが返されます。結果の index を元の入力と対応付け、アプリ側の文書 ID、出典位置、閲覧権限を関連付けられます。本エンドポイントは 1 回につき 128 件まで受け付け、バッチ全体の実測入力トークン数に基づいて課金します。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
dimensions | いいえ | 3-small の dimensions は 1~1,536 です。文書と検索クエリには同じ次元数を使ってください。 |
embedding_input | はい | 3-small には文字列、文字列の配列、トークン ID の配列、またはトークン配列のバッチを渡せます。 |
料金
$0.000004 / 1,000 トークン
ユースケース
個人のノートを 3-small で検索する場合は、短い段落をノート ID とともに保存します。検索語と本文の表現が異なっていても、関連する候補を探せます。利用者が内容や日付を確認できるよう、検索結果には元の段落も表示してください。
サポート記事を 3-small で検索する場合は、問い合わせに関連する承認済みの記事を選び、その出典を別の文章生成モデルに渡せます。ベクトルの近さは検索の手掛かりです。どの記事を顧客に見せられるかは、アプリ側で判断します。
プロンプトガイドと実践のヒント
3-small に渡す長い文書は、意味の通る節の境界で分割します。単独では曖昧になる段落には、少量の前後の文脈を重ねてください。回答を作る指示ではなく、表現したい本文そのものを渡します。空文字列は受け付けず、各入力は 8,192 トークン以内、合計は 300,000 トークン以内です。事前に分割したトークン ID の配列は 2,048 要素までです。
3-small の索引を本番採用する前に、既知の質問を使って標準の次元数と短縮した設定を比較してください。索引にはモデル ID、次元数、文書分割のバージョンを保存し、設定を変更した範囲のベクトルは再作成します。候補を選ぶ際にはアカウントとプロジェクトの閲覧条件を適用し、元のメモが削除されたら索引からも取り除いてください。
{
"model": "openai/text-embedding-3-small/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-small/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 リファレンスを参照してください。


