TokenLab

Văn bản

Tạo Multimodal Embeddings

Tạo các vector embedding với mô hình multimodal embedding

POST
/v1/multimodal/embeddings

Tổng quan

Sử dụng endpoint này với các mô hình có thông tin chi tiết liệt kê thao tác multimodal-embedding. Hãy đọc supported_operations trong GET /v1/models/{model} trước khi gửi yêu cầu. Các mô hình embedding chỉ xử lý văn bản sử dụng Tạo Embedding, và endpoint này sẽ trả về lỗi 400 unsupported_endpoint đối với các mô hình đó.

Hiện chỉ hỗ trợ đầu vào dạng văn bản. Yêu cầu chứa image_url hoặc image_base64 sẽ trả về 400 image_input_deferred.

Phần thân yêu cầu (Request Body)

modelstringbắt buộc

ID của mô hình có liệt kê multimodal-embedding, chẳng hạn như qwen3-vl-embedding.

inputobject | arraybắt buộc

Một mục đầu vào, hoặc một mảng các mục. Mỗi mục cần có ít nhất một trong các trường bên dưới, và phản hồi sẽ có một mục tương ứng cho mỗi phần tử đầu vào.

  • text (string): Văn bản cần tạo embedding.
  • image_url (string): URL hình ảnh công khai. Hiện chưa hỗ trợ.
  • image_base64 (string) và image_mime_type (string): Dữ liệu hình ảnh Base64 và MIME type tương ứng. Hiện chưa hỗ trợ.
dimensionsinteger

Số chiều của mỗi vector trả về, là một số nguyên dương. Giá trị tối đa phụ thuộc vào mô hình.

Phản hồi

objectstring

Luôn là list.

dataarray

Một mục tương ứng cho mỗi phần tử đầu vào.

Mỗi mục bao gồm:

  • object (string): embedding
  • index (integer): Chỉ mục của phần tử đầu vào
  • text_embedding (array): Vector của một mục văn bản. Mỗi mục chứa một trường vector được đặt tên theo phương thức (modality) tương ứng: text_embedding, image_embedding, video_embedding, hoặc audio_embedding.
modelstring

Mô hình được sử dụng.

usageobject

Mức sử dụng token bao gồm prompt_tokens và total_tokens, khi mô hình có báo cáo thông tin này.

Yêu cầu

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"}
    ]
  }'

Vector ví dụ đã được rút gọn để dễ đọc.

Phản hồi

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 }
}

Lỗi

Trạng tháiMã lỗiNguyên nhân
400invalid_requestinput bị thiếu, trống hoặc một mục không có trường nào trong số text, image_url, image_base64
400unsupported_endpointMô hình không liệt kê multimodal-embedding
400image_input_deferredMột mục có chứa hình ảnh

Xử lý các trạng thái khác như hướng dẫn trong Xử lý lỗi API.

Xác thực

BearerAuth
AuthorizationBearer <token>

Xác thực bằng Khóa API. Tạo hoặc quản lý khóa API trong Dashboard > API > API Keys.

Vị trí: header

Header

X-TokenLab-Delivery-Policy?string

Chính sách phân phối theo yêu cầu. Ghi đè các mặc định của API key và Workspace. Tự động thử TokenLab Verified trước và có thể chuyển đổi một lần sang Official chỉ trước khi xuất, chấp nhận yêu cầu hoặc tạo tài nguyên cố định.

Giá trị hợp lệ

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

Nội dung yêu cầu

application/json

Phản hồi

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json