图片与视频 API 接入：创建、查询、结算与保存成品

图片：先确认输出形式#

选择模型后，逐项核对生成或编辑接口、支持尺寸、张数、输入格式和计费方式。不同模型可能有各自约束，尤其不能将一个模型的质量枚举直接复制到另一个模型。

返回结果可能是临时 URL 或编码内容，应依据真实响应解析。若要长期使用，及时将成品保存到自己的受控存储；不要假定返回链接永久有效。需要编辑原图时，只上传有权使用且适合交给相关服务处理的文件。

视频：把提交和完成拆开#

1. 阅读所选模型的专页，准备它接受的请求体。
2. 使用 POST /v1/videos 创建任务，按文档携带幂等键。
3. 保存返回的任务 ID，并用 GET /v1/videos/{id} 查询进度。
4. 生成完成后继续检查结算与成品状态。
5. 使用带 Bearer 鉴权的 GET /v1/videos/{id}/content 下载成品，保存到自有存储。

提交示例不在本文硬编码某个模型和参数，以免误导不同视频渠道的接入。创建接口的兼容别名及具体请求字段以当前文档为准。

三类状态分别看#

文档提及默认视频有效期，但业务应始终以响应中的 expires_at 为准，不能把固定 24 小时写成对所有任务的永久规则。已经完成的生成也可能因为文件过期而无法下载。

查询与下载的工程细节#

查询应有间隔、退避和总时限，避免每秒无上限轮询。将任务 ID 关联到实际用户订单，页面刷新后恢复查询，而不是重新提交生成。

/content 需要 Bearer 鉴权，直接放进不带请求头的普通浏览器链接可能失败。应用后端应在验证用户权限后下载或转存，不要为方便展示把 API Key 拼到 URL、前端源码或日志中。

下载时检查 HTTP 状态与内容类型，避免把错误 JSON 保存为视频文件。网络断开时，先判断任务状态，再决定重试下载或查询；不要重复创建。相关原则见 重试与幂等。

上线前用少量任务走完整条链路：成功、失败、超时恢复、过期、结算待复核。按 成本台账 同时记录任务规格与最终费用。