تتيح لك ميزات الذكاء الاصطناعي في Raycast الآن توصيل أي مزوّد متوافق مع OpenAI عبر مزوّد مخصص providers.yaml. تُعد CometAPI واجهة API وسيطة تكشف مئات النماذج خلف واجهة REST بأسلوب OpenAI — لذا يمكنك توجيه Raycast إلى https://api.cometapi.com/v1، وإضافة مفتاح CometAPI الخاص بك، واستخدام نماذج CometAPI داخل Raycast AI (الدردشة، الأوامر، والامتدادات).
ما هو Raycast؟
Raycast هو مشغّل إنتاجية لنظام macOS يدمج الأوامر، والبرامج النصية، وبشكل متزايد — الذكاء الاصطناعي مباشرة داخل نظام التشغيل لديك. يوفّر نظامه الفرعي للذكاء الاصطناعي الدردشة، وأوامر الذكاء الاصطناعي، واختيار النماذج، والامتدادات (أدوات تتيح لنماذج اللغة الكبيرة تنفيذ إجراءات)، وإمكانية استخدام النماذج المحلية (عبر Ollama) أو إحضار مفتاحك الخاص / المزوّدات المخصصة للاتصال بمزوّدي النماذج عن بُعد. يوفّر Raycast أداة اختيار للنماذج، وإعدادات للذكاء الاصطناعي، وقالب providers.yaml يمكن للمستخدمين المتقدمين تخصيصه لإضافة واجهات خلفية متوافقة مع OpenAI.
كان Raycast يطرح BYOK (إحضار مفتاحك الخاص) والمزوّدات المخصصة خلال عام 2025، مما يتيح للمستخدمين تشغيل Raycast AI باستخدام مفاتيح API الخاصة بهم ونقاط نهاية مخصصة (مما يوفّر مرونة أكبر في إدارة التكاليف وخيارات المزوّدات الخاصة). هذا التغيير هو الأساس التقني الذي يجعل دمج CometAPI ممكنًا من تفضيلات Raycast الخاصة بالمستخدم النهائي.
كيف يقدّم Raycast الذكاء الاصطناعي للمستخدمين؟
- الذكاء الاصطناعي السريع: مطالبات فورية من المشغّل.
- دردشة الذكاء الاصطناعي: جلسات حوارية مع مرفقات/سياق.
- أوامر/امتدادات الذكاء الاصطناعي: أوامر أو أدوات يبنيها المطورون وتستخدم نماذج اللغة الكبيرة.
(يمكنك إدارة النماذج، ومفاتيح BYOK، والمزوّدات المخصصة من Settings → AI.)
ما هي CometAPI؟
CometAPI هي منصة لتجميع واجهات API تكشف مئات النماذج المختلفة للذكاء الاصطناعي (النصوص، الصور، الصوت، الفيديو، والتضمينات) عبر واجهة REST واحدة بأسلوب OpenAI. بدلًا من كتابة وصيانة شيفرة عميل خاصة بكل مزوّد مثل OpenAI وAnthropic وGoogle وMidjourney وRunway وغيرهم، يمكنك استدعاء نقطة نهاية CometAPI واختيار النموذج الذي تريده عبر سلسلة اسم النموذج. هذا التبسيط قوي للتجريب، وتوجيه التكلفة/التبديل الاحتياطي، ومركزة الفوترة وإمكانية المراقبة.
الإمكانات الرئيسية
- إكمالات النص/الدردشة والمساعدون (واجهات دردشة شبيهة بـ OpenAI).
- نقاط نهاية لتوليد الصور وتحريرها.
- تضمينات للبحث الدلالي/RAG (التوليد المعزّز بالاسترجاع).
- الصوت (تحويل النص إلى كلام وتحويل الكلام إلى نص عند توفيرها من النماذج الأساسية).
- توليد الفيديو للواجهات الخلفية المتخصصة (Sora وVeo وغيرهما).
كما توفّر CometAPI مقتطفات SDK وتنسيقات طلبات بأسلوب OpenAI بحيث يكون نقل الشيفرة الحالية مباشرًا.
لماذا هذا مهم الآن: يتجه السوق نحو واجهات API الوسيطة (نقاط نهاية موحّدة مريحة، وخيارات أرخص، واختيار أوسع للنماذج). تُعد CometAPI أحد اللاعبين التجاريين في هذا المجال، لذا فإن دمجها مع دعم Raycast للمزوّدات المخصصة يمنحك وصولًا فوريًا إلى كتالوج واسع من النماذج من داخل سير عملك على macOS.
لماذا تدمج CometAPI مع Raycast؟
الإجابة المختصرة: لتشغيل أي نموذج تكشفه CometAPI مباشرة من داخل تدفق Raycast AI — سواء الذكاء الاصطناعي السريع، أو دردشة الذكاء الاصطناعي، أو أوامر الذكاء الاصطناعي المخصصة — من دون تبديل الأدوات.
الفوائد:
- استخدام نماذج أرخص/أسرع أو متخصصة لمهام مختلفة (الملخصات، البرمجة، التضمينات، توليد الصور) مع البقاء داخل Raycast.
- فوترة مركزية والتحكم في المعدلات عبر CometAPI مع التحكم في اختيار النموذج من داخل Raycast.
- الحد الأدنى من تغييرات الشيفرة: يدعم Raycast المزوّدات المخصصة المتوافقة مع OpenAI وBYOK، لذا غالبًا ما يتم توصيل CometAPI فقط عبر تبديل
base_urlومفتاح API.
(هذه الإمكانات ممكنة لأن Raycast يدعم المزوّدات المخصصة وBYOK، ولأن CometAPI تكشف نقاط نهاية متوافقة مع OpenAI على https://api.cometapi.com/v1. )
ما هي حالات الاستخدام الجيدة لهذا الدمج؟
- مساعد المطور: شرح الشيفرة، واقتراحات إعادة الهيكلة، وتوليد اختبارات الوحدة، وتلخيص طلبات السحب — استدعها من Raycast واحصل على إجابات مضمّنة.
- الملاحظات والملخصات: حدّد نصًا، ثم شغّل أمر Raycast لتلخيصه أو استخراج عناصر الإجراءات باستخدام نموذج تلخيص من CometAPI.
- إنشاء الوثائق: أنشئ توثيقًا للدوال أو مقتطفات README عبر أوامر Raycast AI مع إبقاء التكرارات محلية.
- توليد الصور / الوسائط المتعددة: إذا كانت CometAPI تكشف نقاط نهاية للصور، فيمكنك استخدام امتدادات Raycast التي تستدعي نقاط نهاية الصور (مثل امتداد "Generate Image from Prompt") — وهو مفيد للنماذج الأولية السريعة.
- التضمينات + البحث الدلالي: استخدم تضمينات CometAPI لتشغيل تدفقات البحث المحلي — يمكن أن يكون Raycast الواجهة الأمامية التي تستعلم عن فهرس التضمين لديك عبر برنامج نصي محلي صغير أو دالة سحابية.
ما البيئة والشروط التي يجب إعدادها؟
قبل البدء، تأكد من تجهيز ما يلي:
النظام وRaycast
- macOS (Raycast مخصص أصلًا لـ macOS).
- تثبيت Raycast. يُفضّل استخدام إصدار حديث يدعم المزوّدات المخصصة / BYOK (أضاف Raycast دعم BYOK في v1.100.0 ويواصل طرح المزوّدات المخصصة). إذا كان إصدار Raycast لديك أقدم، فقم بتحديثه.
الحسابات والمفاتيح
- حساب CometAPI ومفتاح CometAPI API صالح (ستستخدمه في إعدادات Raycast أو في متغيرات البيئة). راجع لوحة تحكم/وثائق CometAPI.
أدوات مطور اختيارية (للاختبار أو التطوير المحلي)
- الطرفية (لاستخدام cURL).
- Python / Node / حِزم OpenAI SDK إذا كنت ترغب في اختبار الوصول إلى CometAPI مباشرة قبل ربطها بـ Raycast. تدعم CometAPI الاستخدام المباشر عبر الحِزم القياسية من خلال تجاوز
base_url.
الأذونات والشبكات
- تأكد من أن Raycast وسياسات الشبكة على macOS تسمح بإجراء اتصالات HTTPS إلى
api.cometapi.com. - إذا كنت تعمل في بيئة مؤسسية بها وكيل/جدار ناري، فتحقق من إمكانية الوصول إلى
api.cometapi.com.
الملفات والمواقع المحلية
يوجد إعداد مزوّدي الذكاء الاصطناعي في Raycast داخل ملف providers.yaml ضمن دليل إعدادات Raycast (يمكن للتطبيق إظهار قالب للمزوّدات يمكنك نسخه). ستقوم بتحرير providers.yaml أو إنشائه لتعريف المزوّدات المخصصة.
كيف أدمج Raycast مع CometAPI؟
الفكرة الأساسية: سجّل CometAPI كمزوّد مخصص متوافق مع OpenAI داخل Raycast، ووجّه Raycast إلى https://api.cometapi.com/v1، ثم أضف رمز Comet الخاص بك إلى مفاتيح API المخصصة في Raycast.
الخطوة 1: احصل على مفتاح CometAPI الخاص بك
- سجّل في CometAPI وافتح وحدة التحكم / لوحة التحكم.
- أنشئ رمز API . انسخ هذا الرمز إلى مكان آمن (أو احتفظ به للخطوة التالية).
الخطوة 2: افتح إعدادات الذكاء الاصطناعي في Raycast وفعّل المزوّدات المخصصة
- في Raycast:
Preferences→AI. - ابحث عن “Custom Providers” (أو “Custom OpenAI-compatible APIs”) وانقر Reveal Providers Config. سيفتح Raycast تطبيق Finder في دليل الإعدادات ويوفّر ملف قالب (عادة
providers.template.yaml) لنسخه وإعادة تسميته إلىproviders.yaml.
الخطوة 3: أضف مزوّد CometAPI إلى providers.yaml
أنشئ ملف providers.yaml أو حرّره. قد يختلف المخطط الدقيق الذي يتوقعه Raycast حسب الإصدار، لكن قوالب المجتمع ودليل Raycast يوضحان البنية الشائعة: قائمة من إدخالات المزوّدين تحتوي على id وname وbase_url وكتلة models اختيارية. فيما يلي مثال آمن وعملي لتسجيل CometAPI كمزوّد OpenAI مخصّص متوا
ملاحظات مهمة
- استبدل
YOUR_COMETAPI_KEYبمرجع آمن — إما بلصق الرمز (للاستخدام الشخصي) أو الأفضل: تخزينه في macOS Keychain / الحقول الآمنة في Raycast إذا كانت مدعومة. base_urlهو السطر المهم: وجّهه إلىhttps://api.cometapi.com/v1. سيستخدم Raycast عنوان URL الأساسي هذا لاستدعاءات OpenAI المتوافقة.- لست بحاجة بالضرورة إلى إدراج جميع النماذج مسبقًا — يمكن لـ Raycast جلب قائمة النماذج من نقطة نهاية
GET /v1/modelsبأسلوب OpenAI إذا كان المزوّد يوفّرها. إذا كانت CometAPI تكشف قائمة النماذج، فيمكن لـ Raycast تحديث النماذج المتاحة وعرضها.
الخطوة 4: حدّث النماذج واختبر
- بالعودة إلى Raycast، قد تحتاج إلى إعادة تشغيل التطبيق أو استخدام أمر “Refresh Models” (بحسب الإصدار) حتى يجلب Raycast النماذج من المزوّد الجديد ويملأ أداة اختيار النماذج. أوصي بالتحديث أو إعادة التشغيل إذا لم تظهر النماذج.
- استخدم مطالبة بسيطة في Quick AI لاختيار نموذج CometAPI من أداة اختيار النماذج وتشغيل مطالبة اختبار.
أفضل الممارسات عند استخدام CometAPI داخل Raycast
أفضل ممارسات الأمان: لا تضع الرموز المميّزة بشكل ثابت داخل providers.yaml مشترك. فضّل الحقول الآمنة في Raycast أو macOS Keychain، أو مرّر المفاتيح محليًا باستخدام متغيرات البيئة إذا كنت تستخدم وكيلًا محليًا. اقرأ سياسات الخصوصية لكل من CometAPI وRaycast إذا كانت لديك بيانات حساسة.
الاعتمادية والأداء: اختبر زمن الاستجابة للنماذج التي تنوي استخدامها — فقد يكون التوجيه في واجهات API الوسيطة متغيرًا. بالنسبة لسير العمل التفاعلي (الملخصات التلقائية، وعمليات البحث السريعة) فضّل النماذج الأصغر والأسرع. أما لمهام الاستدلال الأعمق فاختر النماذج ذات السياق الأكبر.
التحكم في التكلفة: استخدم اختيار النموذج بكثافة: اختر نماذج خفيفة للمهام القصيرة، ونماذج عالية السعة للاستدلال الثقيل. تتبّع الاستخدام من لوحة تحكم CometAPI واضبط تنبيهات الميزانية. فكّر في مطالبات مُحكمة برمجيًا لتقليل استهلاك الرموز (مثل رسائل نظام أقصر، وإدارة سياق أكثر كفاءة).
هندسة المطالبات وتجربة المستخدم: عند إنشاء أوامر Raycast AI (من خلال تكرار أمر مدمج وتعديل المطالبة)، اجعل المطالبات حتمية في أوامر المنفعة (التلخيص، والفرز، والبحث) وأكثر انفتاحًا في تدفقات توليد الأفكار. يُعد نسخ الأوامر المدمجة وتخصيص المطالبات هو الأسلوب الموصى به.
كيف يمكن استكشاف المشكلات الشائعة وإصلاحها؟
لا تظهر النماذج في Raycast: تأكد من أن ملف providers.yaml في المجلد الدقيق الذي يكشفه Reveal Providers Config. استخدم القالب كنقطة انطلاق وأعد تشغيل Raycast. يمكن أن تساعد إعادة التشغيل أو “Refresh Models”.
401 / رمز غير صالح: تأكد من أن رمز CometAPI صالح ولم تنتهِ صلاحيته. جرّب اختبار curl أعلاه. تحقّق مرة أخرى من أنك استخدمت Bearer token وأن ترويسة Authorization صحيحة.
أخطاء النماذج أو أشكال استجابة غير متوافقة: تهدف CometAPI إلى التوافق مع OpenAI، لكن قد توجد بعض الحالات الطرفية (معرّفات النماذج، وسلوكيات البث). إذا كان Raycast يتوقع تنسيق بث معينًا وكانت CometAPI ترسل شكلًا مختلفًا قليلًا، فجرّب أولًا استدعاء غير متدفق وتواصل مع دعم CometAPI إذا لزم الأمر.
الخلاصة
تمنحك CometAPI وصولًا موحّدًا ومتعدد المزوّدين إلى العديد من النماذج (النص، والصورة، والصوت، والفيديو)، وتتيح للفرق مركزة الفوترة والتوجيه. ويمنحك Raycast مكانًا فوريًا قائمًا على لوحة المفاتيح لاستدعاء هذه النماذج ضمن سياق تدفقات العمل على سطح المكتب لديك. معًا، يجعلان تجربة النماذج وأتمتة سطح المكتب بلا احتكاك — يمكنك تبديل النماذج بحسب التكلفة أو الجودة، والاحتفاظ بمفاتيحك محليًا، واستخدام الأنماط نفسها المألوفة بأسلوب OpenAI التي تستخدمها بالفعل في البرامج النصية والتطبيقات.
إذا كنت ترغب في التجربة فورًا، فاستكشف قدرات النماذج's(Gemini 3 Pro Preview API etc) الخاصة بـ CometAPI في Playground، وراجع دليل API للحصول على تعليمات مفصلة. قبل الوصول، يُرجى التأكد من أنك سجّلت الدخول إلى CometAPI وحصلت على مفتاح API. تقدّم CometAPI سعرًا أقل بكثير من السعر الرسمي لمساعدتك على التكامل.
هل أنت مستعد للانطلاق؟→ استخدم CometAPI في Raycast اليوم !
إذا كنت تريد معرفة المزيد من النصائح، والأدلة، وأخبار الذكاء الاصطناعي، فتابعنا على VK، وX، وDiscord!