Подключите модели каталога к Raycast AI одним файлом providers.yaml.

Короткий ответ: включите Custom Providers, отредактируйте один файл.

Путь Raycast для OpenAI-совместимых эндпоинтов — это функция Custom Providers, нацеленная на продвинутых пользователей и по умолчанию отключённая. Включите её внизу раздела AI в Raycast Settings, используйте 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. Файл хранит credentials, так что обращайтесь с ним как с любым файлом секретов.

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, context, abilities.

Поскольку автообнаружения нет, YAML — это контракт, и каждое поле в нём выполняет реальную работу. Id модели должен точно совпадать с листингом /v1/models шлюза; именно он путешествует в запросе. 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

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

Поскольку каждая объявленная модель оплачивается через один и тот же ключ, цикл сравнения — это переключение в выпадающем списке: прогоните одни и те же быстрые команды на двух 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 в каждое текстовое поле, которого касаются; постоянные мелкие completions накапливаются, и быстрый уровень держит эту привычку незаметной для баланса.
• Объявляйте немного моделей осознанно, а не много про запас: каждая запись — это строка в выпадающем списке, которую вы пролистываете, а 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, но не на других, — это несовпадение abilities: 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 с листингом, который вы только что скачали curl'ом. Команда, которая работает в чате, но падает в 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"}]}'

Частые вопросы