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/api/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

Tùy chọn định tuyến nhà cung cấp (order, only, ignore, allow_fallbacks, sort, …). Chỉ được chuyển tiếp và áp dụng trên một số tuyến model nhất định; các tuyến không hỗ trợ sẽ âm thầm bỏ qua, không gửi lên upstream.

POST /api/v1/embeddings

1
2
3
4
5
6
7
curl https://bazaarlink.ai/api/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 theo thứ tự với từng input, và usage.cost là số tiền thực tế bị tính phí cho request này.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
{
  "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
  }
}