Raycast의 AI 기능은 이제 providers.yaml 커스텀 프로바이더를 통해 어떤 OpenAI-호환 프로바이더든 연결할 수 있습니다. CometAPI는 OpenAI 스타일의 REST 인터페이스 뒤에서 수백 개의 모델을 제공하는 게이트웨이 API이므로, Raycast의 엔드포인트를 https://api.cometapi.com/v1로 지정하고 CometAPI 키를 추가한 뒤, Raycast AI(채팅, 커맨드, 익스텐션) 안에서 CometAPI 모델을 사용할 수 있습니다.
Raycast란?
Raycast는 macOS에서 명령과 스크립트, 그리고 최근에는 AI까지 운영체제 수준으로 통합하는 생산성 런처입니다. AI 서브시스템은 채팅, AI 명령, 모델 선택, 확장 기능(LLM이 작업을 수행할 수 있게 하는 도구), 그리고 로컬 모델(Ollama 사용) 또는 BYOK/커스텀 프로바이더를 통해 원격 모델 프로바이더에 연결하는 기능을 제공합니다. Raycast는 모델 선택기, AI 설정, 그리고 고급 사용자가 OpenAI-호환 백엔드를 추가하도록 커스터마이즈할 수 있는 providers.yaml 템플릿을 제공합니다.
Raycast는 2025년에 BYOK(Bring Your Own Key)와 커스텀 프로바이더를 순차적으로 도입하여, 사용자가 자신의 API 키와 커스텀 엔드포인트로 Raycast AI를 실행할 수 있게 했습니다(이는 비용 관리의 유연성과 비공개 프로바이더 옵션을 가능하게 합니다). 이 변경은 사용자 측 Raycast 환경설정에서 CometAPI를 통합 가능하게 만드는 기술적 토대입니다.
Raycast는 어떻게 사용자에게 AI를 제공하나요?
- Quick AI: 런처에서 즉시 프롬프트 실행.
- AI Chat: 첨부/컨텍스트를 포함한 대화형 세션.
- AI Commands/Extensions: LLM을 활용하는 개발자 제작 명령 또는 도구.
(Settings → AI에서 모델, BYOK 키, 커스텀 프로바이더를 관리할 수 있습니다.)
CometAPI란?
CometAPI는 단일 OpenAI 스타일의 REST 인터페이스를 통해 다양한 AI 모델(텍스트, 이미지, 오디오, 비디오, 임베딩)을 노출하는 API 통합 플랫폼입니다. OpenAI, Anthropic, Google, Midjourney, Runway 등 각 프로바이더별 클라이언트 코드를 작성하고 유지하는 대신, CometAPI 엔드포인트를 호출하고 모델 문자열로 원하는 모델을 선택하면 됩니다. 이 단순화는 실험, 비용/장애 조치 라우팅, 결제와 관측의 중앙화에 매우 유용합니다.
핵심 기능
- 텍스트/채팅 컴플리션과 어시스턴트(OpenAI 유사 채팅 API).
- 이미지 생성 및 이미지 편집 엔드포인트.
- 시맨틱 검색/RAG(검색 증강 생성)를 위한 임베딩.
- 오디오(TTS 및 STT; 기반 모델이 제공하는 경우).
- 특화된 백엔드를 위한 비디오 생성(Sora, Veo 등).
CometAPI는 SDK 스니펫과 OpenAI 스타일의 요청 포맷도 제공하므로 기존 코드를 손쉽게 이식할 수 있습니다.
지금 중요한 이유: 시장이 게이트웨이 API(편리한 단일 엔드포인트, 더 저렴한 옵션, 모델 선택)로 이동하고 있습니다. CometAPI는 이 영역의 상용 플레이어 중 하나이므로, Raycast의 커스텀 프로바이더 지원과 결합하면 macOS 워크플로에서 즉시 폭넓은 모델 카탈로그에 접근할 수 있습니다.
왜 Raycast에 CometAPI를 통합하나요?
짧은 답: Raycast AI 플로우(Quick AI, AI Chat, 커스텀 AI 명령) 안에서 CometAPI가 제공하는 어떤 모델이든, 도구를 바꾸지 않고 바로 실행하기 위해서입니다.
이점:
- 요약, 코드, 임베딩, 이미지 생성 등 작업별로 더 저렴하고 빠르거나 특화된 모델을 Raycast 안에서 사용할 수 있습니다.
- CometAPI를 통해 결제와 스로틀링을 중앙화하면서 모델 선택은 Raycast에서 제어할 수 있습니다.
- 최소한의 코드 변경: Raycast는 OpenAI-호환 커스텀 프로바이더와 BYOK를 지원하므로, 보통
base_url과 API 키만 바꿔도 CometAPI를 연결할 수 있습니다.
(이 기능은 Raycast가 커스텀 프로바이더와 BYOK를 지원하고, CometAPI가 https://api.cometapi.com/v1에서 OpenAI-호환 엔드포인트를 제공하기 때문에 가능합니다.)
이 통합의 좋은 활용 사례는?
- 개발자 도우미: 코드 설명, 리팩터링 제안, 단위 테스트 생성, PR 요약 — Raycast에서 호출해 인라인으로 답변을 받습니다.
- 노트와 요약: 텍스트를 선택하고, CometAPI 요약 모델을 사용하는 Raycast 명령으로 요약이나 액션 아이템 추출을 실행합니다.
- 문서 작성: Raycast AI 명령으로 함수 문서나 README 스니펫을 생성하고 로컬에서 반복을 이어갑니다.
- 이미지/멀티미디어 생성: CometAPI가 이미지 엔드포인트를 노출한다면, 이미지 엔드포인트를 호출하는 Raycast 확장(예: "프롬프트로 이미지 생성")을 사용할 수 있어 빠른 목업에 유용합니다.
- 임베딩 + 시맨틱 검색: CometAPI 임베딩으로 로컬 검색 워크플로를 강화하세요 — Raycast는 프론트엔드가 되어, 작은 로컬 스크립트나 클라우드 함수로 임베딩 인덱스를 조회할 수 있습니다.
어떤 환경과 조건을 준비해야 하나요?
시작하기 전에 다음을 준비하세요:
System & Raycast
- macOS(Raycast는 macOS 네이티브).
- Raycast가 설치되어 있어야 합니다. 커스텀 프로바이더/BYOK를 지원하는 최신 버전을 권장합니다(Raycast는 v1.100.0에서 BYOK를 추가했고 커스텀 프로바이더를 계속 출시 중). Raycast가 오래되었다면 업데이트하세요.
Accounts & keys
- CometAPI 계정과 유효한 CometAPI API 키(Raycast 설정이나 환경 변수에서 사용). CometAPI 대시보드/문서를 참조하세요.
선택 사항: 개발 도구(테스트 및 로컬 개발용)
- 터미널(cURL용).
- Python / Node / OpenAI SDK(CometAPI 접근을 Raycast에 연결하기 전에 직접 테스트하려는 경우). CometAPI는
base_url만 재정의하면 표준 SDK로 바로 사용할 수 있습니다.
권한과 네트워킹
- Raycast와 macOS 네트워크 정책이
api.cometapi.com으로의 HTTPS 호출을 허용하는지 확인하세요. - 기업 환경의 프록시/방화벽을 사용하는 경우
api.cometapi.com에 접근 가능한지 검증하세요.
로컬 파일과 위치
Raycast의 AI 프로바이더 구성은 Raycast 설정 디렉터리의 providers.yaml에 있습니다(앱이 템플릿을 표시해 복사할 수 있습니다). 커스텀 프로바이더를 정의하려면 providers.yaml을 편집하거나 생성합니다.
Raycast에 CometAPI를 어떻게 통합하나요?
핵심 아이디어: Raycast에 OpenAI-호환 커스텀 프로바이더로 CometAPI를 등록하고, Raycast를 https://api.cometapi.com/v1로 지정한 뒤, Raycast의 커스텀 API 키에 Comet 토큰을 추가합니다.
Step 1: CometAPI 키 받기
- CometAPI에 가입하고 콘솔/대시보드를 엽니다.
- API 토큰을 생성하세요. 이 토큰을 안전한 곳에 복사해 두세요(또는 다음 단계에서 사용할 준비를 합니다).
Step 2: Raycast의 AI 설정을 열고 커스텀 프로바이더를 활성화
- Raycast에서:
Preferences→AI. - “Custom Providers”(또는 “Custom OpenAI-compatible APIs”)를 찾아 Reveal Providers Config를 클릭합니다. Raycast가 설정 디렉터리를 Finder에서 열고 템플릿 파일(보통
providers.template.yaml)을 제공합니다. 이 파일을 복사해providers.yaml로 이름을 바꿉니다.
Step 3: providers.yaml에 CometAPI 프로바이더 추가
providers.yaml 파일을 생성하거나 편집합니다. Raycast가 요구하는 정확한 스키마는 버전에 따라 달라질 수 있지만, 커뮤니티 템플릿과 Raycast 매뉴얼에는 공통 구조가 나와 있습니다: id, name, base_url, 선택적 models 블록을 가진 프로바이더 항목 목록입니다. 아래는 CometAPI를 등록하기 위한 안전하고 동작하는 예시로, OpenAI-co
중요한 참고사항
YOUR_COMETAPI_KEY는 안전한 방식으로 대체하세요 — 개인용이라면 토큰을 직접 붙여넣을 수 있지만, 가능하면 macOS 키체인 / Raycast의 보안 필드가 지원된다면 이를 사용하세요.- 중요한 줄은
base_url입니다: https://api.cometapi.com/v1로 지정하세요. Raycast는 OpenAI-호환 호출에 이 베이스 URL을 사용합니다. - 모든 모델을 사전에 나열할 필요는 없습니다 — 프로바이더가 OpenAI 스타일의
GET /v1/models엔드포인트를 노출한다면 Raycast가 모델 목록을 가져올 수 있습니다. CometAPI가 모델 목록을 제공한다면, Raycast가 새로고침하여 사용 가능한 모델을 표시할 수 있습니다.
Step 4: 모델 새로고침 및 테스트
- Raycast로 돌아가서, 앱을 재시작하거나(버전에 따라) “Refresh Models” 명령을 사용해 새 프로바이더에서 모델을 가져오고 모델 선택기를 채워야 할 수 있습니다. 모델이 표시되지 않으면 새로고침하거나 재시작하세요.
- 간단한 Quick AI 프롬프트를 사용해 모델 선택기에서 CometAPI의 모델을 선택하고 테스트 프롬프트를 실행해 보세요.
Raycast에서 CometAPI를 사용할 때의 모범 사례
보안 모범 사례: 공유된 providers.yaml에 토큰을 하드코딩하지 마세요. Raycast의 보안 필드나 macOS 키체인을 사용하거나, 로컬 프록시를 사용하는 경우 환경 변수로 키를 주입하세요. 민감한 데이터가 있다면 CometAPI와 Raycast의 개인정보 문서를 읽어보세요.
신뢰성과 성능: 사용할 모델의 지연 시간을 테스트하세요 — 게이트웨이 API는 라우팅에 따라 변동이 있을 수 있습니다. 인터랙티브 워크플로(자동 요약, 빠른 조회)에는 더 작고 빠른 모델을, 더 깊은 추론 작업에는 더 큰 컨텍스트 모델을 선택하세요.
비용 관리: 모델 선택을 적극적으로 활용하세요: 짧은 작업에는 경량 모델, 깊은 추론에는 고성능 모델을 선택합니다. CometAPI 대시보드에서 사용량을 추적하고 예산 알림을 설정하세요. 시스템 메시지를 줄이거나 컨텍스트 관리를 효율화하는 등 프로그램적 프롬프트로 토큰 사용을 줄이는 것도 고려하세요.
프롬프트 엔지니어링 & UX: Raycast AI Commands를 만들 때(기본 명령을 복제해 프롬프트 조정), 유틸리티 명령(요약, 분류, 검색)은 프롬프트를 결정적으로 유지하고, 아이디에이션 워크플로는 더 개방적으로 구성하세요. 기본 제공 명령을 복사하고 프롬프트를 커스터마이즈하는 방식을 권장합니다.
흔한 문제를 어떻게 트러블슈팅하나요?
모델이 Raycast에 표시되지 않음: Reveal Providers Config가 열어준 정확한 폴더에 providers.yaml이 있는지 확인하세요. 템플릿을 기준으로 삼고 Raycast를 재시작하세요. 재시작 또는 “Refresh Models”가 도움이 됩니다.
401 / invalid token: CometAPI 토큰이 유효하고 만료되지 않았는지 확인하세요. 위의 curl 테스트를 시도해 보세요. Bearer 토큰을 사용했는지, Authorization 헤더가 올바른지 재확인하세요.
모델 오류 또는 비호환 응답 형태: CometAPI는 OpenAI-호환을 목표로 하지만 일부 엣지 케이스(모델 ID, 스트리밍 동작)가 있을 수 있습니다. Raycast가 특정 스트리밍 포맷을 기대하는데 CometAPI가 약간 다른 형태를 내보낸다면, 먼저 비스트리밍 호출로 시도해 보고 필요하면 CometAPI 지원팀에 문의하세요.
결론
CometAPI는 다양한 모델(텍스트, 이미지, 오디오, 비디오)에 대한 통합된 멀티 벤더 접근을 제공하고, 팀이 결제와 라우팅을 중앙화할 수 있게 합니다. Raycast는 데스크톱 워크플로의 컨텍스트에서 이러한 모델을 즉시, 키보드 중심으로 호출할 수 있는 장소를 제공합니다. 함께 사용하면 모델 실험과 데스크톱 자동화가 무척 매끄러워집니다 — 비용이나 품질에 따라 모델을 바꿔 쓸 수 있고, 키를 로컬에 유지하며, 이미 스크립트와 앱에서 사용 중인 친숙한 OpenAI 스타일 패턴을 그대로 활용할 수 있습니다.
바로 시작해 보려면 CometAPI의 Playground에서 모델(예: Gemini 3 Pro Preview API 등)의 기능을 살펴보고, 자세한 지침은 API 가이드를 참고하세요. 접근 전에 CometAPI에 로그인하고 API 키를 발급받았는지 확인하세요. CometAPI는 통합을 돕기 위해 공식 가격보다 훨씬 낮은 가격을 제공합니다.
Ready to Go?→ use CometAPI in Raycast today !
