テキスト

マルチモーダル Embedding の作成

マルチモーダル Embedding モデルを使用して Embedding ベクトルを作成します

POST
/v1/multimodal/embeddings

概要

このエンドポイントは、詳細情報に multimodal-embedding オペレーションが記載されているモデルで使用します。リクエストを送信する前に、GET /v1/models/{model} の supported_operations を確認してください。テキスト専用の Embedding モデルには Embedding の作成 を使用してください。それらのモデルに対してこのエンドポイントを使用すると 400 unsupported_endpoint が返されます。

現在はテキスト入力のみが有効です。image_url または image_base64 を含むリクエストは 400 image_input_deferred を返します。

リクエストボディ

modelstring必須

qwen3-vl-embedding など、multimodal-embedding をサポートするモデルの ID。

inputobject | array必須

1つの入力アイテム、またはアイテムの配列。各アイテムには以下のフィールドのうち少なくとも1つが必要であり、レスポンスには各アイテムにつき1つのエントリが含まれます。

  • text (string): Embedding を生成するテキスト。
  • image_url (string): 公開画像 URL。現在はまだ利用できません。
  • image_base64 (string) および image_mime_type (string): Base64 形式の画像データとその MIME タイプ。現在はまだ利用できません。
dimensionsinteger

返される各ベクトルの次元数(正の整数)。最大値はモデルによって異なります。

レスポンス

objectstring

常に list です。

dataarray

入力アイテムごとに1つのエントリ。

各エントリには以下が含まれます:

  • object (string): embedding
  • index (integer): 入力アイテムのインデックス
  • text_embedding (array): テキストアイテムのベクトル。エントリには、そのモダリティに応じて名前が付けられた1つのベクトルフィールド(text_embedding、image_embedding、video_embedding、または audio_embedding)が含まれます。
modelstring

使用されたモデル。

usageobject

モデルから報告された場合の prompt_tokens および total_tokens を含むトークン使用量。

リクエスト

curl -X POST "https://api.tokenlab.sh/v1/multimodal/embeddings" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen3-vl-embedding",
    "input": [
      {"text": "A red bicycle leaning against a brick wall"},
      {"text": "A city street at night"}
    ]
  }'

サンプルのベクトルは読みやすさのために短縮されています。

レスポンス

Response
{
  "object": "list",
  "data": [
    { "object": "embedding", "index": 0, "text_embedding": [0.0123, -0.0456, 0.0789] },
    { "object": "embedding", "index": 1, "text_embedding": [0.0211, 0.0334, -0.0102] }
  ],
  "model": "qwen3-vl-embedding",
  "usage": { "prompt_tokens": 18, "total_tokens": 18 }
}

エラー

ステータスコード原因
400invalid_requestinput が指定されていない、空である、またはアイテムに text、image_url、image_base64 のいずれも含まれていません
400unsupported_endpointモデルが multimodal-embedding をサポートしていません
400image_input_deferredアイテムに画像が含まれています

その他のステータスについては、API エラーの処理 に従って処理してください。

認証

BearerAuth
AuthorizationBearer <token>

APIキー認証。Dashboard > API > API KeysでAPIキーを作成または管理します。

場所: header

ヘッダー

X-TokenLab-Delivery-Policy?string

リクエストごとの配信ポリシー。APIキーおよびWorkspaceのデフォルト設定を上書きします。自動的にまず TokenLab Verified を試行し、出力、リクエストの受け入れ、または永続的なリソース作成の前に、一度だけ Official に切り替える場合があります。

指定できる値

  • "auto"
  • "verified"
  • "official"

リクエストボディ

application/json

レスポンス

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json