Văn bản
Tạo Multimodal Embeddings
Tạo các vector embedding với mô hình multimodal embedding
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)
ID của mô hình có liệt kê multimodal-embedding, chẳng hạn như qwen3-vl-embedding.
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ợ.
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
Luôn là list.
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):embeddingindex(integer): Chỉ mục của phần tử đầu vàotext_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ặcaudio_embedding.
Mô hình được sử dụng.
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
{
"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ái | Mã lỗi | Nguyên nhân |
|---|---|---|
400 | invalid_request | input 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 |
400 | unsupported_endpoint | Mô hình không liệt kê multimodal-embedding |
400 | image_input_deferred | Mộ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 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
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