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）或自带密钥/自定义提供商连接远程模型提供商。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 模型（文本、图像、音频、视频、嵌入）。你无需为 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，因此 CometAPI 通常只需替换
base_url与 API 密钥即可接入。
（这些能力之所以可行，是因为 Raycast 支持自定义提供商与 BYOK，而 CometAPI 在 https://api.cometapi.com/v1 暴露与 OpenAI 兼容的端点。）
这个集成有哪些良好用例？
- 开发者助手：代码解释、重构建议、单元测试生成与 PR 摘要——在 Raycast 中调用并获得内联答案。
- 笔记与摘要：选择文本，运行 Raycast 命令，用 CometAPI 的摘要模型进行总结或提取行动项。
- 文档撰写：通过 Raycast AI 命令生成函数文档或 README 片段，并在本地迭代。
- 图像/多媒体生成：如果 CometAPI 暴露图像端点，你可以使用调用图像端点的 Raycast 扩展（例如“根据提示生成图像”扩展）——用于快速原型。
- 嵌入与语义搜索：使用 CometAPI 的嵌入向量为本地搜索工作流赋能——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，并在 Raycast 的自定义 API 密钥中添加你的 Comet 令牌。
步骤 1：获取你的 CometAPI 密钥
- 在 CometAPI 注册并打开控制台/仪表板。
- 创建一个 API 令牌。将此令牌妥善保存（或用于下一步）。
步骤 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 所需的确切 schema 会因版本而异，但社区模板与 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 兼容的调用。- 你不必预先列出所有模型——如果你的提供商暴露了符合 OpenAI 风格的
GET /v1/models端点，Raycast 可以从中获取并显示可用模型。如果 CometAPI 暴露模型列表，Raycast 可以刷新并展示。
步骤 4：刷新模型并测试
- 返回 Raycast 后，你可能需要重启应用或使用“刷新模型”命令（取决于版本），以便 Raycast 从新提供商获取模型并填充模型选择器。如果模型未出现，建议刷新或重启。
- 使用一个简单的 Quick AI 提示，从模型选择器中选择 CometAPI 的模型并运行测试提示。
在 Raycast 中使用 CometAPI 的最佳实践
安全最佳实践：切勿在共享的 providers.yaml 中硬编码令牌。优先使用 Raycast 的安全字段或 macOS Keychain；如果你使用本地代理，可通过环境变量注入密钥。若处理敏感数据，请阅读 CometAPI 与 Raycast 的隐私文档。
可靠性与性能：测试你计划使用的模型的延迟——网关 API 可能存在可变路由。对于交互式工作流（自动摘要、快速查找），优选更小、更快的模型；对于更深度的推理任务，选择更高上下文的模型。
成本控制：积极使用模型选择：短任务选择轻量模型，重推理选择高容量模型。在 CometAPI 仪表板跟踪用量并设置预算提醒。考虑通过程序化提示降低 token 使用（例如更短的系统消息、高效的上下文管理）。
提示工程与用户体验：在制作 Raycast AI 命令（复制内置命令并微调提示）时，对实用型命令（摘要、分拣、搜索）保持提示的确定性，而对创意型工作流更开放。推荐复制内置命令并自定义提示。
如何排查常见问题？
模型未在 Raycast 中显示：确保 providers.yaml 位于由“Reveal Providers Config”打开的精确文件夹内。以模板为基线，并重启 Raycast。重启或“刷新模型”会有所帮助。
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 提供远低于官方价格的方案，帮助你集成。
Ready to Go?→ 今天就在 Raycast 中使用 CometAPI！