docs

CLI 与 API 的差异

解释 CLI 和 API 的区别，以及为什么不能混用

ziyang

— 4 min read

CLI 与 API 的差异

你可能注意到，我们同时提供 CLI 端点和 API 端点。这篇文章解释它们的区别，以及为什么需要在正确的场景使用正确的端点12。

核心区别

CLI 和 API 是完全不同的接口

虽然都是调用同一个模型（比如 Gemini），但 CLI 和 API 走的是完全不同的通道：

CLI 工具（如 Gemini CLI）  → CLI 专用接口 → 模型
API 调用（如 Cherry Studio）→ 标准 API 接口 → 模型

这两种接口的请求格式、响应格式、参数结构都不一样。

为什么不能混用？

如果在 CLI 工具里使用 API 端点，或者在 API 客户端里使用 CLI 端点，会导致： - 同样的模型，表现出不同的能力 - 部分功能无法正常工作 - 出现难以排查的奇怪问题

这是因为：

特性 CLI 接口 API 接口
系统提示词 预置了针对编程场景的提示词 无预置，完全由调用方控制
请求格式 CLI 工具专用格式 标准 API 格式
响应处理 针对终端优化 标准 JSON 响应
上下文处理 针对代码编辑优化 通用对话格式

正确的使用方式

CLI 端点：用于编程工具

CLI 端点只应该在对应的命令行工具中使用：

工具 使用的端点
Claude Code Claude CLI 端点
Gemini CLI Gemini CLI 端点
Codex CLI OpenAI CLI 端点

这些工具内部会使用正确的请求格式与 CLI 接口通信。

API 端点：用于通用客户端

API 端点用于标准的 API 调用场景：

场景 使用的端点
Cherry Studio Gemini API 端点
自定义应用开发 对应模型的 API 端点
第三方集成 对应模型的 API 端点

价格差异

由于 CLI 和 API 是不同的渠道，它们的价格也可能不同：

  • 渠道成本不同 — 厂商对 CLI 和 API 有不同的定价策略
  • 配额限制不同 — QPM（每分钟请求数）和 TPM（每分钟 Token 数）可能不同

具体价格请参考 [价格页面](https://aicodewith.com/pricing)，价格可能随官方调整而变化。

关于价格变动

价格调整主要有以下原因：

  1. 官方调价 — 当 Google、Anthropic、OpenAI 调整定价时，我们会相应更新
  2. 渠道成本变化 — 部分低价渠道基于逆向订阅等方式实现，如果官方加强封控，渠道成本上升，价格也需要相应调整

价格调整并非平台主观行为，而是上游成本变化的如实反映。我们会尽力维持稳定的价格，但当成本确实上涨时，调价实属无奈。

常见问题

Q: 我在 Gemini CLI 里用了 API 地址，为什么感觉模型变笨了？

因为 API 接口没有 CLI 接口预置的编程优化提示词，模型在代码场景下的表现会有细微差别。请使用正确的 CLI 端点。

Q: 可以用 CLI 端点来做 API 开发吗？

不建议。CLI 端点的请求/响应格式是为命令行工具设计的，直接用于 API 开发会遇到兼容性问题。

Q: 为什么不统一成一个端点？

参见 为什么不做 API 格式转换。简单来说，强行转换会丢失功能、改变模型行为，无法保证与官方一致的体验。

Q: 我的使用量会合并计算吗？

CLI 和 API 的使用量分开计算，各自独立消耗额度。但你的账户余额是共享的。

总结

  • CLI 端点 → 只在对应的 CLI 工具中使用（Claude Code、Gemini CLI、Codex）
  • API 端点 → 用于 Cherry Studio、自定义开发等 API 调用场景
  • 不要混用 → 混用会导致模型能力表现异常

选择正确的端点，才能获得最佳体验。

相关阅读

Read more