---
title: "ما هو مفتاح API لنماذج اللغة؟ استخدامه وحمايته | BroadRouter"
description: "مفتاح API يعرّف استدعاءاتك لواجهة LLM API ويخوّلها، ومن يملكه يستطيع إنفاق رصيدك. كيف تعمل مفاتيح Bearer، وكيف تخزّنها وتقيّدها وتلغيها."
url: https://broadrouter.com/ar/glossary/api-key/
lang: ar
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. [اقرأ الأصل الإنجليزي](https://broadrouter.com/glossary/api-key/) (حُدّث في 2026-11-14).

# مفتاح API (API key)

آخر تحديث 2026-11-14

مفتاح API هو سلسلة نصية سرية تعرّف العميل الذي يستدعي الواجهة وتخوّله. تتوقعه واجهات LLM API عادةً في الترويسة Authorization: Bearer، وكل من يملك المفتاح يستطيع إرسال طلبات تُحتسب تكلفتها على الحساب المالك له.

يُسمّى أيضًا: مفتاح API، مفتاح الواجهة البرمجية، المفتاح السري، رمز الوصول، مفتاح الاستدلال، API key، API token، secret key، bearer token، inference key

يعمل مفتاح API مثل كلمة مرور لبرنامج. وهو أيضًا صلاحية إنفاق: من يملكه يستطيع استخدام رصيدك.

## كيف يعمل

تتعامل واجهات LLM API مع المفتاح بوصفه رمز Bearer. يرسله العميل مع كل طلب:

```bash
curl https://inference.broadnet.ai/v1/models \
  -H "Authorization: Bearer $BROADNET_API_KEY"
```

يعرّف RFC 6750 رمز Bearer بأنه رمز يستطيع “any party in possession of the token” (ترجمة: أي طرف يحوز الرمز) استخدامه. لا يوجد عامل تحقق ثانٍ. ولهذا يقول الـ RFC نفسه إن على العملاء إرسال رموز Bearer دائمًا عبر TLS (`https://`).

يبحث المزوّد عن المفتاح، ويحدّد الحساب، ويتحقق من الحدود والسياسات، ثم يخدم الطلب أو يرفضه. والمفتاح المفقود أو الخاطئ يُرجع غالبًا 401؛ أما المفتاح الذي ترفضه سياسة ما، مثل [قائمة عناوين IP المسموح بها](https://broadrouter.com/ar/glossary/ip-allow-list/)، فيُرجع غالبًا 403.

## لماذا يهم

المفتاح المسرَّب من أكثر الطرق شيوعًا لخروج فاتورة API عن السيطرة، لأن الروبوتات تمسح الشيفرة العامة بحثًا عن الأسرار. وقد يكشف أيضًا بيانات إذا وصل المفتاح إلى نقاط نهاية تُرجع تفاصيل الحساب. الممارسات الجيدة، بما يتوافق مع إرشادات OWASP للأسرار:

-   حمّل المفاتيح من متغيرات البيئة أو من مدير أسرار. لا تضعها أبدًا في commit ولا تدمجها في صور الحاويات.
-   امنح كل تطبيق أو وكيل مفتاحه الخاص، لتتمكن من إلغاء أحدها دون إيقاف كل شيء.
-   بدّل المفاتيح وفق جدول زمني، وفورًا بعد أي تسرّب مشتبه به.
-   قيّد الأماكن التي يعمل منها المفتاح، مثلًا بقائمة مسموح بها لعناوين IP الخوادم.

## في BroadNet Inference

تفصل BroadNet بين نوعين من بيانات الاعتماد. **مفتاح الاستدلال** يستدعي النماذج على `/v1/*`. و**بيانات اعتماد البوابة** (portal credential) تؤتمت إدارة الحساب: المفاتيح وعناوين IP المسموح بها والمشتريات. تعامل مع الثانية على أنها صلاحية كاملة على الحساب.

يُعرض كلاهما مرة واحدة فقط. لا تحتفظ BroadNet إلا ببصمة SHA-256، لذا لا تستطيع عرض المفتاح مرة أخرى. يصلح مفتاح الدفع حسب الاستخدام سنة واحدة، ويمكن أن يضم الحساب حتى عشرة مفاتيح نشطة. ويمكن أن يحمل كل مفتاح قائمته الخاصة من عناوين IP المسموح بها. وبعد الإلغاء أو تغيير القائمة، تتوقف الطلبات الجديدة خلال خمس ثوانٍ.

مفاتيح [الخطط ثابتة السعر](https://broadrouter.com/ar/glossary/flat-rate-llm-plan/) منفصلة ولا تُخصم أبدًا من رصيدك. وتجد خطوات الإعداد في [مفاتيح API وقوائم عناوين IP المسموح بها](https://broadrouter.com/ar/guides/api-keys-ip-allow-lists/)، ورموز الحالة في [الأخطاء وإعادة المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/).

## أخطاء شائعة

-   تسجيل ترويسات الطلب كاملة. هذا يكتب المفتاح في سجلاتك.
-   مشاركة مفتاح واحد بين أفراد الفريق. تفقد بذلك القدرة على إلغاء وصول شخص بعينه.
-   إرسال المفتاح إلى الدعم. أرسل قيمة الترويسة `X-Request-ID` بدلًا منه.

## أسئلة شائعة

### هل يمكنني وضع مفتاح LLM API في تطبيق متصفح أو تطبيق جوال؟

لا. كل ما يُشحن إلى جهاز العميل يمكن استخراجه. احتفظ بالمفتاح على خادم، واجعل تطبيقك يستدعي خادمك، وخادمك يستدعي LLM API.

### ماذا أفعل إذا تسرّب مفتاح؟

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

### كم مفتاحًا يمكنني امتلاكه في BroadNet Inference؟

حتى عشرة مفاتيح نشطة للدفع حسب الاستخدام لكل حساب. يصلح كل مفتاح سنة واحدة من تاريخ إنشائه. أما مفاتيح الخطط فمنفصلة.

## انظر أيضًا

-   [قائمة عناوين IP المسموحة (IP allow list)](https://broadrouter.com/ar/glossary/ip-allow-list/) (مصطلح)
-   [العنوان الأساسي (Base URL)](https://broadrouter.com/ar/glossary/base-url/) (مصطلح)
-   [واجهة API متوافقة مع OpenAI (OpenAI-compatible API)](https://broadrouter.com/ar/glossary/openai-compatible-api/) (مصطلح)
-   [حد المعدل (Rate limit)](https://broadrouter.com/ar/glossary/rate-limit/) (مصطلح)
-   [اربط مفاتيح API بخوادمك عبر قوائم عناوين IP المسموح بها](https://broadrouter.com/ar/guides/api-keys-ip-allow-lists/) (دليل)
-   [استخدام OpenAI Python SDK مع BroadNet Inference](https://broadrouter.com/ar/guides/openai-python-sdk/) (دليل)
-   [رموز أخطاء BroadNet Inference ومتى تعيد المحاولة](https://broadrouter.com/ar/guides/errors-and-retries/) (دليل)
-   [عدم الاحتفاظ بالبيانات في LLM API: قائمة تحقق من 10 أسئلة](https://broadrouter.com/ar/blog/zero-data-retention-llm-api-checklist/) (مقال)

جرّبه على مهامك الفعلية. تبدأ الحسابات الجديدة برصيد قدره $5 لاستخدام Gemma والتفريغ الصوتي. أما DeepSeek وGLM وQwen3.8 فتتطلب شحن الرصيد.

[ابدأ الآن](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-glossary-api-key&utm_content=page-cta) ·

**المصادر**

-   [RFC 6750: إطار تفويض OAuth 2.0، استخدام رموز Bearer](https://www.rfc-editor.org/rfc/rfc6750)
-   [دليل OWASP المختصر لإدارة الأسرار](https://cheatsheetseries.owasp.org/cheatsheets/Secrets_Management_Cheat_Sheet.html)
-   [المرجع التقني لـ BroadNet Inference API، المفاتيح وقوائم عناوين IP المسموح بها (بالإنجليزية)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ar-glossary-api-key&utm_content=sources)
