テキスト
マルチモーダル Embedding の作成
マルチモーダル Embedding モデルを使用して Embedding ベクトルを作成します
概要
このエンドポイントは、詳細情報に multimodal-embedding オペレーションが記載されているモデルで使用します。リクエストを送信する前に、GET /v1/models/{model} の supported_operations を確認してください。テキスト専用の Embedding モデルには Embedding の作成 を使用してください。それらのモデルに対してこのエンドポイントを使用すると 400 unsupported_endpoint が返されます。
現在はテキスト入力のみが有効です。image_url または image_base64 を含むリクエストは 400 image_input_deferred を返します。
リクエストボディ
qwen3-vl-embedding など、multimodal-embedding をサポートするモデルの ID。
1つの入力アイテム、またはアイテムの配列。各アイテムには以下のフィールドのうち少なくとも1つが必要であり、レスポンスには各アイテムにつき1つのエントリが含まれます。
text(string): Embedding を生成するテキスト。image_url(string): 公開画像 URL。現在はまだ利用できません。image_base64(string) およびimage_mime_type(string): Base64 形式の画像データとその MIME タイプ。現在はまだ利用できません。
返される各ベクトルの次元数(正の整数)。最大値はモデルによって異なります。
レスポンス
常に list です。
入力アイテムごとに1つのエントリ。
各エントリには以下が含まれます:
object(string):embeddingindex(integer): 入力アイテムのインデックスtext_embedding(array): テキストアイテムのベクトル。エントリには、そのモダリティに応じて名前が付けられた1つのベクトルフィールド(text_embedding、image_embedding、video_embedding、またはaudio_embedding)が含まれます。
使用されたモデル。
モデルから報告された場合の 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"}
]
}'サンプルのベクトルは読みやすさのために短縮されています。
レスポンス
{
"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 }
}エラー
| ステータス | コード | 原因 |
|---|---|---|
400 | invalid_request | input が指定されていない、空である、またはアイテムに text、image_url、image_base64 のいずれも含まれていません |
400 | unsupported_endpoint | モデルが multimodal-embedding をサポートしていません |
400 | image_input_deferred | アイテムに画像が含まれています |
その他のステータスについては、API エラーの処理 に従って処理してください。
認証
BearerAuth APIキー認証。Dashboard > API > API KeysでAPIキーを作成または管理します。
場所: header
ヘッダー
リクエストごとの配信ポリシー。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