错误码
当前公开错误解释必须和当前实现返回的 error_code 对齐,同时继续以“用户下一步该做什么”为中心,而不是只解释技术细节。
常见类型
| 错误码 | 含义 | 推荐动作 |
|---|---|---|
INVALID_API_KEY |
API key 无效或当前账号不可用 | 检查绑定账号、key 配置或重新生成凭证 |
INSUFFICIENT_CREDIT |
当前请求所需额度不足 | 检查 quota 状态并确认升级路径 |
INVALID_REQUEST |
请求参数、输入格式或对象标识不合法 | 收紧输入并重新检查平台、筛选条件或 creator_id |
DUPLICATE_DATA |
同一对象已存在,无需重复创建 | 先查询已有对象、任务或监控记录,再决定是否继续 |
UPSTREAM_40017 |
上游服务额度不足或被上游侧限流 | 稍后重试,或检查底层服务配额是否已经触顶 |
INTERNAL_ERROR |
系统内部错误 | 保留上下文和 request ID,并联系支持 |
使用原则
面向终端用户时,应优先解释恢复路径,而不是只转抄技术术语
前端、Agent 和站点文档应以当前实现的实际错误码为准,不要自行发明别名
如果 Agent 已经能给出下一步动作,应优先复用该动作



