TokenLab
Lấy khóa API
Tài liệuTham chiếu APITích hợp

Văn bản

Tạo Embedding

Tạo một vector embedding đại diện cho văn bản đầu vào

POST
/v1/embeddings

Nội dung Request

Với đầu vào lớn, đặt thời gian chờ của máy khách HTTP ít nhất 120s. Phản hồi trả về sau khi xử lý hoàn tất.

modelstringbắt buộc

ID của model embedding sẽ sử dụng (ví dụ: text-embedding-3-small).

inputstring | arraybắt buộc

Văn bản dưới dạng chuỗi hoặc mảng chuỗi. Mô hình hỗ trợ đầu vào token còn nhận number[] cho một chuỗi token hoặc number[][] cho nhiều chuỗi.

encoding_formatstringmặc định: float

Định dạng cho embeddings: float hoặc base64.

dimensionsinteger

Số chiều cho đầu ra (phụ thuộc vào model).

userstring

Một mã định danh duy nhất đại diện cho end-user của bạn để giám sát lạm dụng.

Các Model Khả Dụng

Dùng GET /v1/models?recommended_for=embedding để xem mô hình và số chiều hiện tại.

Phản hồi

objectstring

Luôn là list.

dataarray

Mảng các đối tượng embedding.

Mỗi đối tượng bao gồm:

  • object (string): embedding
  • index (integer): Chỉ mục trong mảng đầu vào
  • embedding (array | string): Vector số với float, hoặc chuỗi Base64 với base64.
modelstring

Model được sử dụng.

usageobject

Mức sử dụng token với prompt_tokens và total_tokens.

Yêu cầu

curl -X POST "https://api.tokenlab.sh/v1/embeddings" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text-embedding-3-small",
    "input": "The quick brown fox jumps over the lazy dog"
  }'

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

Phản hồi

Response
{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [0.0023, -0.0194, 0.0081]
    }
  ],
  "model": "text-embedding-3-small",
  "usage": {
    "prompt_tokens": 9,
    "total_tokens": 9
  }
}

Embeddings theo lô

# Embed multiple texts at once
response = client.embeddings.create(
    model="text-embedding-3-small",
    input=[
        "First document text",
        "Second document text",
        "Third document text"
    ]
)

for i, data in enumerate(response.data):
    print(f"Document {i}: {len(data.embedding)} dimensions")

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

Tạo Tin nhắn

Trước

Xếp hạng lại tài liệu

Tiếp