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 設定，以及一個可供進階使用者自訂以新增 OpenAI 相容後端的 providers.yaml 範本。
Raycast 自 2025 年起陸續推出 BYOK（Bring Your Own Key）與自訂提供者，讓使用者可以在 Raycast AI 中使用自己的 API 金鑰與自訂端點（更靈活地控管成本與私有供應選項）。這項變更是從使用者偏好設定層面，使得整合 CometAPI 成為可行 的技術基礎。
Raycast 如何向使用者呈現 AI？
- Quick AI：從啟動器即時輸入提示。
- AI Chat：帶附件/上下文的對話式會話。
- AI Commands/Extensions：開發者打造、使用 LLM 的指令或工具。
（你可以從 Settings → AI 管理模型、BYOK 金鑰與自訂提供者。）
什麼是 CometAPI？
CometAPI 是一個 API 聚合平台，透過單一、OpenAI 風格的 REST 介面，匯集數百種不同的 AI 模型（文字、影像、音訊、影片、嵌入）。你不需要為 OpenAI、Anthropic、Google、Midjourney、Runway 等不同供應商各自撰寫與維護客戶端；改為呼叫 CometAPI 的端點，並以一個模型字串選擇你要的模型。此簡化對於實驗、成本/故障切換路由，以及集中計費與可觀測性都很有幫助。
主要能力
- 文字/聊天補全與助理（類 OpenAI 的聊天 API）。
- 影像生成與影像編輯端點。
- 用於語義搜尋/RAG（檢索增強生成）的嵌入。
- 音訊（TTS 與 STT，取決於底層模型）。
- 面向專用後端的影片生成（Sora、Veo 等）。
CometAPI 也提供 SDK 範例與 OpenAI 風格的請求格式，便於你把現有程式碼直接移植過來。
為什麼這在此刻很重要：市場正朝向閘道 API 發展（便利的單一端點、更低成本與更多模型選擇）。CometAPI 是該領域的商業服務之一，搭配 Raycast 的自訂提供者支援，可讓你在 macOS 工作流程中立即取得廣泛的模型目錄。
為什麼要將 CometAPI 與 Raycast 整合？
簡短答案：讓你可直接從 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 觸發並取得回覆。
- 筆記與摘要： 選取文字，使用 Raycast 指令配合 CometAPI 的摘要模型進行摘要或提取待辦。
- 文件撰寫： 透過 Raycast 的 AI 指令產生函式文件或 README 片段，並在本機快速迭代。
- 影像/多媒體生成： 若 CometAPI 提供影像端點，你可以使用呼叫影像端點的 Raycast 擴充（例如「Generate Image from Prompt」擴充）——適合快速模型圖。
- 嵌入 + 語義搜尋： 使用 CometAPI 的嵌入來驅動本機搜尋工作流程——Raycast 可以作為前端，透過小型本機腳本或雲端函式查詢你的嵌入索引。
需要準備哪些環境與條件？
開始之前，請先準備好以下項目：
系統與 Raycast
- macOS（Raycast 為 macOS 原生）。
- 已安裝 Raycast。建議使用支援自訂提供者 / BYOK 的新版本（Raycast 自 v1.100.0 起加入 BYOK，並持續推出自訂提供者）。如果你的 Raycast 較舊，請更新。
帳號與金鑰
- CometAPI 帳號 與有效的 CometAPI API 金鑰（你會在 Raycast 設定或環境變數中使用）。請參閱 CometAPI 的儀表板/文件。
選用的開發工具（測試或本機開發）
- 終端機（用於 cURL）。
- 若想先直接測試 CometAPI，再接入 Raycast，可使用 Python / Node / OpenAI SDK。CometAPI 支援透過覆寫
base_url直接在標準 SDK 中使用。
權限與網路
- 確保 Raycast 與你的 macOS 網路策略允許對
api.cometapi.com的 HTTPS 呼叫。 - 若位於公司代理/防火牆環境，請確認
api.cometapi.com可達。
本機檔案與位置
Raycast 的 AI 提供者設定 位於 Raycast 設定目錄中的 providers.yaml（App 會提供可複製的提供者範本）。你需要編輯或建立 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 會以該基底 URL 發送 OpenAI 相容的呼叫。- 你不一定需要預先列出所有模型——若你的提供者有提供 OpenAI 風格的
GET /v1/models端點，Raycast 可以擷取並顯示模型清單。若 CometAPI 提供模型清單，Raycast 可以重新整理並顯示可用模型。
步驟 4：重新整理模型並測試
- 回到 Raycast，可能需要重新啟動 App 或使用「Refresh Models」指令（依版本而定），讓 Raycast 自新提供者擷取模型並填入模型選擇器。若未顯示模型，建議重新整理或重啟。
- 使用簡單的 Quick AI 提示，從模型選擇器挑選 CometAPI 的模型並執行測試提示。
在 Raycast 中使用 CometAPI 的最佳實務
安全性最佳實務： 切勿在共用的 providers.yaml 內硬編碼權杖。優先使用 Raycast 的安全欄位或 macOS 鑰匙圈；若使用本機代理，也可透過環境變數注入金鑰。若資料敏感，請閱讀 CometAPI 與 Raycast 的隱私文件。
可靠性與效能： 請先測試目標模型的延遲——閘道 API 的路由延遲可能較為變動。互動式工作流程（自動摘要、快速查詢）優先選擇較小、較快的模型；較深度推理任務則選擇高上下文模型。
成本控管： 積極運用模型選擇：短小任務選輕量模型，重推理選高階模型。於 CometAPI 儀表板追蹤用量並設定預算提醒。可透過程式化提示降低 token 使用（例如縮短 system 訊息、有效管理上下文）。
提示工程與使用者體驗： 建立 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 的 models's(Gemini 3 Pro Preview API 等) 能力，並參考 API 指南以取得詳細說明。存取前，請先登入 CometAPI 並取得 API 金鑰。CometAPI 提供遠低於官方的價格，協助你完成整合。
準備好了嗎？→ use CometAPI in Raycast today ！
