图像对象与结果保存
图片结果可能以 URL、Base64 或嵌套图片对象返回。先检查 HTTP 状态和错误字段,再根据本页接口的 Response schema 读取对应字段;不要把不同协议的响应结构混用。
常见字段
| 字段 | 类型 | 处理方式 |
|---|---|---|
| url | string | 下载返回的图片地址,并在有效期内保存到自己的对象存储。不要假设地址永久有效。 |
| b64_json | string | 按响应声明的图片格式 Base64 解码;解码前校验字符和文件头。 |
| revised_prompt | string | 服务端改写后的提示词,仅用于记录或展示,不要当作下一次请求的原始提示词。 |
| data[] / output | array/object | 以具体 Response schema 展开结果;异步协议要先查询到终态再读取产物。 |
下载与安全
不要把上游临时 URL 直接嵌入长期页面,也不要把未验证的图片 HTML 当作受信任内容。下载失败时重新查询任务或重新获取结果地址;客户端断线不等于生成失败。