كيفية الحصول على مفتاح OpenRouter API واستخدام نماذجه المجانية
إنشاء مفتاح OpenRouter API، وحدود النماذج المجانية، وحل الأخطاء 401 و402 و429، واستخدام OpenRouter على iPhone وAndroid والويب.
- للحصول على مفتاح OpenRouter API: تسجيل الدخول في openrouter.ai، ثم فتح openrouter.ai/keys وإنشاء مفتاح يبدأ بـ «sk-or-v1-». إنشاء المفتاح مجاني، والنماذج التي ينتهي معرّفها بـ «:free» متاحة دون مقابل ضمن حدود يومية، وكل النماذج الأخرى تُدفع من رصيد (credits) مدفوع مسبقًا.
- OpenRouter حساب واحد ومفتاح واحد لنماذج من شركات ذكاء اصطناعي كثيرة. ولا ينشر OpenRouter تطبيق دردشة خاصًا به على iPhone أو Android، فاستخدامه على الهاتف يكون عبر تطبيق دردشة يقبل مفتاح OpenRouter، مثل Oriveo.
- حتى 18 نوفمبر 2026 تسمح النماذج المجانية بـ 20 طلبًا في الدقيقة و50 طلبًا في اليوم، أو 1,000 طلب في اليوم بعد شراء 10 وحدات رصيد (credits) على الأقل. والخطأ 402 يعني نفاد الرصيد.

ما هو OpenRouter، وما هو مفتاح API؟
OpenRouter خدمة تمنحك نماذج من شركات ذكاء اصطناعي كثيرة عبر حساب واحد. فبدل التسجيل لدى كل شركة على حدة، تضيف رصيدًا إلى OpenRouter مرة واحدة وتختار النماذج من قائمته.
مفتاح API هو الكود السري الذي يستخدمه التطبيق لإرسال الطلبات على حسابك. يتحقق OpenRouter من المفتاح، ويرسل رسالتك إلى النموذج الذي اخترته، ويخصم التكلفة من رصيدك فيه.
بُني OpenRouter للتطبيقات والمطورين، ولا ينشر تطبيق دردشة خاصًا به على iPhone أو Android؛ ولهذا يبحث كثيرون عن «تطبيق OpenRouter». والمطلوب في الواقع تطبيق دردشة يقبل مفتاح OpenRouter.
كيف أحصل على مفتاح OpenRouter API؟
يستغرق الأمر دقيقتين تقريبًا على موقع OpenRouter.
- زيارة openrouter.ai وإنشاء حساب، أو تسجيل الدخول.
- فتح صفحة المفاتيح على openrouter.ai/keys وإنشاء مفتاح جديد، مع تسميته باسم التطبيق أو الجهاز الذي سيُستخدم عليه.
- نسخ المفتاح. مفاتيح OpenRouter تبدأ بـ «sk-or-v1-» وطولها 73 حرفًا، فيجدر التأكد من نسخها كاملة.
- إضافة رصيد من صفحة Credits عند الحاجة إلى نماذج غير مجانية.
- حفظ المفتاح في مكان آمن، مثل مدير كلمات المرور. وإن تسرّب، يُحذف من صفحة المفاتيح ويُنشأ غيره.
هل OpenRouter API مجاني؟
جزئيًا. إنشاء الحساب والمفتاح مجاني، ويوفر OpenRouter نماذج مجانية ينتهي معرّفها بـ «:free». وما عدا ذلك يُدفع من رصيد مدفوع مسبقًا. ويذكر OpenRouter أيضًا أن المستخدمين الجدد يحصلون على رصيد مجاني صغير، دون أن يحدد مقداره.
وللنماذج المجانية حدود. هذه هي الحدود المنشورة لدى OpenRouter حتى 18 نوفمبر 2026:
- إذا نزل رصيدك تحت الصفر، يذكر OpenRouter أن النماذج المجانية نفسها قد تعيد أخطاء.
- يبيّن موقع OpenRouter النماذج التي لها حاليًا نسخة «:free»؛ والأفضل التحقق منه قبل الاعتماد على أي منها.
| حسابك | طلبات النماذج المجانية في الدقيقة | طلبات النماذج المجانية في اليوم |
|---|---|---|
| مجموع المشتريات أقل من 10 وحدات رصيد | 20 | 50 |
| مجموع المشتريات 10 وحدات رصيد على الأقل | 20 | 1,000 |
كيف يعمل رصيد OpenRouter؟
يعمل OpenRouter بالدفع المسبق: يُشترى الرصيد (credits) من صفحة Credits ببطاقة أو بإحدى طرق الدفع الأخرى المعروضة هناك، ويُخصم كل طلب منه. وحتى 18 نوفمبر 2026 تحدد شروط OpenRouter حدًا أدنى قدره $5 لكل عملية شراء، وتضيف رسوم دفع، وتذكر أن الرصيد غير المستخدم قد تنتهي صلاحيته بعد 365 يومًا من الشراء. والتفاصيل الحالية على openrouter.ai/terms.
لكل نموذج سعره الخاص لكل رمز (token)، ويظهر في صفحة النموذج على OpenRouter. ولا ننقل الأسعار هنا لأنها تتغير. يعرض Oriveo تكلفة تقديرية تحت كل رد، أما السجل النهائي فهو صفحتا النشاط والفوترة في OpenRouter.
كيف أستخدم OpenRouter على iPhone أو Android أو الويب؟
لعدم وجود تطبيق رسمي لـ OpenRouter على الهاتف، يلزم اختيار تطبيق عميل. وفي Oriveo يُعد OpenRouter واحدًا من 15 مزوّدًا مدمجًا، ويظهر ضمن «المُجمِّعات»، فلا حاجة إلى كتابة أي عنوان.
- فتح «مزودو الخدمة»: تبويب على iPhone وAndroid، أو في الشريط الجانبي على الويب.
- الضغط على زر + («إضافة مزوّد»)، ثم اختيار OpenRouter. وشريحة «المُجمِّعات» تختصر القائمة.
- لصق المفتاح تحت «ربط OpenRouter» ثم الضغط على «متابعة».
- انتظار رسالة «جارٍ التحقق من الاتصال ومزامنة النماذج...»؛ إذ يحمّل Oriveo قائمة نماذج OpenRouter.
- اختيار نموذج وبدء الدردشة. ومن دون رصيد، يُختار نموذج ينتهي معرّفه بـ «:free».

أين يذهب مفتاح OpenRouter؟
على iPhone وAndroid تذهب الطلبات من جهازك إلى المزوّد مباشرة، ويُحفظ مفتاحك في التخزين الآمن للهاتف (Keychain على iPhone، وKeystore على Android). أما في تطبيق الويب فتُرسَل الطلبات عبر تمرير لحظي على خادم Oriveo: يُستخدم مفتاحك لذلك الطلب فقط ولا يُحفظ كسجل في الحساب، ولا تُخزَّن محادثات BYOK كسجلات دردشة. والمزامنة السحابية لا ترفع المفاتيح. ولاستخدام OpenRouter على جهاز ثانٍ، يُلصق المفتاح هناك أيضًا، أو يُنشأ له مفتاح مستقل.
تدفع لـ OpenRouter مباشرة بأسعاره، ولا يضيف Oriveo أي هامش.
لماذا لا يعمل مفتاح OpenRouter API؟
تسرد صفحة الأخطاء لدى OpenRouter (openrouter.ai/docs/api-reference/errors) معنى كل كود. وهذه الأكثر شيوعًا حتى 18 نوفمبر 2026:
- في Oriveo يظهر الخطأ 402 بعنوان «تم استهلاك حصة المزود»، ويظهر 429 بعنوان «تجاوز الحد المسموح» على الويب أو «تم تقييد معدل المزود» على iPhone وAndroid.
- نموذج غير موجود في قائمتك: إعادة مزامنة قائمة النماذج والتأكد من أن OpenRouter ما زال يوفّره.
| الخطأ | المعنى | الحل |
|---|---|---|
| 401 Invalid credentials | المفتاح خاطئ أو معطّل أو محذوف | نسخ المفتاح كاملًا من جديد، أو إنشاء مفتاح جديد |
| 401 «this is not an OpenRouter API key» | المفتاح الملصوق تابع لمزوّد آخر | استخدام مفتاح من openrouter.ai/keys يبدأ بـ sk-or-v1- |
| 402 insufficient credits | نفد رصيد حسابك أو رصيد هذا المفتاح | إضافة رصيد، أو رفع حد المفتاح؛ والانتظار لا يفيد |
| 403 Forbidden | حظر بسبب الصلاحيات أو الإشراف على المحتوى (moderation) أو ضوابط الحماية (guardrail) أو حد الميزانية | مراجعة إعدادات المفتاح وحدوده، أو تعديل الرسالة |
| 429 rate limited | طلبات كثيرة، لدى OpenRouter أو لدى مزوّد النموذج | الانتظار ثم إعادة المحاولة؛ ومع النماذج المجانية، مراجعة الحدود أعلاه |
| 502 أو 503 | النموذج أو مزوّدوه غير متاحين الآن | المحاولة لاحقًا أو اختيار نموذج آخر |
OpenRouter أم مفتاح من كل مزوّد؟
يفيد OpenRouter حين تريد نماذج كثيرة بمفتاح واحد ورصيد واحد. أما المفتاح المأخوذ مباشرة من مزوّد مثل OpenAI أو Anthropic فيناسب من يريد حساب ذلك المزوّد وفوترته الخاصة. ويقبل Oriveo الاثنين، فيمكن إبقاء OpenRouter إلى جانب المفاتيح المباشرة والتبديل بين النماذج واحدًا بعد الآخر في المحادثة نفسها.
أسئلة شائعة حول التطبيق
هل استخدام OpenRouter مجاني؟
من أين أحصل على مفتاح OpenRouter API؟
هل لـ OpenRouter تطبيق على iPhone أو Android؟
ما معنى الخطأ 402 في OpenRouter؟
لماذا لا يعمل مفتاح OpenRouter API؟
كيف يبدو مفتاح OpenRouter API؟
قراءات ذات صلة
من المدوّنة
مفتاح OpenRouter على هاتفك
يكفي فتح تطبيق الويب أو تنزيل Oriveo على iPhone أو Android، ثم لصق مفتاح OpenRouter للتبديل بين النماذج مع تكلفة تقديرية تحت كل رد.
ليس لديك مفتاح API بعد؟ ابدأ باستخدام Oriveo Free.