外观
模型与渠道
模型清单、价格和可用范围会随控制台更新。本页不复制容易过期的数字,请直接以牛API控制台为准。
目录状态:需要控制台导出
公开接口要求 Authorization;未取得控制台导出前不展示推测价格。
目录尚未导入
从控制台导出模型 JSON 后运行 pnpm sync:model-catalog -- --input path/to/catalog.json,不要手工填写或引用第三方价格。
模型与渠道状态
模型是否可用取决于 Key 的权限范围、账户余额与额度、资源状态、协议支持和模型 ID 本身。排查时先用户侧逐项排除,再提交人工核查。
用户应先检查
平台侧会检查什么
提交人工核查后,平台会确认渠道可用性、资源水位和连续失败记录。你只需提供模型 ID、协议、发生时间、HTTP 状态码和请求 ID,不需要了解内部路由配置。
使用前确认两件事
参考主流平台的做法,接入前建议先确认模型可用性和限速,避免配置后才发现不可用:
- 查看模型列表与价格:在牛API控制台确认当前可用的真实模型 ID、展示名称和价格,不要根据第三方站点推测。
- 使用控制台现有测试入口:若控制台提供“在线体验 / Playground”,先在其中发送短消息;若没有,直接按快速开始使用最小请求,不必寻找隐藏入口。
用量记录
控制台字段可能随版本调整。打开用量页后,优先核对:
- 请求发生日期与时间;
- 使用的专用 Key 或用途名称;
- 模型 ID 与协议;
- 输入、输出及缓存 Token;
- 请求状态、请求 ID 与费用;
- 客户端是否自动重试或并行发起请求。
若控制台暂不支持其中某个筛选维度,可结合请求时间和请求 ID 交叉定位。用量定位方法见用量、额度与账单。
计费 FAQ
计费规则必须以控制台价格、账单明细和付款页当前说明为准:
| 问题 | 当前答案 |
|---|---|
| 输入和输出是否分别计费 | 查看目标模型的价格单位与账单明细 |
| 不足 1M Token 如何计算 | 以控制台展示的计价单位和实际账单为准 |
| 缓存输入如何计费 | 查看目标模型是否单列缓存价格 |
| 余额如何扣减 | 对照请求时间、用量记录和余额变化 |
| 用量在哪里查看 | 见用量、额度与账单,入口名称以控制台为准 |
| 请求失败是否扣费 | 按请求 ID 查账单记录,不根据状态码自行推断 |
| 用户取消是否扣费 | 对照取消时间前已经产生的请求记录 |
| fallback 是否产生额外消耗 | 检查同一时段是否出现多个模型或多条请求 |
| 价格调整何时生效 | 以控制台价格页和公告显示的生效时间为准 |
| 额度/积分是否有有效期 | 查看额度详情页显示的有效期 |
| 未使用额度是否可退款、多久内可申请 | 以付款页和控制台退款说明为准,不预先承诺 |
为什么编程 Agent 消耗较高
Codex 和 Claude Code 可能反复读取文件、携带较长上下文、调用工具并自动继续任务。一次可见操作不一定只对应一次 API 请求。建议为编程客户端创建独立 Key,设置额度,先以并发 1 运行,并定期核对用量。
