> ## Documentation Index
> Fetch the complete documentation index at: https://docs.conare.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# واجهة التضمينات

> نقطة POST /api/v1/embeddings عديمة الحالة تُعيد متجهات وثائق مُوحَّدة الطول من النموذج نفسه الذي يسترجع به Conare، مع تثبيت إصدار النموذج المُختار.

```bash theme={null}
curl https://api.conare.ai/api/v1/embeddings \
  -H "Authorization: Bearer $CONARE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": [
      "User prefers smaller islands, wants to avoid crowds.",
      "ASA 104 certified, comfortable with bareboat charters."
    ]
  }'
```

```json theme={null}
{
  "success": true,
  "model": "...",
  "dims": 1024,
  "embeddings": [[0.0132, -0.0087, "..."], ["..."]],
  "usage": { "totalChars": 98, "approxTokens": 25 }
}
```

## الدلالات

* **عديمة الحالة.** لا يُخزَّن شيء، وهذا هو المسار الوحيد بدون `endUserId` — لا يوجد مستخدم نهائي مُشترك.
* **الحدود.** حتى 96 مُدخلاً لكل استدعاء، كل واحد بحد أقصى 8,192 حرفاً.
* **ترتيب حتمي.** المتجهات موحّدة الطول وتُعاد بترتيب الإدخال.
* **المصادقة.** مفتاح تكامل `cint_` بصلاحية `memory:read`.

## تثبيت النموذج

`model` هو **تثبيت، لا مُحدِّد**. تُقدّم نقطة النهاية نموذجاً واحداً بالضبط، يُبلَّغ عنه في كل استجابة. تثبيت أي اسم آخر يُعيد `400 model_not_served` — لا تُستبدل متجهات من نموذج مختلف بصمت أبداً. ثبّت النموذج كلما وجب أن تبقى متجهاتك متوافقة مع فهرس موجود؛ استدعاء غير مُثبَّت يحصل دائماً على النموذج المُقدَّم حالياً.

```json theme={null}
{ "input": ["..."], "model": "the-model-name-from-a-previous-response" }
```

## القياس

يُقاس الاستخدام برموز التضمين (\~4 أحرف لكل رمز) ويظهر في [عرض استخدام المنصة](https://conare.ai/dashboard).

مخطط الطلب/الاستجابة الكامل: [مرجع API](/api-reference).