Raycast 的 AI 功能現在允許你透過 providers.yaml 自訂供應商接入任何與 OpenAI 相容的供應商。CometAPI 是一個閘道 API，透過 OpenAI 風格的 REST 介面匯聚數百種模型——因此你可以將 Raycast 指向 https://api.cometapi.com/v1，加入你的 CometAPI 金鑰，並在 Raycast AI（聊天、命令、擴充）中使用 CometAPI 模型。
什麼是 Raycast？
Raycast 是一款面向 macOS 的效率啟動器，將指令、腳本以及（愈來愈多的）AI 直接整合到作業系統中。其 AI 子系統提供聊天、AI 命令、模型選擇、擴充（讓 LLM 執行動作的工具），以及使用本地模型（透過 Ollama）或自帶金鑰/BYOK / 自訂供應商連接遠端模型供應商的能力。Raycast 提供模型選擇器、AI 設定以及一個 providers.yaml 範本，高階使用者可以自訂以新增與 OpenAI 相容的後端。
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 是一個 API 聚合平台，透過單一、OpenAI 風格的 REST 介面，提供數百種不同的 AI 模型（文字、影像、音訊、影片、Embeddings）。你無需為 OpenAI、Anthropic、Google、Midjourney、Runway 等各家供應商撰寫並維護特定用戶端程式碼，只要呼叫 CometAPI 的端點，並透過模型字串選擇想用的模型即可。這種簡化對實驗、成本/故障切換路由，以及費用與可觀測性的集中化非常有利。
主要能力
- 文字/聊天補全與助理（類 OpenAI 的聊天 API）。
- 影像生成與影像編輯端點。
- 用於語意搜尋/RAG（檢索增強生成）的 Embeddings。
- 音訊（當底層模型提供時的 TTS 與 STT）。
- 針對專用後端（Sora、Veo 等）的影片生成。
CometAPI 也提供 SDK 範例片段與 OpenAI 風格的請求格式，便於直接移植既有程式碼。
為何現在特別重要： 市場正轉向閘道式 API（便利的單一端點、更便宜的選項與模型選擇）。CometAPI 是此領域的商業方案之一，因此結合 Raycast 的自訂供應商支援，可讓你從 macOS 工作流程中即時取得廣泛的模型目錄。
為何要將 CometAPI 與 Raycast 整合？
簡短回答：讓你不必切換工具，即可在 Raycast AI 的流程中（Quick AI、AI Chat 或自訂 AI 命令）直接使用 CometAPI 所提供的任何模型。
好處：
- 在 Raycast 內部就能依任務（摘要、程式碼、Embeddings、影像生成）使用更便宜/更快或更專門的模型。
- 透過 CometAPI 集中計費與節流，同時在 Raycast 控制模型選擇。
- 幾乎不需改動程式碼：Raycast 支援與 OpenAI 相容的自訂供應商與 BYOK，因此通常只要替換
base_url與 API 金鑰即可接上 CometAPI。
（上述能力之所以可行，是因為 Raycast 支援自訂供應商與 BYOK，而 CometAPI 在 https://api.cometapi.com/v1. 提供與 OpenAI 相容的端點。）
這項整合有哪些理想用例？
- 開發者助理： 程式碼解說、重構建議、單元測試產生、PR 摘要——從 Raycast 呼叫並得到即時答案。
- 筆記與摘要： 選取文字，執行 Raycast 命令，以 CometAPI 的摘要模型進行摘要或擷取行動項目。
- 文件撰寫： 透過 Raycast AI 命令產生函式文件或 README 片段，並在本機快速反覆修訂。
- 影像/多媒體生成： 若 CometAPI 提供影像端點，你可以使用呼叫影像端點的 Raycast 擴充（如「根據提示生成影像」擴充），用於快速產生樣稿。
- Embeddings + 語意搜尋： 使用 CometAPI 的 Embeddings 來驅動本地搜尋流程——Raycast 可作為前端，透過小型本地腳本或雲函式查詢你的索引。
需要準備哪些環境與條件？
開始前，請準備好以下內容：
系統與 Raycast
- macOS（Raycast 原生支援 macOS）。
- 已安裝 Raycast。建議使用支援自訂供應商/BYOK 的新版本（Raycast 自 v1.100.0 起加入 BYOK，並持續推出自訂供應商）。若你的 Raycast 過舊，請更新。
帳戶與金鑰
- CometAPI 帳戶與有效的 CometAPI API 金鑰（你將在 Raycast 設定或環境變數中使用）。請參考 CometAPI 儀表板/文件。
選用的開發者工具（測試或本地開發）
- 終端機（用於 cURL）。
- 若想在接入 Raycast 前直接測試 CometAPI 存取，可使用 Python / Node / OpenAI SDK。CometAPI 支援透過覆寫
base_url直接使用標準 SDK。
權限與網路
- 確保 Raycast 與你的 macOS 網路策略允許對
api.cometapi.com發出 HTTPS 呼叫。 - 若在企業環境使用代理/防火牆，請確認可連通
api.cometapi.com。
本地檔案與位置
Raycast 的 AI 供應商設定位於 Raycast 設定目錄下的 providers.yaml。你將編輯或建立 providers.yaml 來定義自訂供應商。
如何將 Raycast 與 CometAPI 整合？
核心想法：在 Raycast 中註冊 CometAPI 為與 OpenAI 相容的自訂供應商，將 Raycast 指向 https://api.cometapi.com/v1，並將你的 Comet 金鑰加入 Raycast 的自訂 API 金鑰中。
步驟 1：取得你的 CometAPI 金鑰
步驟 2：開啟 Raycast 的 AI 設定並啟用自訂供應商
- 在 Raycast 中：
Preferences→AI。 - 找到「Custom Providers」（或「Custom OpenAI-compatible APIs」）並點擊 Reveal Providers Config。Raycast 會在 Finder 中開啟設定目錄，並提供範本檔（通常為
providers.template.yaml），將其複製並更名為providers.yaml。
步驟 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 可以重新整理並顯示可用模型。
步驟 4：重新整理模型並測試
- 回到 Raycast，你可能需要重新啟動應用程式，或使用「Refresh Models」指令（依版本而定）讓 Raycast 從新供應商擷取模型並填入模型選擇器。若沒有看到模型，建議重新整理或重啟。
- 使用一個簡單的 Quick AI 提示，從模型選擇器挑選 CometAPI 的模型並執行測試提示。
在 Raycast 中使用 CometAPI 的最佳實踐
安全性最佳實踐： 永遠不要在共用的 providers.yaml 中硬編碼令牌。優先使用 Raycast 的安全欄位或 macOS 鑰匙圈；若使用本地代理，可透過環境變數注入金鑰。若涉及敏感資料，請閱讀 CometAPI 與 Raycast 的隱私文件。
可靠性與效能： 請測試延遲以符合你預期使用的模型——閘道 API 的路由延遲可能不同。互動式工作流程（自動摘要、快速查詢）建議選用較小、較快的模型；較深入的推理任務則選擇高上下文容量的模型。
成本控管： 積極運用模型選擇：短任務用輕量模型，重推理任務用高容量模型。於 CometAPI 儀表板追蹤用量並設置預算提醒。考慮以程式化提示降低 Token 使用量（例如更短的系統訊息、高效率的上下文管理）。
提示工程與體驗： 在建立 Raycast AI 命令時（複製內建命令並調整提示），對常用工具型命令（摘要、分流、搜尋）保持提示的確定性；對構想發散類工作流程則可更開放。建議複製內建命令並自訂提示。
如何排查常見問題？
Raycast 中沒有顯示模型： 確保 providers.yaml 置於「Reveal Providers Config」開啟的確切資料夾。以範本為基礎並重新啟動 Raycast。重啟或使用「Refresh Models」通常有效。
401 / 無效令牌： 確認你的 CometAPI 令牌有效且未過期。嘗試上述 curl 測試。再次檢查是否使用了 Bearer 令牌，以及 Authorization 標頭正確。
模型錯誤或回應格式不相容： CometAPI 目標是與 OpenAI 相容，但某些邊界情況可能存在（模型 ID、串流行為）。若 Raycast 期望特定的串流格式而 CometAPI 輸出稍有差異，先嘗試非串流呼叫，必要時聯繫 CometAPI 支援。
結論
CometAPI 讓你透過單一介面取得多家供應商的多種模型（文字、影像、音訊、影片），並讓團隊集中化計費與路由。Raycast 則提供在桌面工作流程中以鍵盤為主的即時呼叫位置。兩者結合能讓模型試驗與桌面自動化更順暢——你可以依成本或品質切換模型、將金鑰保留在本地，並沿用你在腳本與應用中熟悉的 OpenAI 風格模式。
如果你想立刻嘗試，歡迎在 Playground 探索 CometAPI 的模型能力（例如 Gemini 3 Pro Preview API 等），並參考 API 指南以取得詳細說明。存取前，請先登入 CometAPI 並取得 API 金鑰。CometAPI 提供遠低於官方的價格，協助你快速整合。
準備好了嗎？→ use CometAPI in Raycast today ！