云端调用错误
根据 HTTP 状态定位云端 API 调用问题。
调用失败时，先记录 HTTP 状态和响应中的错误说明，再按下表处理。
HTTP 状态
| 状态 | 检查内容 | 处理方式 |
|---|---|---|
400 | 请求格式、图像和机器人状态 | 对照输入格式检查 JSON 文本、data URL 和 8 维状态 |
401 | API Key | 确认使用有效的 Key，并通过 Authorization: Bearer 发送 |
403 | 账户或模型权限 | 在开发者控制台确认访问权限，再用当前 Key 查询 /models |
404 | 地址和模型 ID | 核对接入配置中的 Base URL，并从 /models 获取模型 ID |
413 | 请求大小 | 减小图像文件体积，重新编码后发送 |
429 | 调用频率、并发或账户额度 | 查看具体错误说明与账户用量，降低并发或等待后再发起请求 |
5xx | 服务暂时不可用 | 保留错误说明，稍后重新检查服务是否恢复 |
账户与 API Key 的管理入口见开发者控制台。
超时与连接失败
先检查网络和 Base URL，并调用 GET /models 确认连接与认证。模型查询成功后，再核对推理请求的输入。
若推理已经超时，当前相机图像和机器人状态可能已改变。重新调用前采集新的观测；已交给机器人执行的动作不要因为网络错误而重复执行。
响应无法解析
成功调用应返回 execute_actions 工具调用，其 function.arguments 是包含 output 的 JSON 字符串。检查动作序列是否包含有效的 8 维数值行，具体格式见云端 API。
若返回的是 HTML、登录页或其他非 JSON 内容，先检查请求是否发送到了 API 域名，而非开发者控制台网页。
联系支持
提供调用时间、接口路径、HTTP 状态、错误说明，以及响应头 X-Request-ID 中的请求编号（若有）。API Key 和原始图像无需随问题描述发送。