Image-2 API 返回里缺字段怎么办？空值、字符串数字和兼容解析

Image-2 API 返回 JSON 时，有些字段看起来像数字，却必须按字符串保存；有些字段没有值时，会直接不出现在响应里。兼容解析的关键不是“给所有字段默认值”，而是保留合同里的缺失与类型边界。

解析时先立三条规则

图注：成功信封、可选字段和字符串数字要分别处理。

第一，成功只看外层 code === 200。不要靠 HTTP 状态码、message 文案或 success 字段猜结果。

第二，把可选字段的“缺失”和 null 统一当作未提供，但不要自动补成空字符串或 0。例如任务还在 RUNNING 时没有 resultUrl，不代表结果 URL 是空字符串；失败任务没有 costPoints，也不代表一定消耗 0。

第三，taskId、costPoints、分页 total，以及 usage 的 apiKeyId/grossConsume/refund/net 按字符串处理。它们即使只包含数字字符，也不要转成 JavaScript Number，否则长 ID 可能丢精度。

按状态读取结果字段

if code != 200: 处理外层错误
else if status == SUCCESS: 要求 resultUrl
else if status == FAILED or VIOLATION: 读取 failureReason / errorCode?
else: 继续有限轮询

问号表示字段可缺失。强类型语言可以把它建模为 optional，而不是给一个看似方便的默认值。分页 total 若要计算页数，可用安全的大整数类型或受控十进制解析，但原始响应仍应保留。

完整字段表与示例在Image-2 开放平台文档。API Key 必须留在服务端；网页需要直接生图时使用Image-2 页面，不要把服务端 Key 塞进浏览器代码。

最后保留一份原始响应日志，并做好敏感字段脱敏。解析后的业务对象便于使用，原始结构则方便接口升级或异常时复核。