Raycast의 AI 기능은 이제 providers.yaml 커스텀 프로바이더를 통해 OpenAI 호환 프로바이더를 어디든 연결할 수 있습니다. CometAPI는 OpenAI 스타일의 REST 인터페이스 뒤에서 수백 개의 모델을 제공하는 게이트웨이 API이므로, Raycast의 엔드포인트를 https://api.cometapi.com/v1로 지정하고 CometAPI 키를 추가해 Raycast AI(채팅, 명령, 확장) 안에서 CometAPI 모델을 사용할 수 있습니다.
What is Raycast?
Raycast는 macOS용 생산성 런처로, 명령어, 스크립트, 그리고 — 점점 더 — AI를 여러분의 운영체제에 직접 통합합니다. AI 서브시스템은 채팅, AI 명령, 모델 선택, 확장(LLM이 작업을 수행하도록 하는 도구), 그리고 로컬 모델(Ollama 경유) 또는 원격 모델 프로바이더에 연결하는 Bring Your Own Key / Custom Providers를 제공합니다. Raycast는 모델 선택기, AI 설정, 그리고 고급 사용자가 OpenAI 호환 백엔드를 추가하도록 커스터마이즈할 수 있는 providers.yaml 템플릿을 제공합니다.
Raycast는 2025년에 BYOK(Bring Your Own Key)와 Custom Providers를 순차적으로 출시하여, 사용자가 자신의 API 키와 커스텀 엔드포인트로 Raycast AI를 실행할 수 있게 했습니다(유연한 비용 관리와 비공개 프로바이더 옵션을 가능하게 함). 이 변화는 사용자 환경설정에서 CometAPI를 Raycast에 통합할 수 있게 하는 기술적 기반입니다.
How does Raycast surface AI to users?
- Quick AI: 런처에서 즉시 프롬프트를 실행.
- AI Chat: 첨부/컨텍스트가 포함된 대화 세션.
- AI Commands/Extensions: LLM을 사용하는 개발자 제작 명령이나 도구.
(Settings → AI에서 모델, BYOK 키, 커스텀 프로바이더를 관리할 수 있습니다.)
What is CometAPI?
CometAPI는 단일 OpenAI 스타일 REST 인터페이스를 통해 수백 가지 서로 다른 AI 모델(텍스트, 이미지, 오디오, 비디오, 임베딩)을 노출하는 API 집약 플랫폼입니다. OpenAI, Anthropic, Google, Midjourney, Runway 등 각각에 맞는 클라이언트 코드를 작성하고 유지보수하는 대신, CometAPI 엔드포인트를 호출하고 모델 문자열로 원하는 모델을 선택하면 됩니다. 이 단순화는 실험, 비용/장애 조치 라우팅, 청구 및 관측의 중앙화에 강력합니다.
Key capabilities
- 텍스트/채팅 생성 및 assistants(OpenAI 유사 채팅 API).
- 이미지 생성 및 이미지 편집 엔드포인트.
- 임베딩(시맨틱 검색/RAG 용도).
- 오디오(TTS/STT, 기반 모델이 제공하는 경우).
- 전용 백엔드(Sora, Veo 등)를 위한 비디오 생성.
CometAPI는 SDK 스니펫과 OpenAI 스타일 요청 포맷도 제공하므로 기존 코드를 이식하기 쉽습니다.
왜 지금 중요할까요: 시장은 게이트웨이 API(편리한 단일 엔드포인트, 더 저렴한 옵션, 모델 선택)로 이동하고 있습니다. CometAPI는 그 영역의 상용 플레이어 중 하나이므로, Raycast의 커스텀 프로바이더 지원과 결합하면 macOS 워크플로에서 폭넓은 모델 카탈로그에 즉시 접근할 수 있습니다.
Why integrate CometAPI with Raycast?
짧은 답: Raycast AI 플로우(Quick AI, AI Chat, 커스텀 AI 명령) 안에서 CometAPI가 제공하는 어떤 모델이든 바로 실행하기 위해 — 도구를 바꾸지 않고.
Benefits:
- 요약, 코드, 임베딩, 이미지 생성 등 작업별로 더 저렴/더 빠르거나 특화된 모델을 Raycast 안에서 그대로 사용.
- Raycast에서 모델 선택을 제어하면서 CometAPI를 통해 청구와 스로틀링을 중앙화.
- 코드 변경 최소화: Raycast는 OpenAI 호환 커스텀 프로바이더와 BYOK를 지원하므로, 종종
base_url과 API 키만 교체하면 CometAPI가 바로 연결됩니다.
(이러한 기능은 Raycast가 커스텀 프로바이더와 BYOK를 지원하고, CometAPI가 https://api.cometapi.com/v1. 에서 OpenAI 호환 엔드포인트를 제공하기 때문에 가능합니다.)
What are good use cases for this integration?
- 개발자 도우미: 코드 설명, 리팩터링 제안, 단위 테스트 생성, PR 요약 — Raycast에서 호출해 인라인 답변을 받기.
- 노트와 요약: 텍스트를 선택하고 Raycast 명령으로 요약 또는 액션 아이템 추출(CometAPI 요약 모델 활용).
- 문서화 작성: Raycast AI 명령으로 함수 문서나 README 스니펫 생성, 로컬에서 반복 작업.
- 이미지/멀티미디어 생성: CometAPI가 이미지 엔드포인트를 제공한다면, 해당 엔드포인트를 호출하는 Raycast 확장(예: "Generate Image from Prompt")을 사용 — 빠른 목업에 유용.
- 임베딩 + 시맨틱 검색: CometAPI 임베딩으로 로컬 검색 워크플로 강화 — Raycast를 프런트엔드로 쓰고, 임베딩 인덱스를 질의하는 작은 로컬 스크립트나 클라우드 펑션을 결합.
What environment and conditions must be prepared?
시작하기 전에 다음을 준비하세요:
System & Raycast
- macOS(Raycast는 macOS 네이티브).
- Raycast 설치. 커스텀 프로바이더/BYOK를 지원하는 최신 버전을 권장(Raycast는 v1.100.0에서 BYOK를 추가했으며 커스텀 프로바이더를 계속 출시 중). 버전이 오래됐다면 업데이트하세요.
Accounts & keys
- CometAPI 계정과 유효한 CometAPI API 키(Raycast 설정 또는 환경 변수에서 사용). CometAPI 대시보드/문서 참고.
Optional developer tools (for testing or local development)
- 터미널(cURL 테스트용).
- Python / Node / OpenAI SDK(CometAPI 접근을 Raycast 연동 전 직접 테스트하려는 경우). CometAPI는
base_url을 오버라이드하는 방식으로 표준 SDK 사용을 지원합니다.
Permissions & networking
- Raycast와 macOS 네트워크 정책이
api.cometapi.com으로의 HTTPS 호출을 허용하는지 확인. - 기업 환경에서 프록시/방화벽을 사용한다면
api.cometapi.com접근 가능 여부 확인.
Local files & locations
Raycast의 AI 프로바이더 구성은 Raycast 설정 디렉터리의 providers.yaml에 저장됩니다(앱에서 템플릿을 표시하여 복사할 수 있음). 커스텀 프로바이더를 정의하려면 providers.yaml을 편집 또는 생성합니다.
How do I integrate Raycast with CometAPI?
핵심 아이디어: Raycast에 CometAPI를 OpenAI 호환 커스텀 프로바이더로 등록하고, Raycast를 https://api.cometapi.com/v1로 지정한 뒤, Comet 토큰을 Raycast의 커스텀 API 키로 추가합니다.
Step 1: Get your CometAPI key
- CometAPI에서 가입하고 콘솔/대시보드를 엽니다.
- API 토큰을 생성 합니다. 토큰을 안전한 곳에 복사해 둡니다(또는 다음 단계에서 사용).
Step 2: Open Raycast’s AI settings and enable custom providers
- Raycast에서:
Preferences→AI. - “Custom Providers”(또는 “Custom OpenAI-compatible APIs”)를 찾고 Reveal Providers Config를 클릭합니다. Raycast가 Finder에서 설정 디렉터리를 열고 템플릿 파일(보통
providers.template.yaml)을 제공합니다. 이 파일을 복사해providers.yaml로 이름을 변경합니다.
Step 3: Add a CometAPI provider to providers.yaml
providers.yaml 파일을 생성하거나 편집합니다. Raycast가 기대하는 정확한 스키마는 버전에 따라 달라질 수 있지만, 커뮤니티 템플릿과 Raycast 매뉴얼은 공통 구조를 보여줍니다: id, name, base_url, 선택적 models 블록을 갖는 프로바이더 엔트리 목록입니다. 아래는 CometAPI를 등록하기 위한 안전하고 동작하는 예시 — OpenAI-co
Important notes
YOUR_COMETAPI_KEY를 안전한 참조로 바꾸세요 — 개인 용도라면 토큰을 붙여넣어도 되지만, 가능하면 macOS 키체인/Raycast의 보안 필드를 사용하세요(지원되는 경우).- 중요한 줄은
base_url입니다:https://api.cometapi.com/v1. 를 가리키도록 설정하세요. Raycast는 해당 기본 URL을 OpenAI 호환 호출에 사용합니다. - 모든 모델을 사전에 나열할 필요는 없습니다 — 프로바이더가 OpenAI 스타일의
GET /v1/models엔드포인트를 제공한다면 Raycast가 모델 목록을 가져올 수 있습니다. CometAPI가 모델 목록을 노출한다면, Raycast는 이를 새로 고침해 사용 가능한 모델을 표시할 수 있습니다.
Step 4: Refresh models and test
- Raycast로 돌아가 새 프로바이더에서 모델을 가져와 모델 선택기를 채우도록 앱을 재시작하거나(버전에 따라) “Refresh Models” 명령을 사용해야 할 수 있습니다. 모델이 나타나지 않으면 새로 고침 또는 재시작을 권장합니다.
- 간단한 Quick AI 프롬프트에서 CometAPI의 모델을 모델 선택기로 선택한 뒤 테스트 프롬프트를 실행하세요.
Best practices when using CometAPI inside Raycast
Security best practices: 공유된 providers.yaml에 토큰을 하드코딩하지 마세요. 가능한 Raycast의 보안 필드나 macOS 키체인, 또는 로컬 프록시를 사용하는 경우 환경 변수를 사용하세요. 민감한 데이터가 있다면 CometAPI와 Raycast의 개인정보 문서를 읽어보세요.
Reliability & performance: 지연 시간 테스트를 권장합니다 — 게이트웨이 API는 라우팅에 따라 변동이 있을 수 있습니다. 상호작용 워크플로(자동 요약, 빠른 조회)에는 더 작고 빠른 모델을, 심층 추론 작업에는 더 큰 컨텍스트 모델을 선택하세요.
Cost control: 모델 선택을 적극적으로 사용하세요: 짧은 작업에는 경량 모델, 무거운 추론에는 고용량 모델. CometAPI 대시보드에서 사용량을 추적하고 예산 알림을 설정하세요. 시스템 메시지를 짧게 하고 컨텍스트를 효율적으로 관리하는 등, 토큰 사용을 줄이기 위한 프로그램적 프롬프트 설계를 고려하세요.
Prompt engineering & UX: Raycast AI Commands를 만들 때(기본 명령을 복제해 프롬프트를 조정), 유틸리티 명령(요약, 분류, 검색)에는 결정적인 프롬프트를, 아이데이션 워크플로에는 보다 개방적인 프롬프트를 유지하세요. 기본 명령을 복사해 프롬프트를 커스터마이즈하는 방식을 권장합니다.
How to troubleshoot common issues?
모델이 Raycast에 보이지 않음: Raycast의 providers.yaml이 반드시 Reveal Providers Config로 열린 정확한 폴더에 있어야 합니다. 템플릿을 기준으로 삼고 Raycast를 재시작하세요. 재시작 또는 “Refresh Models”가 도움이 됩니다.
401 / invalid token: CometAPI 토큰이 유효하고 만료되지 않았는지 확인하세요. 위의 curl 테스트를 시도해 보세요. Bearer 토큰을 사용했는지, Authorization 헤더가 정확한지 재확인하세요.
모델 오류 또는 비호환 응답 형태: CometAPI는 OpenAI 호환을 목표로 하지만 몇몇 엣지 케이스(모델 ID, 스트리밍 동작 등)가 있을 수 있습니다. Raycast가 특정 스트리밍 형식을 기대하는데 CometAPI가 약간 다른 형태를 보낸다면, 먼저 비스트리밍 호출을 시도하고 필요 시 CometAPI 지원팀에 문의하세요.
Conclusion
CometAPI는 다수의 모델(텍스트, 이미지, 오디오, 비디오)에 대한 통합된 멀티벤더 접근을 제공하고, 팀이 청구와 라우팅을 중앙화할 수 있게 합니다. Raycast는 데스크톱 워크플로 맥락에서 이러한 모델을 즉각적이고 키보드 중심으로 호출할 수 있는 장소를 제공합니다. 함께 사용하면 모델 실험과 데스크톱 자동화가 매끄러워집니다 — 비용이나 품질에 따라 모델을 교체하고, 키를 로컬에 보관하며, 스크립트와 앱에서 이미 사용하는 익숙한 OpenAI 스타일 패턴을 그대로 활용할 수 있습니다.
바로 시도해 보고 싶다면 CometAPI의 Playground에서 모델의(Gemini 3 Pro Preview API 등) 기능을 탐색하고 상세한 지침은 API 가이드를 확인하세요. 액세스 전에 CometAPI에 로그인하고 API 키를 발급받았는지 확인하십시오. CometAPI는 통합을 돕기 위해 공식 가격보다 훨씬 낮은 가격을 제공합니다.
Ready to Go?→ 오늘 Raycast에서 CometAPI 사용하기 !