常见问题
出错排查
返回 401 Invalid token
- key 没复制完整(少了首尾字符)
- key 已被禁用或删除
- 用了面板 PAT 去调模型接口(或反过来)
- 环境变量没生效,实际发出去的是空值
返回 404
- 用了未实现的端点(
/v1/files等)见 API 总览 - 路径拼错(多/少
/v1)
返回 model not found
- 模型名不在你的分组里
- 拼写错误(比如大小写)
- 平台已下架该档位
流式没输出但请求成功
- 用 OpenAI 的解析器去解析了 Anthropic 流
stream: true忘了大写/拼错- 客户端把
event:行丢了
计费相关
为什么扣费比预期少一半还多?
缓存命中了。见 提示词缓存。
为什么刷新看不到扣费?
扣费是异步的,等几秒再看。
输出中途断了,还收费吗?
收。已经产生的 token 都会计费。
能力相关
支持函数调用 / 工具调用吗?
支持。OpenAI 协议用 tools + tool_choice,Anthropic 协议用同名 tools。
支持流式吗?
支持。SSE(两种协议不同格式)+ 两条 WebSocket。
支持图片理解吗?
取决于你请求的档位实际承载模型。支持多模态的档位可传 image_url。
支持缓存吗?
支持。Anthropic 协议自动补 cache_control,命中 10%。
账号相关
key 泄露了怎么办?
立刻到控制台禁用该令牌。禁用了别人就拿它没法用。
一个账户能建几把 key?
多把,建议每环境一把分开管理。
模型用不了了,怎么知道是平台还是我的问题?
先用 /v1/models 看模型是否还在你的分组;再看错误信息里的
request id,提交给我们定位。