مدل‌های کاتالوگ را با یک providers.yaml در Raycast AI بگذارید.

پاسخ سریع: Custom Providers را فعال کنید، یک فایل را ویرایش کنید.

مسیر Raycast برای endpoint های سازگار با OpenAI ویژگی Custom Providers است، هدف‌گذاری‌شده برای کاربران پیشرفته و به‌طور پیش‌فرض غیرفعال. آن را در پایین بخش AI در تنظیمات Raycast فعال کنید، از Reveal Providers Config برای باز‌کردن پوشه config استفاده کنید، و providers.template.yaml عرضه‌شده را به providers.yaml کپی کنید. فایل در ~/.config/raycast/ai/providers.yaml زندگی می‌کند. هر ورودی provider یک id، یک نام نمایشی، یک base_url، و یک بلوک api_keys می‌گیرد؛ هر مدلی که در انتخاب‌گر می‌خواهید صریح با id آن، یک نام نمایشی، و context window آن اعلام می‌شود، به‌علاوه یک بلوک abilities که توصیف می‌کند Raycast چه چیزی ممکن است از آن بخواهد. شکل base_url از همان قرارداد مثال‌های مدل-محلی داخلی پیروی می‌کند، که به یک ریشه /v1 اشاره می‌کنند، پس مقدار APIsRouter برابر https://api.apisrouter.com/v1 است. فایل credential ها را نگه می‌دارد، پس آن را مثل هر فایل secrets در نظر بگیرید.

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 دو راه برای آوردن دسترسی AI خودتان مستند می‌کند، و جست‌وجو برای یکی به‌طور قابل‌اتکا دیگری را نمایان می‌کند، پس این تمایز ارزش بیان صریح دارد. Bring Your Own Keys، صفحه BYOK در راهنمای Raycast، کلید شخصی Anthropic، Google، یا OpenAI شما (OpenRouter روی iOS) را به Raycast AI متصل می‌کند. این ویژگی ساده‌تر است، مستندشده به‌عنوان کار‌کردن بدون اشتراک Pro، اما یک endpoint سفارشی نیست: درخواست‌ها از طریق سرورهای Raycast برای یکپارچه‌سازی API مسیردهی می‌شوند، و راهنما صریح است که فقط مدل‌هایی که از قبل در Raycast AI موجودند قابل‌دسترس‌اند. یک کلید gateway آنجا وصل نمی‌شود، چون BYOK هرگز یک URL نمی‌خواهد. Custom Providers ویژگی‌ای است که این صفحه پیکربندی می‌کند: base_url خودتان، کلید خودتان، مدل‌های اعلام‌شده خودتان، درخواست‌ها به جایی که اشاره می‌کنید می‌روند. این مسیر برای یک gateway چند-vendor، برای سرورهای محلی، و برای هر مدلی که فهرست داخلی Raycast حمل نمی‌کند است. معامله صراحت است، Raycast فهرست مدل endpoint را برای شما fetch نمی‌کند (آن راحتی یک feature request در انتظار است)، پس انتخاب‌گر دقیقاً چیزی را نشان می‌دهد که YAML شما اعلام می‌کند، نه بیشتر نه کمتر.

اعلام صادقانه مدل‌ها: id ها، context، توانایی‌ها.

چون هیچ autodiscovery ای وجود ندارد، YAML یک قرارداد است، و هر فیلد در آن کار واقعی انجام می‌دهد. id مدل باید دقیقاً با فهرست /v1/models gateway مطابقت داشته باشد؛ آن چیزی است که در درخواست سفر می‌کند. name فقط برچسبی است که Raycast نشان می‌دهد. مقدار context به Raycast می‌گوید چقدر تاریخچه مکالمه ممکن است در یک درخواست بسته‌بندی کند، پس کم‌گفتن آن قابلیت را هدر می‌دهد و بیش‌گفتن آن درخواست‌هایی تولید می‌کند که مدل رد می‌کند؛ از پنجره مستندشده برای id ای که اعلام می‌کنید استفاده کنید. بلوک abilities همان چیزی است که مردم اشتباه می‌کنند. آنچه Raycast ممکن است به آن تکیه کند را اعلام می‌کند: کنترل temperature، ورودی vision، پیام‌های سیستم، tool use، تلاش استدلال. اعلام یک توانایی که مدل ندارد شکست‌های runtime گیج‌کننده داخل ویژگی‌های Raycast تولید می‌کند به‌جای خطاهای تمیز، و حذف یکی که مدل دارد بی‌صدا رفتار متناظر Raycast را غیرفعال می‌کند. حداقلی شروع کنید، temperature به‌علاوه tools برای مدل‌هایی که با extension های AI استفاده خواهید کرد، و توانایی‌ها را همان‌طور که در برابر مستندات مدل تأیید می‌کنید اضافه کنید. یک extension نگه‌داری‌شده توسط community در Raycast مخصوصاً برای مدیریت این فایل از یک UI وجود دارد، با backup خودکار قبل از هر تغییر، ارزش دانستن اگر YAML-به-دست ترجیح شما نیست. به هر حال، Raycast فایل را از دیسک می‌خواند، پس بعد از ویرایش، به تنظیمات AI یک لحظه بدهید یا ویژگی را toggle کنید تا مطمئن شوید انتخاب‌گر فایل فعلی را منعکس می‌کند.

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

انتخاب مدل‌ها برای یک launcher.

چون هر مدل اعلام‌شده از طریق همان کلید صورت‌حساب می‌شود، حلقه مقایسه یک سوییچ انتخاب‌گر است: همان دستورات سریع را روی دو id به مدت یک روز اجرا کنید، سپس هزینه هر-مدل را در کنسول بخوانید و آنی که جایگاهش را کسب کرده را نگه دارید.

• AI در launcher کار burst وار است: این را خلاصه کن، آن را بازنویسی کن، انتخاب را توضیح بده. claude-haiku-4-5-20251001 و gemini-3.5-flash قبل از تمام‌شدن انیمیشن پنجره برمی‌گردند، که همان حس‌ای است که کاربران Raycast انتظار دارند.
• session های AI Chat و پیش‌نویسی بلند claude-sonnet-4-6 یا gpt-5.5 را کسب می‌کنند؛ آن‌ها را در کنار سطح سریع اعلام کنید و به ازای هر وظیفه در انتخاب‌گر سوییچ کنید.
• extension های AI که tool ها را فرا می‌خوانند به یک مدل با tool use قابل‌اتکا نیاز دارند، و بلوک abilities اعلام‌شده برای تطابق؛ claude-sonnet-4-6 اولین انتخاب ایمن آنجا است.
• deepseek-v4-flash انتخاب حجمی برای کاربرانی است که AI را در هر فیلد متنی که لمس می‌کنند سیم‌کشی می‌کنند؛ completion های کوچک ثابت جمع می‌شوند، و سطح سریع عادت را روی موجودی نامرئی نگه می‌دارد.
• عمداً چند مدل اعلام کنید به‌جای زیاد به‌طور نظری: هر ورودی یک ردیف انتخاب‌گر است که از آن اسکرول می‌کنید، و YAML روزی که یک id دیگر نیاز دارید آسان برای گسترش است.

پرداخت بر اساس مصرف · پایین‌تر از قیمت رسمی

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 بود اشتباه سطح-بالا است، و تقصیر شما نیست: ویژگی‌ها یک فضای جست‌وجو مشترک دارند. اگر flow ای که در آن هستید یک کلید vendor می‌خواهد اما هرگز یک URL نمی‌خواهد، شما در BYOK هستید، و gateway آنجا تعلق ندارد. به Settings، AI، و toggle مربوط به Custom Providers در پایین برگردید. نادیده‌گرفته‌شدن فایل معمولاً یعنی toggle ویژگی خاموش است، فایل هنوز providers.template.yaml نام‌گذاری شده، یا YAML یک خطای syntax دارد، در آن صورت Raycast چیز معتبری برای لود ندارد و انتخاب‌گر به‌سادگی هیچ مدل سفارشی نشان نمی‌دهد. قبل از شک به چیز عمیق‌تری، YAML را اعتبارسنجی کنید. مدلی که روی برخی ویژگی‌های Raycast خطا می‌دهد اما نه دیگران یک عدم‌تطابق abilities است: extension های AI ای که از tool استفاده می‌کنند شکست می‌خورند در حالی که چت ساده کار می‌کند وقتی tools روی مدلی اعلام شده که آن را ندارد، یا هرگز روی مدلی که دارد اعلام نشده. درخواست‌های رد‌شده برای اندازه به یک مقدار context اغراق‌شده اشاره دارند. و مرز پلتفرم را صادقانه توجه کنید: Custom Providers روی مک پیکربندی می‌شود، در یک فایل config محلی. اگر بخشی از استفاده Raycast شما جای دیگری است، قبل از فرض برابری راهنما را برای اینکه ویژگی آنجا چه چیزی پشتیبانی می‌کند چک کنید.

چه کسانی Raycast AI را از طریق یک gateway مسیردهی می‌کنند.

• کاربران قدرتمند که در launcher زندگی می‌کنند و دستورات سریع AI را روی id های کاتالوگ سریع می‌خواهند بدون اینکه یک اشتراک تصمیم بگیرد کدام مدل‌ها را ممکن است لمس کنند.
• افرادی که از قبل ابزارهای ادیتور و ترمینال خود را از طریق یک gateway مسیردهی می‌کنند و می‌خواهند launcher روی همان کلید باشد، یک usage log در سرتاسر هر سطح.
• کاربرانی که مدل‌هایی می‌خواهند که فهرست داخلی Raycast حمل نمی‌کند، شامل id های DeepSeek و GLM، یک‌بار در YAML اعلام‌شده و در همه‌جای اپ در دسترس.
• سازندگان extension-AI که به یک مدل خاص دارای قابلیت-tool پشت extension خود نیاز دارند، pin شده با id به‌جای مشروط به یک فهرست میزبانی‌شده.
• توسعه‌دهندگان بدون دسترسی به صورت‌حساب یک vendor خاص. دسترسی مبتنی بر شارژ بدون الزام کارت وابستگی ثبت‌نام هر-provider را حذف می‌کند.

endpoint را تأیید کنید و اولین دستور را عیب‌یابی کنید.

اول curl مدل‌ها را اجرا کنید و id ها را از خروجی آن به YAML کپی کنید؛ تایپ id ها از حافظه اصلی‌ترین علت خطاهای model-not-found اینجاست، چون فایل تنها منبع مدل Raycast است. سپس toggle را فعال کنید، تأیید کنید انتخاب‌گر نام‌های اعلام‌شده شما را نشان می‌دهد، و یک دستور سریع AI را روی مدل سریع اجرا کنید. یک انتخاب‌گر خالی همان toggle، نام فایل، یا syntax YAML است. یک خطای احراز هویت بلوک api_keys است. یک خطای not-found یک عدم‌تطابق id در برابر فهرستی است که تازه curl کرده‌اید. دستوری که در چت کار می‌کند اما در یک extension AI شکست می‌خورد اعلام abilities روی آن مدل است. وقتی دستورات جاری شوند، کنسول APIsRouter مدل، شمارش token، و هزینه هر-درخواست را نشان می‌دهد. AI در launcher صدها درخواست کوچک است به‌جای چند درخواست بزرگ، و usage log جایی است که آن الگو به یک عدد، به ازای هر مدل، به ازای هر روز، در همان صفحه هر ابزار دیگری که از طریق gateway مسیردهی می‌کنید تبدیل می‌شود.

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"}]}'

پرسش‌های پرتکرار