สร้าง embeddings

แปลงข้อความ (หรือเนื้อหามัลติโมดัลสำหรับโมเดลที่รองรับ) ให้เป็นเวกเตอร์ embeddings รูปแบบคำขอ/การตอบกลับตรงกับ embeddings API ของ OpenAI จึงใช้กับ client.embeddings.create() ได้โดยตรง input รับได้ทั้งสตริงเดี่ยวหรืออาร์เรย์ของสตริง

POST/api/v1/embeddings

การอนุญาต

Authorizationจำเป็น

string · header

API key เป็น bearer token ใน header Authorization

Body

modelจำเป็น

string

โมเดล embeddings ที่จะใช้ ในรูปแบบมีคำนำหน้าผู้ให้บริการ เช่น "openai/text-embedding-3-small"

minLength: 1

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

inputจำเป็น

string | string[]

ข้อความที่จะแปลงเป็น embedding รับได้ทั้งสตริงเดี่ยว หรืออาร์เรย์ของสตริงเพื่อแปลงหลายรายการในคำขอเดียว บางโมเดลยังรับรายการเนื้อหามัลติโมดัลแบบมีโครงสร้าง ซึ่งจะส่งต่อไปยังต้นทางตามเดิม การรองรับจริงขึ้นอยู่กับโมเดล

Example: "The quick brown fox"

encoding_format

string

รูปแบบการเข้ารหัส ส่งต่อไปยังต้นทางตามเดิมโดยไม่มีการตรวจสอบฝั่งเรา ค่าที่รองรับขึ้นอยู่กับต้นทาง

Example: "float"

dimensions

integer

จำนวนมิติของเวกเตอร์เอาต์พุต ส่งต่อไปยังต้นทางตามเดิมโดยไม่มีการตรวจสอบฝั่งเรา มีเพียงบางโมเดลที่รองรับการกำหนดมิติเอง หากไม่รองรับพฤติกรรม (มักละเว้นหรือแจ้งข้อผิดพลาด) จะขึ้นอยู่กับต้นทาง

provider

object

การตั้งค่าเส้นทางผู้ให้บริการ (order, only, ignore, allow_fallbacks, sort, …) จะถูกส่งต่อและมีผลเฉพาะบางเส้นทางโมเดลเท่านั้น เส้นทางที่ไม่รองรับจะละเว้นฟิลด์นี้โดยไม่แจ้งเตือนและไม่ส่งไปยังต้นทาง

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

ตัวอย่างการตอบกลับ

สำเร็จ คืนค่ารูปแบบที่เข้ากันได้กับ OpenAI; data[] จะสอดคล้องตามลำดับกับแต่ละ input และ usage.cost คือจำนวนเงินที่เรียกเก็บจริงสำหรับคำขอนี้

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