输入输出要求
简介
请求与响应均为 JSON,金额字段是十进制整数字符串,不要用浮点数计算余额。只能读取自己密钥与工作空间下的任务。
字段含义
id
任务编号,等于提交的幂等键。
state
任务生命周期状态。
billing_status
held、pending、settled 或 released。reserved_microcredits
当前持有的预留。
charged_microcredits
已结算扣费;为 0 不代表失败。
error_code
机器可读的失败码。
error_message
图片任务可选的脱敏失败详情;无详情时省略,文案可能截断。程序逻辑应判断 error_code。
failure_reason
视频失败任务可选的安全分类。
| 状态 | 处理方式 |
|---|---|
queued、submitting、submitted、processing、finalizing | 轮询自己的任务。 |
completed | 用 ?result=true 读取结果。 |
failed | 查看错误与已释放的预留。 |
pending | 待核对:保留任务编号,停止自动重提。 |