Embeddings

Buat embeddings

Mengubah teks (atau, untuk model yang mendukung, konten multimodal) menjadi vector embeddings. Bentuk request/response sesuai dengan embeddings API OpenAI sehingga langsung berfungsi dengan client.embeddings.create(). input menerima satu string atau array string.

POST/v1/embeddings

Otorisasi

Authorizationwajib

string · header

API key sebagai bearer token di header Authorization.

Body

modelwajib

string

Model embeddings yang digunakan, dengan prefiks penyedia, mis. "openai/text-embedding-3-small".

minLength: 1

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

inputwajib

string | string[]

Teks yang akan di-embed. Menerima satu string, atau array string untuk meng-embed banyak input dalam satu permintaan. Beberapa model juga menerima item konten multimodal terstruktur, diteruskan apa adanya ke upstream; dukungan sebenarnya tergantung model.

Example: "The quick brown fox"

encoding_format

string

Format encoding, diteruskan apa adanya ke upstream tanpa validasi lokal; nilai yang didukung tergantung upstream.

Example: "float"

dimensions

integer

Jumlah dimensi vektor output, diteruskan apa adanya ke upstream tanpa validasi lokal; hanya sebagian model mendukung dimensi kustom, dan upstream menentukan perilaku (biasanya diabaikan atau error) saat tidak didukung.

provider

object

Tidak didukung. Seluruh objek diabaikan dan dihapus sebelum diteruskan; field ini tidak dapat memilih upstream atau tingkat harga.

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

Contoh respons

Berhasil. Mengembalikan bentuk kompatibel OpenAI; data[] sesuai dengan setiap input menurut urutannya. usage.cost adalah jumlah USD yang ditagihkan kepada pelanggan untuk permintaan ini. ID permintaan BazaarLink yang buram di respons sama dengan x-request-id; gunakan ID itu pada GET /v1/generation. Statistik dapat muncul beberapa detik setelah selesai; coba lagi sebentar jika mendapat 404. Respons non-streaming juga mengembalikan ID yang sama di 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
  }
}