开发者常见问题
适用角色：开发者 更新日期：2026-07-14
本文是开发者高频问题的索引，每个问题指向详细文档。
一、接入与认证
Q：Base URL 填什么？
YOUR_API_BASE_URL，见 API 调用基础
Q：API Key 在哪创建/怎么拿？ 主用户与子用户均可在控制台「API 密钥」页创建 Key；子用户建 Key 时路由分组限主用户授权范围，见 快速开始
Q：401 报错？
检查 Authorization: Bearer 头格式，见 错误码与排障
二、模型与调用
Q：model 字段到底写什么？
填模型名称（如 gpt-4o），可在控制台「调用指南」或「模型广场」查看可用模型列表。若主用户启用了分组标识路由（高级功能，默认关闭），调用指南页还可复制带分组标识的调用名（如 5MHXZWKA/gpt-4o）精确指定分组，见 调用指南与路由说明
Q：模型名称和带分组标识有什么区别？ 模型名称走这把 Key 绑定的路由分组或默认路由配置；带分组标识点名到指定分组（需主用户启用分组标识路由后方可使用），见 调用指南与路由说明
Q：为什么调不到某个模型？ 调用名写错，或该分组不在你账户的可用范围内（由平台按主用户配置），确认可用范围或去调用指南复制
Q：OpenAI 格式和 Anthropic 格式有什么区别？ 见 API 调用基础 第五节
Q：怎么切换模型？
改 model 字段，见 API 调用基础
三、计费与限流
Q：怎么算钱？谁扣费？ 按实际命中的分组/渠道定价（以「模型广场」展示为准）；真实扣费始终扣所属组织的余额
Q：带分组标识和模型名称计费有区别吗？ 与调用名写法无关，按最终走到的分组/渠道计价，见 调用指南与路由说明
Q：429 限流怎么办？
降低并发、指数退避；区分限额（API_KEY_RATE_*，等窗口重置）与配额/并发（具体码以接口实际返回为准），见 错误码与排障
Q：并发上限多少？怎么提升？ 主用户级并发上限由平台统一配置，找所属组织协调，如需调整请联系平台
四、稳定性
Q：502 怎么处理？ 模型供应商返回 5xx 时平台统一映射为 502，请用指数退避重试，见 错误码与排障
Q：带分组标识调用报"分组不可达"怎么办？ 分组标识路由是高级功能（默认关闭），需主用户启用后方可使用。若已启用但报此错误，说明该分组不在可用范围或当前不可用，平台直接报错不降级，改用可用分组，见 调用指南与路由说明
Q：500 和 502 怎么区分？ 500 是平台自身故障，502 是模型供应商侧故障，见 错误码与排障
Q：模型偶发输出韩文/日文？ 模型语言漂移，见 Claude 语言漂移说明