API リファレンス

埋め込み

対応モデルはまだありません

現在、モデル一覧にこのルートに対応するモデルはありません。このページは参考として残しています。
POST/v1/embeddings

OpenAI 形式のベクトル埋め込み — text-embedding-3、jina-embeddings、voyage および各ベンダーの同等モデル。入力トークン数で課金されます。

#リクエストパラメーター

  • modelstring必須

    埋め込みモデルの ID(例:text-embedding-3-small)。

  • inputstring | array必須

    文字列 1 つ、または配列 — レスポンスは同じ順序でベクトルを返します。

  • dimensionsinteger任意

    マトリョーシカ次元に対応したモデルでベクトルを切り詰めます。

  • encoding_formatstring任意

    "float"(デフォルト)、またはペイロードを小さくする "base64"。

#関連するエラー

  • 400 invalid_request_errorボディの形式が不正か、このモデルが対応していないパラメーターがあります。
  • 401Bearer トークンが無効か、ありません。このパスでは error.code が付きません — ステータスで判定してください。
  • 402 insufficient_user_quotaウォレット残高が事前確保の見積額に足りません。
  • 429キー単位のレート制限です。ボディは空なので、Retry-After の時間だけ待ってください。insufficient_user_quota が付いた 429 は、レート制限ではなく 1 日の利用上限額によるものです。
  • 503 model_not_found不明なモデルか、現在そのモデルを提供できる正常なチャネルがありません。

エラーコード一覧 →

#リクエスト例

curl https://www.aisplice.store/v1/embeddings \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text-embedding-3-small",
    "input": ["hello world", "another sentence"]
  }'

#レスポンス

response.json
{
  "object": "list",
  "model": "text-embedding-3-small",
  "data": [
    {"object": "embedding", "index": 0, "embedding": [0.0023, -0.0091, …]},
    {"object": "embedding", "index": 1, "embedding": [0.0154,  0.0007, …]}
  ],
  "usage": {"prompt_tokens": 8, "total_tokens": 8}
}

まだ解決しませんか?

リクエスト ID かエラーメッセージを送っていただければ、こちらで調査します。