ضع نماذج الكتالوج في Raycast AI بملف providers.yaml واحد.

إجابة سريعة: فعّل Custom Providers، عدّل ملفاً واحداً.

مسار Raycast لنقاط النهاية المتوافقة مع OpenAI هو ميزة Custom Providers، موجَّهة للمستخدمين المتقدمين ومُعطَّلة افتراضياً. فعّلها أسفل قسم AI في إعدادات Raycast، استخدم Reveal Providers Config لفتح مجلد الإعداد، وانسخ providers.template.yaml المُشحَّن إلى providers.yaml. يعيش الملف عند ~/.config/raycast/ai/providers.yaml. كل مُدخَل مزوّد يأخذ معرّفاً واسم عرض وbase_url وكتلة api_keys؛ كل نموذج تريده في المنتقي يُعلَن صراحة بمعرّفه واسم عرضه ونافذة سياقه، بالإضافة إلى كتلة abilities تصف ما يمكن لـ Raycast طلبه منه. شكل base_url يتبع نفس اصطلاح أمثلة النماذج المحلية المدمجة، التي تُشير إلى جذر /v1، لذا قيمة APIsRouter هي https://api.apisrouter.com/v1. الملف يحمل بيانات اعتماد، فعامله مثل أي ملف أسرار.

providers:
  - id: apisrouter
    name: APIsRouter
    base_url: https://api.apisrouter.com/v1
    api_keys:
      default: sk-APIsRouter-...
    models:
      - id: claude-sonnet-4-6
        name: Claude Sonnet 4.6
        context: 200000
        abilities:
          temperature:
            supported: true
          tools:
            supported: true
      - id: claude-haiku-4-5-20251001
        name: Claude Haiku 4.5
        context: 200000
        abilities:
          temperature:
            supported: true

ميزتان في Raycast تبدوان متشابهتين، وليستا كذلك.

يوثّق Raycast طريقتين لإحضار وصول ذكاء اصطناعي خاص بك، والبحث عن إحداهما يُظهِر الأخرى بموثوقية، لذا التمييز يستحق البيان بوضوح. Bring Your Own Keys، صفحة BYOK في دليل Raycast، تُوصِّل مفتاحك الشخصي من Anthropic أو Google أو OpenAI (OpenRouter على iOS) بـ Raycast AI. هي الميزة الأبسط، موثَّقة كعاملة دون اشتراك Pro، لكنها ليست نقطة نهاية مخصصة: تتوجّه الطلبات عبر خوادم Raycast لتوحيد API، والدليل صريح بأن فقط النماذج المتاحة بالفعل في Raycast AI قابلة للوصول. مفتاح بوابة لا يُدخَل هناك، لأن BYOK لا يطلب رابطاً أبداً. Custom Providers هي الميزة التي تُعِدّها هذه الصفحة: base_url خاص بك، مفتاحك الخاص، نماذجك المُعلَنة، والطلبات تذهب حيث تُوجِّهها. هو المسار لبوابة متعددة البائعين، للخوادم المحلية، ولأي نموذج لا تحمله قائمة Raycast المدمجة. الثمن هو الصراحة: لا يجلب Raycast قائمة نماذج نقطة النهاية لك (تلك الراحة طلب ميزة قائم)، لذا يعرض المنتقي بالضبط ما يُعلِنه YAML الخاص بك، لا أكثر ولا أقل.

إعلان النماذج بصدق: المعرّفات، السياق، القدرات.

بما أنه لا يوجد اكتشاف تلقائي، فإن YAML عقد، وكل حقل فيه يقوم بعمل حقيقي. معرّف النموذج يجب أن يطابق سرد /v1/models الخاص بالبوابة تماماً؛ هو ما يسافر في الطلب. الاسم مجرد التسمية التي يعرضها Raycast. قيمة السياق تخبر Raycast بكمية سجل المحادثة التي يمكنه حزمها في طلب، لذا التقليل منها يُهدِر القدرة والمبالغة فيها تُنتِج طلبات يرفضها النموذج؛ استخدم النافذة الموثَّقة للمعرّف الذي تُعلِنه. كتلة abilities هي ما يُخطئ فيه الناس. تُعلِن ما يمكن لـ Raycast الاعتماد عليه: التحكم بالحرارة، إدخال الرؤية، رسائل النظام، استخدام الأدوات، جهد الاستدلال. إعلان قدرة يفتقدها النموذج يُنتِج إخفاقات وقت تشغيل مُربِكة داخل ميزات Raycast بدلاً من أخطاء نظيفة، وإغفال قدرة حقيقية يُعطِّل بصمت سلوك Raycast المطابق. ابدأ بالحد الأدنى، الحرارة بالإضافة إلى الأدوات للنماذج التي ستستخدمها مع إضافات AI، وأضف قدرات مع تأكيدها مقابل توثيق النموذج. توجد إضافة Raycast مُصانة من المجتمع خصيصاً لإدارة هذا الملف من واجهة، بنسخ احتياطي تلقائي قبل كل تغيير، تستحق المعرفة إذا لم يكن YAML باليد تفضيلك. على أي حال، يقرأ Raycast الملف من القرص، لذا بعد التعديل، أعطِ إعدادات AI لحظة أو بدّل الميزة للتأكد من أن المنتقي يعكس الملف الحالي.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $APISROUTER_API_KEY" | head -50
# declare these ids verbatim in providers.yaml

اختيار نماذج للانشر.

بما أن كل نموذج مُعلَن يُفوتَر عبر نفس المفتاح، حلقة المقارنة هي تبديل في المنتقي: شغّل نفس الأوامر السريعة على معرّفَين ليوم، ثم اقرأ الإنفاق لكل نموذج في اللوحة واحتفظ بما كسب مكانه.

• ذكاء اللانشر عمل نوبات قصيرة: لخّص هذا، أعد كتابة ذلك، اشرح التحديد. claude-haiku-4-5-20251001 وgemini-3.5-flash يعودان قبل انتهاء حركة النافذة، وهذا هو الإحساس الذي يتوقعه مستخدمو Raycast.
• جلسات AI Chat والصياغة الطويلة تستحق claude-sonnet-4-6 أو gpt-5.5؛ أعلنهما إلى جانب الفئة السريعة وبدّل حسب المهمة في المنتقي.
• إضافات AI التي تستدعي أدوات تحتاج نموذجاً بقدرة أدوات موثوقة، مع كتلة abilities مُعلَنة لتطابق؛ claude-sonnet-4-6 هو الاختيار الآمن الأول هناك.
• deepseek-v4-flash هو الاختيار الحجمي للمستخدمين الذين يُوصِّلون الذكاء الاصطناعي في كل حقل نص يلمسونه؛ الإكمالات الصغيرة المستمرة تتراكم، والفئة السريعة تُبقي العادة غير مرئية على الرصيد.
• أعلن نماذج قليلة عمداً بدلاً من كثيرة نظرياً: كل مُدخَل صف تمرّره في المنتقي، وYAML سهل التوسيع في اليوم الذي تحتاج فيه معرّفاً آخر.

ادفع حسب الاستخدام · أقل من السعر الرسمي

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

أنماط الفشل الخاصة بـ Raycast.

إعداد BYOK بينما كنت تقصد Custom Providers هو الخطأ الأعلى مستوى، وليس خطأك: الميزتان تتشاركان مساحة بحث. إذا كان التدفق الذي أنت فيه يطلب مفتاح بائع لكن لا يطلب رابطاً أبداً، فأنت في BYOK، والبوابة لا تنتمي هناك. ارجع إلى Settings، AI، ومبدّل Custom Providers أسفل الصفحة. تجاهل الملف يعني عادة أن مبدّل الميزة مُطفَأ، أو أن الملف لا يزال مُسمّى providers.template.yaml، أو أن YAML به خطأ صياغي، وفي هذه الحالة لا يملك Raycast شيئاً صالحاً ليُحمِّله ويعرض المنتقي ببساطة بلا نماذج مخصصة. تحقّق من صحة YAML قبل الشك في شيء أعمق. نموذج يُخطئ في بعض ميزات Raycast دون غيرها هو عدم تطابق قدرات: إضافات AI المستخدمة للأدوات تفشل بينما تعمل الدردشة العادية عندما أُعلِنت tools على نموذج يفتقدها، أو لم تُعلَن أبداً على واحد يملكها. الطلبات المرفوضة بسبب الحجم تشير إلى قيمة سياق مبالَغ فيها. ولاحظ حدود المنصة بصدق: Custom Providers مُعَدّة على Mac، في ملف إعداد محلي. إذا كان جزء من استخدامك لـ Raycast في مكان آخر، تحقّق من الدليل لما تدعمه الميزة هناك قبل افتراض التكافؤ.

من يوجّه Raycast AI عبر بوابة.

• المستخدمون المتمرسون الذين يعيشون في اللانشر ويريدون أوامر ذكاء اصطناعي سريعة على معرّفات كتالوج سريعة دون اشتراك يقرر أي نماذج يمكنهم لمسها.
• الأشخاص الذين يوجّهون بالفعل محررهم وأدوات طرفيتهم عبر بوابة ويريدون اللانشر على نفس المفتاح، سجل استخدام واحد عبر كل سطح.
• المستخدمون الذين يريدون نماذج لا تحملها قائمة Raycast المدمجة، بما في ذلك معرّفات DeepSeek وGLM، مُعلَنة مرة واحدة في YAML ومتاحة في كل مكان في التطبيق.
• بناؤو إضافات AI الذين يحتاجون نموذجاً محدداً قادراً على الأدوات خلف إضافتهم، مُثبَّتاً بالمعرّف بدلاً من الخضوع لقائمة مُستضافة.
• المطورون الذين لا يملكون وصولاً إلى فوترة بائع معيّن. الوصول القائم على تعبئة الرصيد بدون شرط بطاقة يزيل الاعتماد على التسجيل لكل مزوّد.

تحقق من نقطة النهاية وصحّح أخطاء أول أمر.

شغّل curl على النماذج أولاً وانسخ المعرّفات من مُخرَجه إلى YAML؛ كتابة المعرّفات من الذاكرة هي السبب الرئيسي لأخطاء model-not-found هنا، لأن الملف هو مصدر النموذج الوحيد الذي يملكه Raycast. ثم فعّل المبدّل، تأكّد من أن المنتقي يعرض الأسماء المُعلَنة، وشغّل أمر AI سريعاً واحداً على النموذج السريع. منتقٍ فارغ يعني المبدّل، أو اسم الملف، أو صياغة YAML. خطأ مصادقة يعني كتلة api_keys. خطأ عدم عثور يعني عدم تطابق معرّف مقابل السرد الذي استخدمت curl عليه للتو. أمر يعمل في الدردشة لكن يفشل في إضافة AI يشير إلى إعلان القدرات على ذلك النموذج. بمجرد تدفّق الأوامر، تعرض لوحة APIsRouter النموذج لكل طلب، وعدد tokens، والإنفاق. ذكاء اللانشر هو مئات الطلبات الصغيرة بدلاً من طلبات قليلة كبيرة، وسجل الاستخدام هو حيث يصبح ذلك النمط رقماً، لكل نموذج، لكل يوم، على نفس الصفحة مثل كل أداة أخرى توجّهها عبر البوابة.

curl -s https://api.apisrouter.com/v1/chat/completions \
  -H "Authorization: Bearer $APISROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-haiku-4-5-20251001",
       "messages":[{"role":"user","content":"ping"}]}'

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