הכניסו מודלי קטלוג ל-Raycast AI עם providers.yaml אחד.

תשובה מהירה: הפעילו Custom Providers, ערכו קובץ אחד.

הנתיב של Raycast עבור endpoints תואמי-OpenAI הוא תכונת Custom Providers, מיועדת למשתמשים מתקדמים ומושבתת כברירת מחדל. הפעילו אותה בתחתית סעיף ה-AI בהגדרות Raycast, השתמשו ב-Reveal Providers Config כדי לפתוח את תיקיית ההגדרות, והעתיקו את providers.template.yaml המצורף ל-providers.yaml. הקובץ חי ב-~/.config/raycast/ai/providers.yaml. כל רשומת ספק לוקחת id, שם תצוגה, base_url, ובלוק api_keys; כל מודל שאתם רוצים בבוחר מוכרז במפורש עם ה-id שלו, שם תצוגה, וחלון ההקשר שלו, בתוספת בלוק 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 מתעד שתי דרכים להביא גישת 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 רב-ספקים, עבור שרתים מקומיים, ועבור כל מודל שהרשימה המובנית של Raycast לא נושאת. המחיר הוא בהירות מפורשת, Raycast לא שולף עבורכם את רשימת המודלים של ה-endpoint (הנוחות הזו היא בקשת תכונה עומדת), כך שהבוחר מציג בדיוק מה שה-YAML שלכם מכריז, לא יותר ולא פחות.

הכרזת מודלים בכנות: ids, הקשר, יכולות.

מכיוון שאין גילוי-אוטומטי, ה-YAML הוא חוזה, וכל שדה בו עושה עבודה אמיתית. ה-id של המודל חייב להתאים לרשימת ה-/v1/models של ה-gateway בדיוק; זה מה שנוסע בכל בקשה. ה-name הוא רק התווית ש-Raycast מציג. ערך ה-context אומר ל-Raycast כמה היסטוריית שיחה הוא רשאי לארוז לתוך בקשה, אז המעטה בו מבזבזת יכולת והפרזה בו מייצרת בקשות שהמודל דוחה; השתמשו בחלון המתועד עבור ה-id שאתם מכריזים. בלוק ה-abilities הוא זה שאנשים טועים בו. הוא מכריז מה Raycast רשאי להסתמך עליו: שליטת temperature, קלט חזותי, הודעות מערכת, שימוש בכלים, מאמץ נימוק. הכרזת יכולת שלמודל אין מייצרת כשלים מבלבלים בזמן ריצה בתוך תכונות Raycast במקום שגיאות נקיות, והשמטת אחת שקיימת משביתה בשקט את התנהגות Raycast המתאימה. התחילו במינימלי, temperature בתוספת tools עבור המודלים שתשתמשו בהם עם תוספי AI, והוסיפו יכולות ככל שאתם מאשרים אותן מול התיעוד של המודל. תוסף Raycast המתוחזק על ידי הקהילה קיים במיוחד כדי לנהל את הקובץ הזה מ-UI, עם גיבויים אוטומטיים לפני כל שינוי, שווה לדעת אם 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

בחירת מודלים ל-launcher.

מכיוון שכל מודל מוכרז מחויב דרך אותו מפתח, לולאת ההשוואה היא החלפה בבוחר: הריצו את אותן פקודות מהירות על שני ids במשך יום, ואז קראו הוצאה-לכל-מודל בקונסולה ושמרו את זה שהרוויח את מקומו.

• AI ב-launcher היא עבודת פרץ: סכם את זה, שכתב את זה, הסבר את הבחירה. 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 הוא הבחירה בנפח למשתמשים שמחווטים AI לכל שדה טקסט שהם נוגעים בו; השלמות קטנות קבועות מצטברות, והשכבה המהירה שומרת על ההרגל בלתי-נראה על היתרה.
• הכריזו מעט מודלים במכוון במקום הרבה באופן ספקולטיבי: כל רשומה היא שורת בוחר שאתם גוללים מעליה, וה-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 היא הטעות המובילה, ואינה אשמתכם: התכונות חולקות מרחב חיפוש. אם הזרימה שאתם נמצאים בה מבקשת מפתח ספק אבל אף פעם לא URL, אתם ב-BYOK, וה-gateway לא שייך שם. חזרו אל Settings, AI, ומתג ה-Custom Providers בתחתית. הקובץ שמתעלמים ממנו בדרך כלל אומר שמתג התכונה כבוי, שהקובץ עדיין נקרא providers.template.yaml, או של-YAML יש שגיאת syntax, ובמקרה כזה ל-Raycast אין שום דבר תקף לטעון והבוחר פשוט מציג ללא מודלים מותאמים אישית. אמתו את ה-YAML לפני שאתם חושדים במשהו עמוק יותר. מודל ששוגה בחלק מתכונות Raycast אבל לא באחרות הוא אי-התאמת abilities: תוספי AI שמשתמשים בכלים נכשלים בעוד צ'אט רגיל עובד כש-tools הוכרזה על מודל שחסר לו, או אף פעם לא הוכרזה על מודל שיש לו. בקשות שנדחות בגלל גודל מצביעות על ערך context מוגזם. ושימו לב לגבול הפלטפורמה בכנות: Custom Providers מוגדר על ה-Mac, בקובץ הגדרה מקומי. אם חלק משימוש ה-Raycast שלכם הוא במקום אחר, בדקו את המדריך למה שהתכונה תומכת שם לפני שאתם מניחים שוויון.

מי מנתב את Raycast AI דרך gateway.

• משתמשי-כוח שחיים ב-launcher ורוצים פקודות AI מהירות על ids מהירים מהקטלוג בלי שמנוי מחליט אילו מודלים מותר להם לגעת.
• אנשים שכבר מנתבים כלי עורך וטרמינל דרך gateway ורוצים שה-launcher יהיה על אותו מפתח, לוג שימוש אחד על פני כל משטח.
• משתמשים שרוצים מודלים שהרשימה המובנית של Raycast לא נושאת, כולל ids של DeepSeek ו-GLM, מוכרזים פעם אחת ב-YAML וזמינים בכל מקום באפליקציה.
• בוני תוספי-AI שצריכים מודל תומך-כלים ספציפי מאחורי התוסף שלהם, נעוץ לפי id במקום כפוף לרשימה מתארחת.
• מפתחים ללא גישה לחיוב של ספק נתון. גישה מבוססת-הטענה בלי דרישת כרטיס מסירה את התלות בהרשמה לכל ספק.

אמתו את ה-endpoint ובצעו דיבוג לפקודה הראשונה.

הריצו קודם את ה-curl לרשימת המודלים והעתיקו ids מהפלט שלו לתוך ה-YAML; הקלדת ids מהזיכרון היא הגורם המוביל לשגיאות model-not-found כאן, מכיוון שהקובץ הוא מקור המודל היחיד ש-Raycast יש לו. לאחר מכן הפעילו את המתג, אשרו שהבוחר מציג את השמות המוכרזים שלכם, והריצו פקודת AI מהירה אחת על המודל המהיר. בוחר ריק הוא המתג, שם הקובץ, או syntax ה-YAML. שגיאת אימות היא בלוק ה-api_keys. שגיאת not-found היא אי-התאמת id מול הרשימה שזה עתה עשיתם לה curl. פקודה שעובדת בצ'אט אבל נכשלת בתוסף AI היא הכרזת ה-abilities על המודל הזה. ברגע שפקודות זורמות, קונסולת APIsRouter מציגה מודל לכל בקשה, ספירות טוקן, והוצאה. AI ב-launcher הוא מאות בקשות קטנות במקום מעט גדולות, ולוג השימוש הוא המקום שבו הדפוס הזה הופך למספר, לכל מודל, לכל יום, באותו עמוד כמו כל כלי אחר שאתם מנתבים דרך ה-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"}]}'

שאלות נפוצות