Source: https://ailoot.ai/docs/ar/keys/
Canonical: https://ailoot.ai/docs/ar/keys/
Language: ar

[البداية](https://ailoot.ai/docs/ar/) 

# المفاتيح وعنوان API

[Markdown](https://ailoot.ai/docs/ar/keys/index.md)

من أين تحصل على المفتاح، والعنوان المستخدم في حزم SDK المختلفة، وكيفية إرسال المفتاح.

## [](https://ailoot.ai/docs/ar/keys/#key)مفتاح API

يُنشأ المفتاح في لوحة الحساب على [ailoot.ai](https://ailoot.ai) بعد [إنشاء الحساب](https://ailoot.ai/register). ويكون بصيغة `sk-…`. يمكنك إنشاء عدة مفاتيح: للكمبيوتر المستخدم للعمل، وللخادم، ولكل تطبيق؛ يسهل ذلك إبطال مفتاح واحد دون التأثير في البقية.

يمكن تحديد حد إنفاق إجمالي وصلاحية وقوائم IP مسموحة ومحظورة، وحدود إنفاق لنوافذ 5 ساعات ويوم واحد و7 أيام. عند تفعيل قيد، يأتي خطأ مفهوم: `api_key_quota_exhausted` (استُنفد الحد الإجمالي)، `usage_limit_reached` (استُنفدت نافذة إنفاق المفتاح؛ انتظر تحديثها أوارفع الحد)، `api_key_expired` أو `permission_denied` (مثلاً، أُرسل الطلب من IP غير مسموح به).

لا تنشر المفتاح في الكود أوالمستودعات أولقطات الشاشة. احفظه في متغير بيئة أو مدير أسرار. إذا تسرّب، فاحذفه في لوحة الحساب وأنشئ مفتاحاً جديداً.

## [](https://ailoot.ai/docs/ar/keys/#base-url)عنوان API

القاعدة الأساسية: عنوان العملاء المتوافقين مع OpenAI يتضمن `/v1`، وعنوان Anthropic وGemini لا يتضمنها.

| العميل | العنوان الأساسي | وجهة الطلب |
| --- | --- | --- |
| OpenAI SDK والعملاء المتوافقون | `https://api.ailoot.ai/v1` | `/v1/chat/completions`, `/v1/responses`, `/v1/embeddings` |
| Anthropic SDK, Claude Code | `https://api.ailoot.ai` | `/v1/messages` |
| Google GenAI SDK, Gemini CLI | `https://api.ailoot.ai` | `/v1beta/models/{model}:generateContent` |
| العميل يطلب العنوان الكامل | `https://api.ailoot.ai/v1/chat/completions` | كما هو محدد |

تلقيت 404 مباشرةً بعد الإعداد؟ غالباً السبب العنوان: وجود لاحقة زائدة أو مفقودة من `/v1`، أوشرطة مائلة مزدوجة، أو `/chat/completions` حيث يضيفها العميل بنفسه.

## [](https://ailoot.ai/docs/ar/keys/#auth)كيفية إرسال المفتاح

يقبل Ailoot المفتاح في أي من الترويسات الثلاث؛ وتناسبه الترويسة التي ترسلها SDK:

| الترويسة | من يرسل بهذه الطريقة |
| --- | --- |
| `Authorization: Bearer sk-…` | OpenAI SDK ومعظم العملاء |
| `x-api-key: sk-…` | Anthropic SDK وClaude Code مع ANTHROPIC\_API\_KEY |
| `x-goog-api-key: sk-…` | Google GenAI SDK, Gemini CLI |

على المسارات `/v1/…` لا يُقبل المفتاح في العنوان (`?key=` أو `?api_key=`)؛ يتلقى الطلب 400 بالرمز `invalid_request` ورسالة توضح إرسال المفتاح في العنوان. يمنع ذلك ظهوره في السجلات وسجل المتصفح. إذا استُخدم المفتاح في العنوان بالفعل، يُفضّل إنشاء مفتاح جديد.

على مسارات Gemini `/v1beta/…` يُقبل للتوافق مع Google `?key=` — بأدنى أولوية، بعد الترويسات. `?api_key=` يُرفض هناك أيضاً بالرمز 400. يظل إرسال المفتاح في الترويسة أكثر موثوقية `x-goog-api-key`.

## [](https://ailoot.ai/docs/ar/keys/#env)متغيرات البيئة

من الملائم إنشاء متغير واحد واستخدامه في إعدادات برامج مختلفة:

```bash
# ~/.zshrc أو ~/.bashrc
export AILOOT_API_KEY="sk-..."

# للبرامج التي تقرأ الأسماء القياسية
export OPENAI_BASE_URL="https://api.ailoot.ai/v1"
export OPENAI_API_KEY="$AILOOT_API_KEY"
export ANTHROPIC_BASE_URL="https://api.ailoot.ai"
export ANTHROPIC_AUTH_TOKEN="$AILOOT_API_KEY"
```

```powershell
setx AILOOT_API_KEY "sk-..."

# للبرامج التي تقرأ الأسماء القياسية
setx OPENAI_BASE_URL "https://api.ailoot.ai/v1"
setx OPENAI_API_KEY "sk-..."
setx ANTHROPIC_BASE_URL "https://api.ailoot.ai"
setx ANTHROPIC_AUTH_TOKEN "sk-..."
# أعد تشغيل الطرفية لتُحمَّل المتغيرات
```

## [](https://ailoot.ai/docs/ar/keys/#check)التحقق من المفتاح

أرخص طريقة للتحقق من المفتاح هي طلب قائمة النماذج؛ فهذا مجاني.

```bash
curl -s https://api.ailoot.ai/v1/models \
  -H "Authorization: Bearer $AILOOT_API_KEY"
```

هل لديك أسئلة أخرى؟ أرسل Request ID ووصفاً للمشكلة وسنساعدك على فهمها.[مراسلة الدعم](mailto:support@ailoot.ai)

## Ailoot · الشركة ومحفظة مشاريعها





تستند Ailoot إلى خبرة تشغيلية متراكمة وقاعدة عملاء واسعة وخدمة مستقرة ومراقبة مستمرة لمؤشرات الأداء KPI.





الشركة ومحفظة مشاريعها: ملايين العملاء؛ مبيعات بالمليارات شهريًا.





توظف Ailoot هذه الخبرة التشغيلية لإتاحة الوصول عبر API إلى قدرات الذكاء الاصطناعي في منتجات العملاء ووكلائهم وتطبيقاتهم وعمليات الأتمتة.