Embeddings

Tạo embeddings

Chuyển văn bản (hoặc nội dung đa phương thức với model hỗ trợ) thành vector embeddings. Định dạng request/response khớp với embeddings API của OpenAI nên dùng trực tiếp được với client.embeddings.create(). input nhận một chuỗi đơn hoặc mảng chuỗi.

POST/v1/embeddings

Xác thực

Authorizationbắt buộc

string · header

API key dưới dạng bearer token trong header Authorization.

Body

modelbắt buộc

string

Model embeddings cần dùng, có tiền tố nhà cung cấp, ví dụ "openai/text-embedding-3-small".

minLength: 1

Example: "openai/text-embedding-3-small"

inputbắt buộc

string | string[]

Văn bản cần embed. Nhận một chuỗi đơn, hoặc mảng chuỗi để embed nhiều input trong một request. Một số model còn nhận các phần tử nội dung đa phương thức có cấu trúc, chuyển tiếp nguyên trạng đến upstream; mức hỗ trợ thực tế tùy model.

Example: "The quick brown fox"

encoding_format

string

Định dạng mã hóa, chuyển tiếp nguyên trạng đến upstream, không kiểm tra ở phía chúng tôi; giá trị được hỗ trợ tùy upstream.

Example: "float"

dimensions

integer

Số chiều của vector đầu ra, chuyển tiếp nguyên trạng đến upstream, không kiểm tra ở phía chúng tôi; chỉ một số model hỗ trợ tùy chỉnh số chiều, khi không hỗ trợ hành vi do upstream quyết định (thường là bỏ qua hoặc báo lỗi).

provider

object

Không được hỗ trợ. Toàn bộ đối tượng bị bỏ qua và xóa trước khi chuyển tiếp; trường này không thể chọn upstream hoặc bậc giá.

POST /v1/embeddings

1
2
3
4
5
6
7
curl https://api.bazaarlink.ai/v1/embeddings \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/text-embedding-3-small",
    "input": "The quick brown fox"
  }'

Ví dụ phản hồi

Thành công. Trả về định dạng tương thích OpenAI; data[] tương ứng với từng input theo đúng thứ tự. usage.cost là số USD tính cho khách hàng cho yêu cầu này. BazaarLink request ID opaque trong phản hồi trùng với x-request-id; dùng ID đó với GET /v1/generation. Số liệu có thể xuất hiện sau vài giây; thử lại 404 trong thời gian ngắn. Phản hồi không stream cũng trả cùng ID trong x-generation-id.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
{
  "id": "85e6f35c71a31f19-SJC",
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [
        0.0023064255,
        -0.009327292,
        0.015797347
      ]
    }
  ],
  "model": "openai/text-embedding-3-small",
  "usage": {
    "prompt_tokens": 5,
    "total_tokens": 5,
    "cost": 1e-7
  }
}