TokenLab
الحصول على مفتاح API
التوثيقمرجع APIالتكاملات

النص

إنشاء Embedding

ينشئ متجه embedding يمثّل النص المُدخل

POST
/v1/embeddings

جسم الطلب

للمدخلات الكبيرة، اضبط مهلة عميل HTTP على 120s على الأقل. تعاد الاستجابة بعد انتهاء المعالجة.

modelstringمطلوب

معرّف نموذج الـ embedding المراد استخدامه (على سبيل المثال: text-embedding-3-small).

inputstring | arrayمطلوب

نص كسلسلة أو مصفوفة سلاسل. تقبل النماذج التي تدعم إدخال الرموز أيضًا number[] لتسلسل واحد أو number[][] لعدة تسلسلات.

encoding_formatstringالافتراضي: float

التنسيق الخاص بالـ embeddings: float أو base64.

dimensionsinteger

عدد الأبعاد في المخرجات (يعتمد على النموذج).

userstring

معرّف فريد يمثّل المستخدم النهائي الخاص بك لمراقبة إساءة الاستخدام.

النماذج المتاحة

استخدم GET /v1/models?recommended_for=embedding لمعرفة النماذج والأبعاد الحالية.

الاستجابة

objectstring

دائمًا list.

dataarray

مصفوفة من كائنات embedding.

يحتوي كل كائن على:

  • object (string): embedding
  • index (integer): الفهرس في مصفوفة الإدخال
  • embedding (array | string): متجه عددي عند استخدام float، أو سلسلة Base64 عند استخدام base64.
modelstring

النموذج المستخدم.

usageobject

استخدام الـ token مع prompt_tokens و total_tokens.

الطلب

curl -X POST "https://api.tokenlab.sh/v1/embeddings" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text-embedding-3-small",
    "input": "The quick brown fox jumps over the lazy dog"
  }'

تم اختصار متجه المثال لتسهيل القراءة.

الاستجابة

Response
{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [0.0023, -0.0194, 0.0081]
    }
  ],
  "model": "text-embedding-3-small",
  "usage": {
    "prompt_tokens": 9,
    "total_tokens": 9
  }
}

Embeddings الدفعية

# Embed multiple texts at once
response = client.embeddings.create(
    model="text-embedding-3-small",
    input=[
        "First document text",
        "Second document text",
        "Third document text"
    ]
)

for i, data in enumerate(response.data):
    print(f"Document {i}: {len(data.embedding)} dimensions")

التفويض

BearerAuth
AuthorizationBearer <token>

مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.

الموضع: header

الترويسات

X-TokenLab-Delivery-Policy?string

سياسة التسليم لكل طلب. تتجاوز إعدادات API key و Workspace الافتراضية. يحاول النظام تلقائياً استخدام TokenLab Verified أولاً، وقد ينتقل مرة واحدة إلى Official فقط قبل المخرجات، أو قبول الطلب، أو إنشاء مورد دائم.

القيم المتاحة

  • "auto"
  • "verified"
  • "official"

جسم الطلب

application/json

الاستجابة

application/json

application/json

application/json

application/json

application/json

application/json

application/json

إنشاء رسالة

السابق

إعادة ترتيب المستندات (Rerank Documents)

التالي