Теперь функции ИИ в Raycast позволяют подключать любого OpenAI-совместимого провайдера через пользовательского провайдера providers.yaml. CometAPI — это шлюзовой API, который предоставляет доступ к сотням моделей через REST-интерфейс в стиле OpenAI, поэтому вы можете указать в Raycast https://api.cometapi.com/v1, добавить свой ключ CometAPI и использовать модели CometAPI внутри Raycast AI (чат, команды, расширения).
Что такое Raycast?
Raycast — это лаунчер продуктивности для macOS, который интегрирует команды, скрипты и — всё активнее — ИИ напрямую в вашу операционную систему. Его ИИ-подсистема предоставляет чат, ИИ-команды, выбор моделей, расширения (инструменты, позволяющие LLM выполнять действия), а также возможность использовать локальные модели (через Ollama) или Bring Your Own Key / Custom Providers для подключения удалённых поставщиков моделей. Raycast предоставляет переключатель моделей, настройки для ИИ и шаблон providers.yaml, который продвинутые пользователи могут настраивать для добавления OpenAI-совместимых бэкендов.
В 2025 году Raycast начал развёртывать BYOK (Bring Your Own Key) и Custom Providers, что позволяет пользователям запускать Raycast AI с собственными API-ключами и пользовательскими endpoint’ами, обеспечивая более гибкое управление расходами и использование частных провайдеров. Это изменение является технической основой, благодаря которой интеграция CometAPI становится возможной из пользовательских настроек Raycast.
Как Raycast предоставляет ИИ пользователям?
- Quick AI: мгновенные запросы из лаунчера.
- AI Chat: диалоговые сессии с вложениями/контекстом.
- AI Commands/Extensions: созданные разработчиками команды или инструменты, использующие LLM.
(Управлять моделями, BYOK-ключами и пользовательскими провайдерами можно в Settings → AI.)
Что такое CometAPI?
CometAPI — это платформа-агрегатор API, которая предоставляет доступ к сотням различных ИИ-моделей (текст, изображения, аудио, видео, эмбеддинги) через единый REST-интерфейс в стиле OpenAI. Вместо написания и поддержки клиентского кода для каждого отдельного провайдера — OpenAI, Anthropic, Google, Midjourney, Runway и т. д. — вы вызываете endpoint CometAPI и выбираете нужную модель через строку модели. Такое упрощение особенно полезно для экспериментов, маршрутизации по стоимости/отказоустойчивости и централизации биллинга и наблюдаемости.
Ключевые возможности
- Текстовые/чат-комплишены и assistants (чатовые API в стиле OpenAI).
- Endpoint’ы генерации и редактирования изображений.
- Эмбеддинги для семантического поиска/RAG (retrieval-augmented generation).
- Аудио (TTS и STT, если поддерживаются базовыми моделями).
- Генерация видео для специализированных бэкендов (Sora, Veo и т. д.).
CometAPI также предоставляет примеры SDK и форматы запросов в стиле OpenAI, поэтому перенос существующего кода выполняется просто.
Почему это особенно важно сейчас: рынок смещается в сторону шлюзовых API (удобные единые endpoint’ы, более дешёвые варианты и выбор моделей). CometAPI — один из коммерческих игроков в этом сегменте, поэтому его сочетание с поддержкой пользовательских провайдеров Raycast даёт вам немедленный доступ к широкому каталогу моделей из вашего рабочего процесса на macOS.
Зачем интегрировать CometAPI с Raycast?
Короткий ответ: чтобы запускать любую модель, доступную через CometAPI, прямо из вашего сценария работы с Raycast AI — Quick AI, AI Chat или пользовательских ИИ-команд — без переключения между инструментами.
Преимущества:
- Использование более дешёвых/быстрых или специализированных моделей для разных задач (сводки, код, эмбеддинги, генерация изображений), оставаясь внутри Raycast.
- Централизованный биллинг и управление ограничениями через CometAPI при сохранении контроля над выбором модели из Raycast.
- Минимум изменений в коде: Raycast поддерживает OpenAI-совместимых пользовательских провайдеров и BYOK, поэтому CometAPI часто подключается просто заменой
base_urlи API-ключа.
(Эти возможности доступны, потому что Raycast поддерживает пользовательских провайдеров и BYOK, а CometAPI предоставляет OpenAI-совместимые endpoint’ы по адресу https://api.cometapi.com/v1. )
Какие сценарии использования подходят для этой интеграции?
- Помощник разработчика: объяснение кода, предложения по рефакторингу, генерация unit-тестов и суммаризация PR — вызывается из Raycast и даёт ответы прямо на месте.
- Заметки и сводки: выделите текст, запустите команду Raycast для суммаризации или извлечения action items с помощью модели суммаризации CometAPI.
- Создание документации: генерируйте документацию к функциям или фрагменты README через команды Raycast AI и сохраняйте итерации локально.
- Генерация изображений / мультимедиа: если CometAPI предоставляет endpoint’ы для изображений, вы можете использовать расширения Raycast, которые обращаются к этим endpoint’ам (например, расширение «Generate Image from Prompt») — это полезно для быстрых мокапов.
- Эмбеддинги + семантический поиск: используйте эмбеддинги CometAPI для локальных поисковых сценариев — Raycast может быть фронтендом, который обращается к вашему индексу эмбеддингов через небольшой локальный скрипт или облачную функцию.
Какие окружение и условия нужно подготовить?
Перед началом убедитесь, что у вас готово следующее:
Система и Raycast
- macOS (Raycast изначально создан для macOS).
- Установленный Raycast. Предпочтительно использовать свежую версию с поддержкой Custom Providers / BYOK (Raycast добавил BYOK в v1.100.0 и продолжает развёртывать Custom Providers). Если у вас старая версия Raycast, обновите её.
Аккаунты и ключи
- Аккаунт CometAPI и действительный API-ключ CometAPI (вы будете использовать его в настройках Raycast или в переменных окружения). См. панель управления/документацию CometAPI.
Необязательные инструменты разработчика (для тестирования или локальной разработки)
- Terminal (для cURL).
- Python / Node / OpenAI SDK, если вы хотите протестировать доступ к CometAPI напрямую перед подключением к Raycast. CometAPI поддерживает прямое использование через стандартные SDK с переопределением
base_url.
Разрешения и сеть
- Убедитесь, что Raycast и сетевые политики macOS разрешают HTTPS-запросы к
api.cometapi.com. - Если вы работаете в корпоративной среде с прокси/фаерволом, проверьте доступность
api.cometapi.com.
Локальные файлы и расположения
Конфигурация ИИ-провайдеров Raycast находится в файле providers.yaml в каталоге конфигурации Raycast (приложение может показать шаблон providers, который можно скопировать). Вы будете редактировать или создавать 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-co
Важные примечания
- Замените
YOUR_COMETAPI_KEYна безопасную ссылку — либо вставьте токен (для личного использования), либо, что лучше, сохраните его в macOS Keychain / защищённых полях Raycast, если это поддерживается. base_url— это самая важная строка: укажитеhttps://api.cometapi.com/v1. Raycast будет использовать этот базовый URL для OpenAI-совместимых вызовов.- Вам не обязательно заранее перечислять все модели — Raycast может получать список моделей из корректно реализованного OpenAI-style endpoint’а
GET /v1/models, если ваш провайдер его предоставляет. Если CometAPI предоставляет список моделей, Raycast сможет обновить и отобразить доступные модели.
Шаг 4: Обновите модели и протестируйте
- Вернувшись в Raycast, вам может понадобиться перезапустить приложение или использовать команду «Refresh Models» (в зависимости от версии), чтобы Raycast получил модели от нового провайдера и заполнил список выбора моделей. Я рекомендую выполнить обновление или перезапуск, если модели не появляются.
- Используйте простой запрос в Quick AI, выберите модель CometAPI из списка и выполните тестовый запрос.
Рекомендации по использованию CometAPI внутри Raycast
Лучшие практики безопасности: Никогда не жёстко прописывайте токены в общем providers.yaml. Предпочтительнее использовать защищённые поля Raycast или macOS Keychain, либо локально подставлять ключи через переменные окружения, если вы используете локальный прокси. Ознакомьтесь с политиками конфиденциальности CometAPI и Raycast, если работаете с чувствительными данными.
Надёжность и производительность: Проверяйте задержку для моделей, которые собираетесь использовать — шлюзовые API могут иметь переменную маршрутизацию. Для интерактивных сценариев (автосводки, быстрые запросы) лучше выбирать более компактные и быстрые модели. Для задач с более глубокими рассуждениями выбирайте модели с большим контекстом.
Контроль затрат: Активно используйте выбор модели: выбирайте лёгкие модели для коротких задач и модели высокой мощности для сложных рассуждений. Отслеживайте использование в панели CometAPI и настраивайте бюджетные уведомления. Рассмотрите программную оптимизацию промптов для снижения расхода токенов (например, более короткие системные сообщения, эффективное управление контекстом).
Промпт-инжиниринг и UX: При создании AI Commands в Raycast (дублируйте встроенную команду и настраивайте промпт) делайте промпты более детерминированными для утилитарных команд (суммаризация, триаж, поиск) и более открытыми для сценариев генерации идей. Копирование встроенных команд и настройка промптов — рекомендуемый подход.
Как устранять распространённые проблемы?
Модели не отображаются в Raycast: Убедитесь, что providers.yaml Raycast находится точно в той папке, которая была показана через Reveal Providers Config. Используйте шаблон как основу и перезапустите Raycast. Перезапуск или «Refresh Models» часто помогает.
401 / недействительный токен: Убедитесь, что ваш токен CometAPI действителен и не истёк. Попробуйте выполнить упомянутый выше тест curl. Также проверьте, что вы используете Bearer token и что заголовок Authorization указан правильно.
Ошибки модели или несовместимые форматы ответа: CometAPI стремится быть совместимым с OpenAI, но некоторые пограничные случаи возможны (ID моделей, поведение потоковой передачи). Если Raycast ожидает определённый формат стриминга, а CometAPI возвращает немного другую структуру, сначала попробуйте нестриминговый запрос и при необходимости обратитесь в поддержку CometAPI.
Заключение
CometAPI даёт вам унифицированный мультивендорный доступ ко множеству моделей (текст, изображения, аудио, видео) и позволяет командам централизовать биллинг и маршрутизацию. Raycast даёт вам мгновенное, ориентированное на клавиатуру место для вызова этих моделей в контексте ваших настольных рабочих процессов. Вместе они делают эксперименты с моделями и автоматизацию рабочего стола практически бесшовными — вы можете переключать модели ради стоимости или качества, хранить ключи локально и использовать те же привычные OpenAI-style паттерны, которые уже применяете в скриптах и приложениях.
Если вы хотите попробовать прямо сейчас, изучите возможности моделей (Gemini 3 Pro Preview API и т. д.) от CometAPI в Playground и обратитесь к руководству по API за подробными инструкциями. Перед доступом обязательно убедитесь, что вы вошли в CometAPI и получили API-ключ. CometAPI предлагает цену значительно ниже официальной, чтобы помочь вам с интеграцией.
Готовы начать?→ используйте CometAPI в Raycast уже сегодня !
Если вы хотите узнать больше советов, руководств и новостей об ИИ, подписывайтесь на нас в VK, X и Discord!