Функции ИИ в Raycast теперь позволяют подключать любой провайдер, совместимый с OpenAI, через пользовательского провайдера в providers.yaml. CometAPI — это шлюзовой API, предоставляющий сотни моделей за OpenAI-совместимым REST-интерфейсом — вы можете направить 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-совместимых бэкендов.
Raycast постепенно внедряет BYOK (Bring Your Own Key) и Custom Providers в 2025 году, позволяя пользователям запускать Raycast AI с использованием своих ключей API и пользовательских конечных точек (что обеспечивает более гибкое управление затратами и частных провайдеров). Это изменение — техническая основа, делающая интеграцию CometAPI осуществимой из пользовательских настроек Raycast.
Как Raycast предоставляет ИИ пользователям?
- Quick AI: мгновенные запросы из лаунчера.
- AI Chat: диалоговые сессии с вложениями/контекстом.
- AI Commands/Extensions: команды или инструменты, созданные разработчиками, которые используют LLM.
(Модели, BYOK-ключи и пользовательские провайдеры можно управлять в Settings → AI.)
Что такое CometAPI?
CometAPI — это платформа-агрегатор API, предоставляющая сотни разных моделей ИИ (текст, изображения, аудио, видео, эмбеддинги) через единый, OpenAI-совместимый REST-интерфейс. Вместо написания и поддержки клиентского кода под конкретных провайдеров (OpenAI, Anthropic, Google, Midjourney, Runway и т. д.), вы обращаетесь к конечной точке CometAPI и выбираете нужную модель через строку модели. Это упрощение мощно для экспериментов, фейловер-маршрутизации по стоимости/отказам и централизации биллинга и наблюдаемости.
Ключевые возможности
- Текст/чат-комплишны и ассистенты (OpenAI-подобные чат-API).
- Генерация изображений и эндпоинты для редактирования изображений.
- Эмбеддинги для семантического поиска/RAG (retrieval-augmented generation).
- Аудио (TTS и STT, если поддерживается базовыми моделями).
- Генерация видео для специализированных бэкендов (Sora, Veo и т. д.).
CometAPI также предоставляет сниппеты SDK и форматы запросов в стиле OpenAI, поэтому перенос существующего кода упрощён.
Почему это важно сейчас: рынок смещается в сторону шлюзовых API (удобные единые конечные точки, более дешёвые варианты и выбор моделей). 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-совместимые конечные точки по адресу https://api.cometapi.com/v1. )
Какие хорошие сценарии использования этой интеграции?
- Помощник разработчика: объяснение кода, предложения по рефакторингу, генерация модульных тестов и сводки PR — вызывайте из Raycast и получайте ответы встраиваемо.
- Заметки и сводки: выделите текст, запустите команду Raycast для суммаризации или извлечения задач с помощью модели суммаризации CometAPI.
- Подготовка документации: генерируйте документацию к функциям или фрагменты README через ИИ-команды Raycast и держите итерации локально.
- Генерация изображений/мультимедиа: если CometAPI предоставляет эндпоинты изображений, вы можете использовать расширения Raycast, вызывающие эти эндпоинты (например, расширение "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.
Необязательные инструменты разработчика (для тестирования или локальной разработки)
- Терминал (для 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.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-стильного эндпоинта
GET /v1/models, если ваш провайдер его предоставляет. Если CometAPI предоставляет список моделей, Raycast сможет обновить и показать доступные модели.
Шаг 4: Обновите список моделей и протестируйте
- Вернувшись в Raycast, возможно, потребуется перезапустить приложение или воспользоваться командой “Refresh Models” (в зависимости от версии), чтобы Raycast получил модели от нового провайдера и заполнил селектор моделей. Рекомендуется обновить или перезапустить, если модели не появляются.
- Используйте простой запрос в Quick AI, выберите модель CometAPI в селекторе моделей и запустите тестовый промпт.
Рекомендации по лучшим практикам при использовании CometAPI внутри Raycast
Безопасность: Никогда не хардкодьте токены в общем providers.yaml. Предпочитайте защищённые поля Raycast или macOS Keychain, либо подставляйте ключи локально через переменные окружения, если используете локальный прокси. Ознакомьтесь с документами по приватности CometAPI и Raycast при работе с чувствительными данными.
Надёжность и производительность: Тестируйте латентность для моделей, которые планируете использовать — у шлюзовых API маршрутизация может быть переменной. Для интерактивных рабочих процессов (автосводки, быстрые запросы) выбирайте меньшие и быстрые модели. Для задач глубокого рассуждения — более мощные модели с большим контекстом.
Контроль затрат: Активно используйте выбор моделей: лёгкие модели — для коротких задач, высокоёмкие — для тяжёлых рассуждений. Отслеживайте использование в дашборде CometAPI и настраивайте уведомления о бюджете. Рассмотрите программные приёмы экономии токенов (например, более короткие system-сообщения, эффективное управление контекстом).
Инжиниринг промптов и UX: При создании AI Commands в Raycast (скопируйте встроенную команду и подправьте промпт) держите промпты детерминированными для утилитарных команд (суммаризация, триаж, поиск) и более свободными — для идейных сценариев. Рекомендуется копировать встроенные команды и настраивать промпты.
Как устранить распространённые проблемы?
Модели не отображаются в Raycast: Убедитесь, что providers.yaml находится ровно в папке, открытой через Reveal Providers Config. Используйте шаблон как основу и перезапустите Raycast. Перезапуск или “Refresh Models” помогают.
401 / недействительный токен: Проверьте, что ваш токен CometAPI действителен и не истёк. Попробуйте curl-тест выше. Убедитесь, что вы используете Bearer-токен и заголовок Authorization указан правильно.
Ошибки модели или несовместимые форматы ответов: CometAPI стремится к совместимости с OpenAI, но возможны крайние случаи (ID моделей, поведение стриминга). Если Raycast ожидает конкретный формат стриминга, а CometAPI выдаёт чуть иной, попробуйте сначала непотоковый вызов и при необходимости обратитесь в поддержку CometAPI.
Заключение
CometAPI предоставляет унифицированный, мультивендорный доступ ко многим моделям (текст, изображения, аудио, видео) и помогает командам централизовать биллинг и маршрутизацию. Raycast даёт мгновенный, ориентированный на клавиатуру способ вызывать эти модели в контексте настольных рабочих процессов. Вместе они делают эксперименты с моделями и автоматизацию рабочего стола бесшовными — вы можете менять модели ради стоимости или качества, держать ключи локально и использовать те же привычные паттерны в стиле OpenAI, что уже есть в ваших скриптах и приложениях.
Если хотите попробовать прямо сейчас, изучите возможности models's(Gemini 3 Pro Preview API и др.) CometAPI в Playground и обратитесь к руководству по API за подробными инструкциями. Перед доступом убедитесь, что вы вошли в CometAPI и получили ключ API. CometAPI предлагают цену значительно ниже официальной, чтобы помочь вам с интеграцией.
Готовы начать?→ используйте CometAPI в Raycast уже сегодня !
Если вы хотите больше советов, руководств и новостей об ИИ, подпишитесь на нас в VK, X и Discord!
