跳到主要内容

常见问题

这里整理接入、计费、模型、工具配置和稳定性相关的高频问题。

接入问题​

Base URL 应该填什么？​

OpenAI 兼容工具通常填写：

https://www.tophdd.cn/v1

Anthropic 或 Gemini 原生协议工具有时会自动拼接路径，需要根据工具说明填写 https://www.tophdd.cn 或 https://www.tophdd.cn/v1。如果出现 404，优先检查是否重复拼接了 /v1。

API Key 放在哪里？​

本地命令行工具通常放在环境变量里；桌面客户端一般放在 Provider 设置中；生产服务应放在服务器环境变量或密钥管理服务中。不要把 Key 写进前端代码、公开仓库或截图。

为什么控制台没有请求日志？​

常见原因：

  • 工具没有使用鼎惠API 的 Base URL。
  • 环境变量没有被当前终端读取。
  • 客户端请求还没发出就在本地报错。
  • 浏览器或插件使用了旧配置。

模型问题​

模型 ID 在哪里看？​

打开 模型广场 查看。请求时填写模型 ID，不要填写展示名。

为什么提示模型不存在？​

可能是：

  • 模型 ID 拼写错误。
  • 当前 API Key 没有这个模型的权限。
  • 模型已下线或被替换。
  • 工具协议与模型不匹配。

Claude 模型能不能放到 OpenAI Compatible 工具里？​

取决于工具和平台兼容情况。部分工具只支持 OpenAI 协议，即使能填 Claude 模型，也可能失去原生缓存、工具调用或消息格式能力。需要 Claude 原生能力时，优先使用 Claude Code 或支持 Anthropic 协议的客户端。

计费问题​

为什么一次 Agent 任务费用比聊天高？​

Agent 工具会自动读取文件、分析上下文、修改代码、运行命令并重试。每一步都可能产生模型请求，Token 消耗通常高于普通聊天。

如何控制成本？​

  • 给每个工具单独创建 API Key。
  • 设置额度上限和模型白名单。
  • 降低并发和自动重试次数。
  • 明确任务范围，减少无关文件。
  • 定期查看 Usage 明细。

失败请求会不会计费？​

是否计费取决于请求是否已经到达模型并产生 Token。网络层完全失败通常不会产生模型费用；模型已经返回错误或部分输出时，可能会有消耗。以控制台明细为准。

工具配置问题​

Cline 填哪个 Provider？​

选择 OpenAI Compatible，Base URL 填 https://www.tophdd.cn/v1。

Codex CLI 用哪个环境变量？​

Codex 通常使用 OPENAI_API_KEY，并在 ~/.codex/config.toml 中配置自定义 Provider 和 Base URL。详见 Codex CLI（Windows） 和 Codex CLI（Mac/Linux）。

Kimi Code 如何接入？​

使用 KIMI_MODEL_* 环境变量配置 OpenAI 兼容模型。详见 Kimi Code 命令行。

稳定性问题​

偶发 5xx 怎么办？​

建议增加超时、重试和降级策略。生产服务不要无限重试，应限制重试次数并记录请求 ID。

429 是什么？​

429 表示频率、并发或额度限制。降低并发、拉长请求间隔，或检查 Key 的额度配置。

如何定位慢请求？​

查看请求日志中的模型、输入 Token、输出 Token 和耗时。长上下文、图像任务、复杂推理通常更慢。