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

Preferensi routing penyedia (order, only, ignore, allow_fallbacks, sort, …). Hanya diteruskan dan berlaku pada rute model tertentu; rute yang tidak mendukung akan mengabaikannya secara diam-diam dan tidak pernah mengirimkannya ke 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"
  }'

Contoh respons

Berhasil. Mengembalikan bentuk kompatibel OpenAI; data[] berkorespondensi berurutan dengan setiap input, dan usage.cost adalah jumlah yang benar-benar ditagihkan untuk permintaan ini.

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