常见问题：先定位，再看专题说明

JBB 是 AI API Gateway，通过兼容接口帮助用户接入多类模型；它不是模型权重的制造方。模型、协议、价格和可用状态分别以模型总览、协议文档与实时价格页为准。

详细说明：关于 JBB

填写 https://downstream.jbbtoken.cn/v1。这个地址已经包含一次 /v1，SDK 配置中不要再次追加。

详细说明：Quick Start · Base URL

字段名是 Base URL 时通常填写带 /v1 的根地址；字段明确要求 Chat Endpoint 时才填写 /v1/chat/completions。优先使用官方 HTTPS 域名，不要把裸 IP 当长期 Base URL。

详细说明：Quick Start · 地址说明

登录控制台进入“API 密钥”，按项目或环境分别创建。Key 只放服务端环境变量或 Secret Manager，不要写入前端、截图、公开日志或 Git 仓库。

详细说明：Quick Start · API Key

查看模型总览并以当前页面为准。模型列表、可用状态和价格会变化，不要从旧截图或历史示例复制模型名。

详细说明：模型总览

请求必须使用当前模型列表中的精确 Model ID；显示名称、历史别名、大小写差异或当前 Key/分组不可用都可能导致失败。先从模型总览重新复制 ID，再做最小纯文本请求。

详细说明：模型总览

不能默认混用。OpenAI-compatible、Claude-compatible 与 Gemini-compatible 的路径、认证头和请求体不同；只复用各自文档明确支持的字段。

详细说明：OpenAI-compatible 说明

能否接入取决于客户端是否允许自定义 Base URL、API Key 和目标协议。按对应 Guide 配置；不要把一个客户端的地址规则照搬到另一个客户端。

详细说明：客户端 Guides

技术上可能可以，但不建议。按项目、环境或用途创建独立 Key，便于停用、额度控制和 Usage Logs 核对，也能缩小泄露影响面。

详细说明：Quick Start · Key 管理

不可以。任何能被最终用户查看的前端代码、网页请求、公开仓库、截图或日志都不应包含真实 Key。需要浏览器调用时，应由自己的服务端代理并实施鉴权。

详细说明：Quick Start · 安全检查

提供 UTC 或明确时区的时间、JBB request ID、接口路径、精确 Model ID、HTTP 状态码、脱敏错误与客户端版本。不要发送完整 API Key、密码、上游凭据或包含敏感 Prompt 的原始日志。

详细说明：争议排查证据

不等于。Token 由模型对应 tokenizer 切分；中文、英文、数字、空格、标点、代码和图片都可能使用不同规则。最终以该次请求的 usage 与 Usage Logs 为准。

详细说明：Token 基础

不一定。只有模型和路由支持缓存、请求满足命中条件且对应价格规则生效时，cache read 才可能使用独立单价；cache write 也可能单独计费。

详细说明：缓存计费

可见文本短不代表总 completion usage 少。部分模型会报告 reasoning tokens，或由上游把推理用量计入 completion；高 reasoning effort 也可能显著增加实际用量。

详细说明：Reasoning Token

部分请求会先按最大输出、任务单价或安全上限预扣，完成后再按实际 usage 或最终任务结果结算，多退少补。不要把预扣变化直接当成最终账单。

详细说明：预扣与结算

失败是否扣费取决于失败发生阶段和对应计费规则。前置校验失败通常没有正常 usage；上游已执行、HTTP 200 空结果、部分结果或特定违规场景可能仍结算。用 request ID 对照 Usage Logs，避免把客户端重试误认成同一请求。

详细说明：失败扣费矩阵

价格页反映当前价格，历史账单记录请求发生时的结算。核对模型 ID、时间、输入输出、缓存、reasoning、分组倍率、按次任务与预扣返还；单笔结算以 Usage Logs 为准。

详细说明：账单核对

检查 Authorization: Bearer ...、Key 是否启用或过期，以及环境变量是否在当前进程中生效。不要在工单或聊天中粘贴完整 Key。

详细说明：Quick Start · 401

不能只凭 403 下结论。它可能来自权限、模型/分组可用范围、安全策略或其他拒绝条件；读取脱敏错误体并按 request ID 查日志。没有新证据时不要无间隔重试。

详细说明：Quick Start · 排错

先检查 Base URL 是否重复成 /v1/v1、接口路径是否属于目标协议，以及 Model ID 是否仍在当前列表。路径正确但模型不存在时，再核对 Key/分组可见范围。

详细说明：Quick Start · 404

不应该。先检查 Key 额度、账户余额、并发或频率限制；使用带随机抖动的指数退避和有限重试次数。无间隔重试会放大负载，并可能产生多笔真实请求。

详细说明：Quick Start · 429

5xx 表示服务端或上游链路没有正常完成。记录 request ID 和响应体，先做有限次数退避重试；持续失败时停止自动重试，避免 retry storm，再按同一模型、端点和时间窗口排查。

详细说明：Quick Start · 有限重试

客户端超时、断流或取消不代表上游一定停止。重试前先用 request ID 和时间核对原请求状态；对非幂等生成任务尤其要避免自动重复提交。

详细说明：请求与账单核对

不能。模型自报身份受系统提示词、训练数据和代理改写影响，只能作为弱线索。

详细说明：模型真实性 FAQ

不能。它适合观察服务配置变化与复现条件，但不是模型权重 hash，也不是供应商签名证明。

详细说明：强弱信号

不能。只能报告这三个样本在已记录条件下多信号一致，无法代表全量流量、未来请求或底层权重身份。

详细说明：误报与漏报

可独立验签的供应商 attestation 最强：它应把 canonical 请求/响应 hash、nonce、不可变 resolved model ID 与模型 artifact 或 measurement hash 绑定，并验证签名 key 来源、有效期与撤销状态。当前 JBB 审阅实现未提供该等级。

详细说明：证据等级