إنشاء مفتاح API والمصادقة في كل صيغة

كل طلب إلى خبير يحمل مفتاح API في ترويسة. المفتاح يربط الطلب بحسابك ورصيدك، ويحدد النماذج التي يمكنه استدعاؤها.

مفتاح لكل مزوّد#

يعمل كل مفتاح مع نماذج مزوّد واحد: مفتاح لنماذج Claude، وآخر لنماذج GPT، وهكذا. إذا أرسلت بالمفتاح طلبًا لنموذج من مزوّد آخر، يصلك الخطأ MODEL_PLATFORM_NOT_ALLOWED. أنشئ مفتاحًا لكل مزوّد تحتاجه، فكلها تُخصم من الرصيد نفسه.

أنشئ مفتاحًا#

1. 1

   افتح صفحة المفاتيح#

   من لوحة التحكم افتح الـ API ← المفاتيح.

2. 2

   اختر المزوّد والاسم#

   اضغط مفتاح جديد، واختر المزوّد الذي تريد نماذجه، وأعطِ المفتاح اسمًا يدل على المشروع الذي سيستخدمه.

3. 3

   انسخ المفتاح#

   انسخ المفتاح واحفظه في متغير بيئة أو في مدير كلمات المرور، لا في ملف داخل المشروع.

أين تضع المفتاح في الطلب#

لكل صيغة ترويستها المعتادة، والمكتبات الرسمية تضعها تلقائيًا:

• صيغة OpenAI، أي Chat Completions وResponses: الترويسة Authorization، وقيمتها الكلمة Bearer ثم المفتاح.
• صيغة Anthropic Messages: الترويسة x-api-key، وقيمتها المفتاح، مع الترويسة anthropic-version.
• صيغة Gemini: الترويسة x-goog-api-key، وقيمتها المفتاح.

العنوان الأساسي لكل صيغة في العناوين الأساسية.

احفظ المفتاح في متغير بيئة#

كل الأمثلة في هذه الوثائق تقرأ المفتاح من متغير البيئة KHABEER_API_KEY:

export KHABEER_API_KEY="YOUR_5ABEER_API_KEY"

تحقق من المفتاح#

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

curl https://api.5abeer.ai/v1/models \
  -H "Authorization: Bearer $KHABEER_API_KEY"

تحكّم في كل مفتاح#

تحكّم في كل مفتاح: حد للإنفاق، وتاريخ انتهاء، وقائمة عناوين IP المسموح بها. تضبطها عند إنشاء المفتاح أو من إعداداته لاحقًا.

• عندما يبلغ المفتاح حد الإنفاق يصلك API_KEY_QUOTA_EXHAUSTED، فارفع الحد من إعدادات المفتاح.
• بعد تاريخ الانتهاء يصلك API_KEY_EXPIRED، فأنشئ مفتاحًا جديدًا.
• المفتاح الموقوف يعيد API_KEY_DISABLED.

احمِ مفتاحك#

• لا تضع المفتاح في كود يعمل داخل المتصفح أو داخل تطبيق للهاتف، فأي زائر يستطيع قراءته. أرسل الطلبات من الخادم.
• لا ترفع المفتاح إلى مستودع الكود. احفظه في ملف .env وأضف الملف إلى .gitignore.
• استخدم مفتاحًا لكل مشروع، لتوقف مفتاحًا واحدًا دون أن تتأثر بقية مشاريعك.
• إذا ظننت أن المفتاح انكشف، أوقفه من لوحة التحكم فورًا وأنشئ مفتاحًا جديدًا.