图片生成与编辑

认证与 Base URL 见《接入与文本协议》。使用支持图片生成/编辑的模型。普通生成默认同步，返回 created 与 data；结果按模型能力提供 url 或 b64_json。

n 是正整数，本站上限128，具体模型通常更低；size、quality、style、background、输出格式等参数由模型决定，不要把一种模型的枚举当作所有模型的共同范围。

POST /v1/images/edits 支持模型对应的图片编辑协议。OpenAI 文件方式用 multipart/form-data 提交 image（或模型支持的 image[]）、prompt、model，mask 可选。支持 URL 编辑的兼容网关可用 JSON image / images；URL 方式依赖渠道，不保证原生 OpenAI 接受 URL。

异步图片

仅对支持异步图片任务的 OpenAI 兼容媒体网关渠道使用。创建接口增加 ?async=true，也接受 X-Async:true 或 JSON async:true。没有异步能力的渠道不能仅靠该开关获得异步能力。

生成：POST /v1/images/generations?async=true → GET /v1/images/generations/{task_id}。

编辑：POST /v1/images/edits?async=true → GET /v1/images/edits/{task_id}。

创建和查询响应保留兼容上游的结构，本站替换为公开任务 ID；常见状态是 queued / processing / completed / failed，也可能使用上游兼容别名。完成后读取 data[].url / b64_json 等模型对应字段。推荐隔3～5秒轮询，完成或失败立即停止。

GET /v1/images/{task_id}/content 可读取已完成图片任务内容，带本站调用令牌认证。该接口是代理读取，不代表本站长期保存媒体。

资源保存

URL 结果可能是上游临时链接，过期时间由供应商决定。客户端应在获得结果后及时下载到自己的存储。本站不提供统一的媒体永久保存承诺；Base64 图片由客户端解码保存。图片编辑的文件方式与视频参考视频的 URL 方式属于不同协议。

图片生成与编辑

异步图片#

资源保存#

异步图片

资源保存