はじめに
text-embedding-ada-002 は、既存の ada 検索索引を利用するアプリ向けに、固定 1,536 次元のベクトルを返します。入力には本文と事前に分割したトークンを使えます。既存コレクションの保守や移行の比較に利用してください。同じ 1,536 次元を使う別モデルであっても、ada-002 の出力とそのまま混ぜることはできません。
主な機能とハイライト
ada-002 は出力長が固定されているため、既存のベクトル列を使った読み書きに dimensions の設定を追加する必要がありません。この接続では、既存コレクションとの互換性を維持する役割を担います。ただし、文書分割や前処理を変えると表現する本文も変わるため、それらの設定はモデルとともにバージョン管理してください。
ada-002 には 1 件または複数件の入力を渡せ、結果の index で各入力と対応付けられます。実際にトークン ID の配列を送った検証では、1,536 次元のベクトル 1 件と実測トークン数を取得しました。同期応答と保存するタスクの大きさを抑えるため、プラットフォームのバッチ上限は 128 件です。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
embedding_input | はい | ada-002 では既存の文書分割を維持し、検索クエリにも文書と同じモデルを使用してください。 |
料金
$0.00002 / 1,000 トークン
ユースケース
ada-002 を使う運用中のヘルプセンターでは、検索品質を見直しながら同じモデルで記事とクエリのベクトルを作り続けられます。類似度とは別に公開状態と顧客の権限を判定し、下書きや閲覧制限のある文書が検索に出ないようにしてください。
ada-002 から移行する際は、元の本文から候補モデル用の索引を別に作り、代表的な質問で両方を比較します。モデル間の座標値ではなく出典 ID で文書を対応付け、実際に取得した段落を確認してから検索先を切り替えてください。
プロンプトガイドと実践のヒント
ada-002 に送る本文は、既存の索引で用いている正規化と段落の区切り方を維持します。要約を指示するのではなく、表現したい段落そのものを渡してください。文章生成を依頼しても、説明文ではなくベクトルが返されます。各入力は 8,192 トークン以内、合計は 300,000 トークン以内で、トークン ID 配列は 2,048 要素までです。
ada-002 に dimensions は送らないでください。出力は固定の 1,536 次元です。バッチの結果は index と元の入力を対応付け、実測入力トークン数を利用記録に残します。別の埋め込みモデルに移行する場合は保存済みの文書ベクトルを再生成し、新しい索引の検索クエリにもその新モデルを使用してください。
{
"model": "openai/text-embedding-ada-002/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-ada-002/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 リファレンスを参照してください。


