参考
错误码
CLI 失败信封与 MCP 共享的稳定错误码。
无论使用 CLI（{ ok: false, code, message, details? }）还是 MCP（错误以文本形式转发到客户端），同一类失败都使用同一个 code。
| Code | 含义 | 解决 |
|---|
no_api_key | --api-key / DLAZY_API_KEY / 配置 / login 都没找到 | dlazy login 或 dlazy auth set <key> |
unauthorized | Key 无效或已撤销 | 重新换一把 Key |
forbidden | 已登录但无权访问（档位/组织） | 检查套餐与组织成员资格 |
insufficient_balance | 组织余额不足 | 充值；CLI 在可估时会先打印预估 |
cli_version_too_low | 服务端拒绝请求：本地 CLI 版本低于 details.minVersion（HTTP 426） | 运行 details.upgradeCommand（默认 npm install -g @dlazy/cli@1.2.0）后重试 |
| Code | 含义 | 退出码 |
|---|
missing_field | 必填字段没有值/没有 --input 键/没有 stdin 引用/没有默认 | 2 |
invalid_request | Schema 校验失败 | 1 |
tool_not_found | 未知 cli_name（CLI / MCP） | 2 |
bad_ref | 管道引用 token 不合法 | 2 |
no_stdin | 使用了 - / @N 但 stdin 为空 | 2 |
input_file_not_found | --input @path 找不到文件 | 2 |
input_file_bad_json | --input 提供的 JSON 解析失败或不是对象 | 2 |
| Code | 含义 |
|---|
file_not_found | 本地媒体 flag 指向的文件不存在 |
file_too_large | 文件超过 500 MB 上传上限 |
upload_failed | 对象存储上传失败，原因在 details |
| Code | 含义 |
|---|
network_error | 还没到 API 就出现的网络错误 |
task_failed | Provider 侧拒绝或中断，详情在 details |
timeout | 异步轮询超过 --timeout |
internal_error | CLI 自身的非预期错误（请反馈 bug） |
dlazy gpt-image-2 --prompt "..." | jq -e ".ok" >/dev/null \
|| jq -r '.code, .message' < /dev/stderr
