Skip to main content
使用异步任务接口创建 Gemini 图像生成任务,通过 GET 轮询获取 24 小时有效的图片 URL。适用于耗时较长的 2K / 4K 高清生成场景。

前置条件:对象存储(必需)

异步图片任务强制要求配置对象存储(S3 或 AliOSS),用于上传生成图片并返回 24 小时有效的临时签名 URL。未配置时返回 error.code=storage_not_configured。

接口列表

Base URL:https://api.gregapi.com

认证方式

任务 ID 格式

  • 格式:image_<ULID>,示例:image_01KCRVET35FAVZME1CEEED9VBS
  • task_id 为兼容字段,等同于 id

文生图:创建任务

创建任务响应:
轮询查询:

文生图:查询结果

完成态响应:
失败态响应:
no-image 已计费失败响应(额外返回 usage):

改图:创建任务

请求方式:multipart/form-data
或传入 URL:
改图异步任务仅支持 Gemini 图像模型,响应格式与文生图任务查询完全相同。

任务状态

轮询策略

  • interval:3–10 秒
  • timeout:5–15 分钟(取决于服务负载与图片分辨率)

与同步接口的关系