الانتقال إلى المحتوى الرئيسي
استخدم CometAPI embeddings عندما يحتاج تطبيقك إلى متجهات للبحث الدلالي، أو التجميع، أو التوصيات، أو الاسترجاع. أرسل النص إلى /v1/embeddings، ثم خزّن المتجه المُعاد، وابحث فيه باستخدام قاعدة بيانات المتجهات لديك.

​
إنشاء embedding

استخدم model ID يدعم embedding من صفحة النماذج أو دليل النماذج. تستدعي الأمثلة أدناه واجهة برمجة تطبيقات Embeddings المتوافقة مع OpenAI.
تستخدم هذه الأمثلة العنصر النائب your-embedding-model-id. استبدله بـ model ID متاح لـ embedding من صفحة النماذج أو دليل النماذج قبل تشغيل الطلب.
افتح Create embeddings لاستخدام ساحة التجربة ومخطط نقطة النهاية.
import os
import requests

response = requests.post(
    "https://api.cometapi.com/v1/embeddings",
    headers={
        "Authorization": "Bearer " + os.environ["COMETAPI_KEY"],
        "Content-Type": "application/json",
    },
    json={
        "model": "your-embedding-model-id",
        "input": "CometAPI lets developers use many model providers.",
    },
    timeout=30,
)

response.raise_for_status()
result = response.json()
print(len(result["data"][0]["embedding"]))

​
مثال على الاستجابة

قد تبدو الاستجابة الناجحة بهذا الشكل. تتضمن الاستجابة متجهًا واحدًا لكل عنصر إدخال؛ وقد تم اختصار المتجه أدناه لتسهيل القراءة: 
{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [
        -0.0021,
        -0.0491,
        0.0209
      ]
    }
  ],
  "model": "your-embedding-model-id",
  "usage": {
    "prompt_tokens": 10,
    "total_tokens": 10
  }
}

​
إدخال دفعي

أرسل مصفوفة من السلاسل النصية عندما تريد عدة متجهات من طلب واحد:
cURL
curl https://api.cometapi.com/v1/embeddings \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-embedding-model-id",
    "input": [
      "Create an API key",
      "Change the base URL",
      "Retry after a rate limit"
    ]
  }'

​
سجلات النماذج المثال

يوضح هذا المثال لاستجابة فهرس النماذج غلاف /api/models وشكل سجل واحد لنموذج Embeddings متوافق مع OpenAI. تستخدم بعض سجلات Embeddings قيمة model_type فارغة؛ اختر نموذج Embeddings باستخدام المعرّف ودعم endpoint بدلًا من الاعتماد على هذا الحقل وحده.
cURL
curl https://api.cometapi.com/api/models

{
  "success": true,
  "page": 1,
  "page_size": 20,
  "total": 302,
  "data": [
    {
      "created": 1757904564,
      "id": "your-embedding-model-id",
      "code": "your-embedding-model-id",
      "provider": "ExampleProvider",
      "provider_code": "example",
      "name": "Example embedding model",
      "model_type": "embedding",
      "features": [
        "text-embedding"
      ],
      "endpoints": [
        "openai"
      ],
      "pricing": {
        "currency": "USD / M Tokens",
        "input": 0.1,
        "output": null,
        "per_request": null,
        "per_second": null
      }
    }
  ]
}

​
الأخطاء الشائعة

قسّم المستندات الطويلة إلى أجزاء قبل إنشاء Embeddings.
اختر نموذجًا قادرًا على Embeddings من دليل النماذج.
حافظ على استخدام النموذج نفسه والأبعاد نفسها لفهرس متجهات واحد.
أرسل Authorization: Bearer $COMETAPI_KEY.

​
رموز الأخطاء واستراتيجية إعادة المحاولة

لا تعِد المحاولة حتى يتم إصلاح إعدادات الإدخال أو model ID أو الأبعاد.
لا تعِد المحاولة حتى يكون مفتاح API موجودًا وصالحًا.
تحقّق من base URL والمسار وmodel ID قبل إعادة المحاولة.
أعد المحاولة باستخدام exponential backoff وقلّل حجم الدفعة أو التوازي.
أعد المحاولة مع backoff لأخطاء المزوّد أو الخدمة العابرة.
للاطلاع على أنماط التنفيذ، راجع رموز الأخطاء واستراتيجية إعادة المحاولة وحدود المعدل والتوازي.

​
التسعير ودليل النماذج

Models page

اقرأ كيف يوفّر CometAPI معرّفات النماذج في الوثائق.

Model directory

تصفّح مدى توفّر النماذج وإمكاناتها.

Pricing

تحقّق من التسعير قبل استدعاء أي نموذج.
آخر تعديل في ٢٣ يونيو ٢٠٢٦