开发者常见问题

适用角色：开发者更新日期：2026-07-02

本文是开发者高频问题的索引，每个问题指向详细文档。

一、接入与认证

Q：Base URL 填什么？https://api.cloudrouter.online/v1，见 API 调用基础

Q：API Key 在哪创建/怎么拿？ 组织与子用户均可在控制台「API 密钥」页创建 Key；子用户建 Key 时路由分组限组织授权范围，见快速开始

Q：401 报错？ 检查 Authorization: Bearer 头格式，见错误码与排障

Q：model 字段到底写什么？ 去控制台「调用指南」复制调用名，裸名或带指纹均可，见调用指南与双路由

Q：裸名和带指纹有什么区别？ 裸名走这把 Key 绑定的路由分组，带指纹点名到指定分组，见调用指南与双路由

Q：为什么调不到某个模型？ 调用名写错，或该分组不在你账户的可用范围内（由平台按组织配置），确认可用范围或去调用指南复制

Q：OpenAI 格式和 Anthropic 格式有什么区别？ 见 API 调用基础第五节

Q：怎么切换模型？ 改 model 字段，见 API 调用基础

Q：怎么算钱？谁扣费？ 按实际命中的分组/渠道定价（以「模型广场」或控制台「购买」页为准）；真实扣费始终扣所属组织的余额

Q：带指纹和裸名计费有区别吗？ 与调用名写法无关，按最终走到的分组/渠道计价，见调用指南与双路由

Q：429 限流怎么办？ 降低并发、指数退避；区分限额（API_KEY_RATE_*，等窗口重置）与配额/并发（具体码以接口实际返回为准），见错误码与排障

Q：并发上限多少？怎么提升？ 组织级并发上限由平台统一配置，找所属组织协调，如需调整请联系 CloudRouter

Q：502 怎么处理？ 模型供应商返回 5xx 时 CloudRouter 统一映射为 502，请用指数退避重试，见错误码与排障

Q：带指纹调用报"分组不可达"怎么办？ 分组不在可用范围或当前不可用，平台直接报错不降级，改用可用分组，见调用指南与双路由

Q：500 和 502 怎么区分？ 500 是平台自身故障，502 是模型供应商侧故障，见错误码与排障

Q：模型偶发输出韩文/日文？ 模型语言漂移，见 Claude 语言漂移说明