常见问题

这里整理 678API 使用过程中最常见的问题。

为什么我的客户端请求失败？#

请检查 Base URL 是否为 https://www.678api.com/v1，API Key 是否正确，账户是否有可用余额或订阅额度。

余额和订阅哪个先扣？#

系统会根据账户计费偏好和可用额度选择扣费来源。通常有可用订阅时优先使用订阅额度。

支持哪些充值方式？#

在线充值支持结账页显示的微信支付、支付宝、Visa 等银行卡、Apple Pay 和 Google Pay，同时也支持兑换码充值。实际可用方式会因地区、币种、设备和浏览器而不同。

支持哪些客户端？#

支持能够配置 OpenAI Compatible Base URL、API Key 和模型 ID 的客户端，包括 Cursor、Cherry Studio、Chatbox、Open WebUI、Claude Code、Codex CLI、CC Switch 以及常见 SDK。某些客户端的专用补全或内置 Agent 功能可能仍使用其官方服务。

接入 678API 需要退出工具原来的账号吗？#

通常不需要。工具账号负责同步、订阅或编辑器功能，678API API Key 负责自定义模型请求。只需在模型或 Provider 设置中选择 678API；只有客户端明确要求重新认证时才需要退出。

Base URL 到底填哪个？#

OpenAI Compatible 客户端通常填写 https://www.678api.com/v1。Claude Code 的 Anthropic 网关变量填写 https://www.678api.com。只有字段明确写着完整 Endpoint 时，才追加 /chat/completions。

为什么模型列表为空，但 Key 没报错？#

部分客户端不会读取兼容接口的模型列表，或者会过滤不认识的模型。请从 678API 控制台复制完整模型 ID 并手动添加。

怎样确认请求确实走了 678API？#

使用专门创建的客户端 API Key 发一条短消息，然后在 678API 用量日志中按时间和 Key 核对请求。仅看客户端显示的模型名称并不可靠。

怎样恢复工具原来的官方模型？#

切回内置 Provider，并停用自定义 Base URL 或 678API Provider；CLI 用户还要删除或取消对应环境变量，然后重启终端或客户端。