常见问题:报错、选错与接不通
先分清账户、接口、模型判断与执行流程是哪一层出了问题。
HTTP 报错先按层排查
| 现象 | 优先检查 | 不应该做什么 |
|---|---|---|
| 401 | 密钥有效性、所属渠道、Bearer Header | 把密钥贴到公开群里求助 |
| 422 | JSON、必填字段、问题类型、criteria 格式 | 只更换模型却不看响应错误 |
| 429 | 账户限额、并发、退避策略 | 无上限并发重试 |
| 529 / 过载 | 服务状态、有限重试、人工回退 | 假设业务动作已经成功 |
| 超时 / 网络失败 | 本地网络、服务商可达性、超时设置 | 宣称所有中国地区一定可用或不可用 |
状态码处理以实际服务商为准,聚合渠道可能返回自己的错误格式。
为什么没有一段回复文字
这是预期行为:Jev 的主要接口返回限定判断。需要自然语言回复时,由模板、人或独立生成模型处理。不要照搬聊天接口的 message / completion 结构。
为什么没有 confidence,或分数不是整数
Noul 没有独立 confidence。Score 可能是量表上的加权数值,而非整数等级。解析字段前先确认问题类型,不要把 Score 乘 100 变成所谓准确率。
返回 JSON 正确,为什么判断仍然错
检查信息是否足够、标签是否重叠、有没有兜底项、问题是否包含隐含条件,以及是否涉及模型已知薄弱项。用失败样本复现并记录版本。格式验证不能修复语义判断错误。
为什么前端页面不能直接调用
不能为了绕开 CORS 就把长期密钥塞进公开 HTML。使用你控制的后端读取密钥、鉴权、限速和记录请求;本静态指引没有代调用后台,也不会要求访问者提交 API 密钥。
求助时应该提供什么
脱敏后的请求结构、响应状态和正文、模型版本、SDK 版本及复现步骤。删除密钥、客户身份、内部链接和敏感原始数据。
本页来源与验证边界
核对日期:2026-09-19。文档整理,不代表本站完成了真实 API 或业务效果测试。
TypeSafe · HTTP API →TypeSafe · Models, pricing and limits →TypeSafe · Confidence →TypeSafe · Jev 1.13 limitations →TypeSafe · Quick start →阅读进度只保存在当前浏览器

