Додайте моделі каталогу в 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. Кожен запис провайдера бере 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, але це не кастомний ендпоінт: запити маршрутизуються через сервери Raycast для уніфікації API, і мануал прямо каже, що доступні лише моделі, вже присутні в Raycast AI. Ключ шлюзу туди не підключається, бо BYOK ніколи не питає URL. Custom Providers — це функція, яку налаштовує ця сторінка: ваш власний base_url, ваш власний ключ, ваші власні задекларовані моделі, запити йдуть туди, куди ви вказуєте. Це шлях для мультивендорного шлюзу, для локальних серверів і для будь-якої моделі, якої немає у вбудованому списку Raycast. Плата — явність: Raycast не отримує список моделей ендпоінта автоматично (ця зручність — постійний запит функції), тож селектор показує точно те, що декларує ваш YAML, ні більше ні менше.

Чесна декларація моделей: id, контекст, можливості.

Оскільки автовиявлення немає, YAML — це контракт, і кожне поле в ньому виконує реальну роботу. Id моделі має точно збігатися з лістингом /v1/models шлюзу; це те, що подорожує в запиті. Назва — лише мітка, яку показує Raycast. Значення context каже Raycast, скільки історії розмови можна упакувати в запит, тож заниження марнує можливості, а завищення видає запити, які модель відхиляє; використовуйте задокументоване вікно для id, який декларуєте. Блок 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

Вибір моделей для лаунчера.

Оскільки кожна задекларована модель оплачується через той самий ключ, цикл порівняння — це перемикання селектора: проженіть ті самі швидкі команди на двох id протягом дня, потім читайте витрати на модель у консолі й лишіть ту, що заслужила своє місце.

• AI лаунчера — це сплескова робота: підсумуй це, перепиши те, поясни виділене. 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, і шлюзу там не місце. Поверніться в Settings, AI і перемикач Custom Providers унизу. Файл, що ігнорується, зазвичай означає, що перемикач функції вимкнено, файл усе ще названий providers.template.yaml, чи YAML має синтаксичну помилку, у якому разі Raycast не має чого валідного завантажити, і селектор просто не показує кастомних моделей. Валідуйте YAML, перш ніж підозрювати щось глибше. Модель, що видає помилку на одних функціях Raycast, але не на інших, — невідповідність можливостей: AI-розширення, що використовують інструменти, падають, поки звичайний чат працює, коли tools задекларовано на моделі, яка їх не має, чи ніколи не задекларовано на тій, що має. Запити, відхилені за розміром, вказують на завищене значення context. І чесно зверніть увагу на межу платформи: Custom Providers налаштовується на Mac, у локальному файлі конфігурації. Якщо частина вашого використання Raycast — деінде, перевірте мануал щодо того, що функція там підтримує, перш ніж припускати паритет.

Хто спрямовує Raycast AI через шлюз.

• Активні користувачі, що живуть у лаунчері й хочуть швидких AI-команд на швидких id каталогу без підписки, що вирішує, яких моделей вони можуть торкатися.
• Люди, що вже маршрутизують редактор і термінал через шлюз і хочуть лаунчер на тому самому ключі, один лог використання на кожну поверхню.
• Користувачі, що хочуть моделей, яких немає у вбудованому списку Raycast, включно з id DeepSeek і GLM, задекларованих один раз у YAML і доступних усюди в застосунку.
• Будівники AI-розширень, яким потрібна конкретна модель з підтримкою інструментів за їхнім розширенням, прив'язана за id, а не залежна від хостованого списку.
• Розробники без доступу до білінгу певного постачальника. Доступ на основі поповнення без вимоги картки прибирає залежність від реєстрації в кожного провайдера.

Перевірте ендпоінт і налагодьте першу команду.

Спершу запустіть curl моделей і скопіюйте id з його виводу в YAML; введення id з пам'яті — головна причина помилок model-not-found тут, бо файл — єдине джерело моделей, яке має Raycast. Потім увімкніть перемикач, підтвердіть, що селектор показує ваші задекларовані назви, і запустіть одну швидку AI-команду на швидкій моделі. Порожній селектор — це перемикач, назва файлу чи синтаксис YAML. Помилка автентифікації — блок api_keys. Помилка not-found — невідповідність id проти лістингу, який ви щойно перевірили. Команда, що працює в чаті, але падає в AI-розширенні, — декларація abilities на тій моделі. Щойно команди потечуть, консоль APIsRouter показує модель на запит, кількість токенів і витрати. AI лаунчера — це сотні маленьких запитів, а не кілька великих, і лог використання — те місце, де цей патерн стає числом, на модель, на день, на тій самій сторінці, що й кожен інший інструмент, який ви маршрутизуєте через шлюз.

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

Поширені запитання