دليل مفتاح OpenRouter API

كيفية الحصول على مفتاح 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 يعني نفاد الرصيد.
Oriveo على iPhone: شاشة المزوّدين، وفيها المزوّدون الذين ربطتهم وإنفاق هذا الشهر.

ما هو 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»؛ والأفضل التحقق منه قبل الاعتماد على أي منها.
هل OpenRouter API مجاني؟
حسابكطلبات النماذج المجانية في الدقيقةطلبات النماذج المجانية في اليوم
مجموع المشتريات أقل من 10 وحدات رصيد2050
مجموع المشتريات 10 وحدات رصيد على الأقل201,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».
الشاشة الرئيسية في Oriveo، وفيها مربع الرسالة والنموذج المختار أسفله، ومحادثات اليوم مع تكلفة كل منها
بعد ربط المفتاح، يُختار النموذج من أسفل مربع الرسالة. وتظهر بجانب كل محادثة في القائمة تكلفتها التقديرية.

أين يذهب مفتاح 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 ما زال يوفّره.
لماذا لا يعمل مفتاح OpenRouter API؟
الخطأالمعنىالحل
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 مجاني؟
جزئيًا. المفتاح مجاني، والنماذج التي ينتهي معرّفها بـ «:free» لا تكلّف شيئًا ضمن حدود يومية: حتى 18 نوفمبر 2026، 50 طلبًا في اليوم، أو 1,000 بعد شراء 10 وحدات رصيد (credits) على الأقل. أما النماذج الأخرى فتحتاج إلى رصيد مدفوع مسبقًا.
من أين أحصل على مفتاح OpenRouter API؟
من openrouter.ai/keys بعد تسجيل الدخول: إنشاء مفتاح، وتسميته، ونسخه كاملًا؛ وهو يبدأ بـ «sk-or-v1-».
هل لـ OpenRouter تطبيق على iPhone أو Android؟
لا ينشر OpenRouter تطبيق دردشة خاصًا به للهاتف. والبديل تطبيق دردشة يقبل مفتاح OpenRouter: في Oriveo فتح «مزودو الخدمة»، ثم الضغط على +، واختيار OpenRouter، ولصق المفتاح، ثم «متابعة».
ما معنى الخطأ 402 في OpenRouter؟
معناه أن حسابك أو المفتاح المستخدم ليس فيه رصيد كافٍ. الحل إضافة رصيد في OpenRouter، أو رفع حد المفتاح إن كان له حد مضبوط، ثم إعادة المحاولة. فهذا الخطأ لا يزول من تلقاء نفسه.
لماذا لا يعمل مفتاح OpenRouter API؟
البداية برقم الخطأ: 401 يعني أن المفتاح خاطئ أو ليس مفتاح OpenRouter، و402 يعني عدم وجود رصيد، و429 يعني طلبات كثيرة أو بلوغ حد النماذج المجانية. ودليلنا لأخطاء مفاتيح API يشرح كل كود.
كيف يبدو مفتاح OpenRouter API؟
يبدأ بـ «sk-or-v1-»، تليه 64 خانة من الأحرف والأرقام، فيكون طوله 73 حرفًا في المجموع. فإن كان مفتاحك أقصر، فجزء منه لم يُنسخ.

قراءات ذات صلة

من المدوّنة

مفتاح OpenRouter على هاتفك

يكفي فتح تطبيق الويب أو تنزيل Oriveo على iPhone أو Android، ثم لصق مفتاح OpenRouter للتبديل بين النماذج مع تكلفة تقديرية تحت كل رد.

ليس لديك مفتاح API بعد؟ ابدأ باستخدام Oriveo Free.