API 密钥和 AI CLI
连接托管提供商、本地 AI CLI 和 MCP 集成，无需将你的工作空间数据发送到 1MarketingTool 云端。
1MarketingTool 采用 BYOK 模式。你决定连接哪些提供商，应用使用你自己的 API 密钥或本地 AI CLI。
支持的 AI CLI
该应用可以与常见的本地 AI 命令行工具配合使用：
| CLI | 典型用途 |
|---|---|
| Claude Code CLI | 写作和分析任务 |
| Codex CLI | 编码、内容和图像生成工作流 |
| Gemini CLI | 内容和图像生成工作流 |
| OpenCode CLI | 通用本地代理工作流 |
| Kiro CLI | 本地代理工作流（在可用地区） |
| Hermes | 在 macOS、Windows 和 Linux 上原生检测；以一次性模式运行，用于内容生成、Prompt Explorer 对比和其他本地 AI 工作流，并支持按次选择模型 |
仅启用你实际使用的 CLI。如果某个 CLI 未安装，请保持禁用状态，直到它在你的设备上可用。
托管提供商
当工作流需要外部数据或你偏好的模型时，使用托管提供商：
- OpenAI、Claude、Gemini 或其他 AI 提供商用于内容生成。
- DataForSEO 用于关键词、SERP、外链和排名数据。
- Google Search Console 和分析服务用于网站效果数据。
- 社交渠道 API 用于定时发布。
在你自己的机器上运行的模型
你可以把 BYOK 路由指向在这台电脑或你局域网中运行的模型，而不是托管服务。凡是以 OpenAI 格式应答的服务器都可以使用，例如 LM Studio、Ollama 或 1LocalAITool；以 Anthropic 格式应答的服务器同样可以，1LocalAITool 也支持这种格式。
- 打开 Settings → AI，切换到 BYOK。
- 在 Gateways 下选择 Custom OpenAI-compatible；如果你的服务器使用 Anthropic 格式，则在 Protocols 下选择 Anthropic。
- 将 Base URL 设为本地服务器显示的地址，例如 LM Studio 为
http://localhost:1234/v1，Ollama 为http://localhost:11434/v1，并将 Model 设为服务器提供的模型 id。 - 在 API key 中随便填写一个值。该字段不能为空，但不校验密钥的本地服务器会接受任何值。
- 点击 Test connection，然后点击 Use as active。
在 CPU 或小型 GPU 上运行的模型写得较慢，因此 1MarketingTool 给本地 Base URL 最多十分钟的应答时间，而托管提供商只有 45 秒。这个更长的时限适用于以下主机：localhost, 127.x, 10.x, 192.168.x, 172.16–31.x, .local, Tailscale (100.64–127.x, .ts.net)。Custom OpenAI-compatible 从 1.5.0 起、Anthropic 从 1.5.1 起享有该时限，所以慢速本地模型生成的长篇活动或文章能够完成，而不会中途超时。
密钥存储
API 密钥和令牌应通过应用设置存储。发布令牌在操作系统支持的情况下通过系统钥匙串存储。避免将密钥粘贴到营销活动提示或内容字段中。
MCP 集成
1MarketingTool 通过一个名为 onemarketingtool 的本地 MCP 服务器开放 rank、keyword、content、video 和 browser 工具。当你想让兼容的 AI 客户端在本机访问应用自身的工作流时使用它——见 MCP 集成。
故障排除
如果提供商连接失败，请在日志或相关设置页面中查看具体错误。大多数故障是由缺少 API 权限、令牌过期或 CLI 不在系统路径中引起的。