Skip to main content
图片异步接口适合长耗时、按张计费的图片生成场景。它不是 OpenAI 同步图片接口的简单别名,而是平台任务制接口:创建任务后立即返回任务 ID,平台在后台处理生成和结果转存,再按成功返回的图片数结算。
OpenAI 兼容图片接口仍是 /v1/images/generations;图片异步接口是 /v2/images/generations。两者在模型、endpoint、计费和返回结构上是隔离的。

适用场景

创建任务

NanoBanana 系列模型可指定分辨率,分辨率不改变按张计费方式:

请求字段

当前实现会拒绝 n 字段,返回 invalid_request_error。如果业务需要多张图片,请创建多个任务;不要把多个任务塞进一个请求。

创建响应

status=queued 表示任务已经创建并完成冻结,后续由平台异步处理生成和结果转存。

查询任务

处理中响应

成功响应

返回给用户的是问高云侧结果图 URL。结果存储、URL 有效期和清理策略以后端配置为准。

失败响应

状态说明

计费与安全

  • 创建任务前会检查模型可见性、API Key 白名单、模型能力、价格配置和余额。
  • 创建成功后会冻结预计费用;成功后按实际成功存储并返回的图片数结算。
  • 任务查询按 task_id + 用户 + 域名 + API Key 做归属校验,不能查询其他 Key 创建的任务。
  • 结果图 URL 视为敏感数据,不应该出现在普通日志、账单导出或公开错误信息中。
如果你想做前端轮询,建议 2-5 秒查一次任务状态;不要高频刷新。