常见问题
关于 KOPRouter 账号、Key、模型、计费与接口的常见问题。
登录控制台后,进入「密钥管理」页面,点击「新建」即可生成一把以 `sk-` 开头的 API Key。请妥善保存,Key 仅创建时完整显示一次。
多数 OpenAI 兼容工具填 `/v1`;Claude Code 等 Anthropic 兼容工具填根地址 ``,SDK 会自动追加 `/v1/messages`。
调用 `/v1/models`,响应中的 `id` 列表就是你可用的模型。调用时 `model` 字段直接填这些 `id`。
文本按输入 / 输出 token、图像按张、语音合成按字符、视频按完成结果、部分接口按次计费。金额以微美元存储,仅成功请求才结算。
通常是 API Key 缺失或无效。确认请求带 `Authorization: Bearer sk-...` 头,Key 完整且未被禁用。
余额不足。前往控制台充值,或等待订阅额度刷新后重试。
触发限流。降低请求频率或并发,采用指数退避重试。
若请求卡住、`Connection reset` 或 DNS 解析失败,通常是所在网络(如中国大陆)无法直连 KOPRouter,需要先配置 VPN 或代理。配置方法见「网络与代理配置」:macOS 写入 `~/.zshrc`、Linux 写入 `~/.bashrc`、Windows 用 `setx`,或直接开启系统代理(TUN / 全局模式)。
支持。对话补全、文本补全、Responses 等接口设置 `stream: true` 即可通过 SSE 流式返回。