跳到主要内容

Gemini 批量生图 API

批量生图适合一次提交多个 Prompt，后台异步生成，再查询状态和下载结果。它比同步接口更适合运营素材、批量封面、A/B 创意图等任务。

流程​

  1. 提交批量任务。
  2. 获取任务 ID。
  3. 轮询任务状态。
  4. 下载单张图片或 ZIP。
  5. 保存结果到自己的业务系统。

提交任务​

POST /v1/images/batches
Authorization: Bearer sk-your-dinghui-key
Content-Type: application/json
{
  "model": "your-gemini-image-model",
  "items": [
    {
      "prompt": "蓝绿色 AI API 控制台 Banner，横向构图",
      "size": "1536x1024"
    },
    {
      "prompt": "企业级模型路由网络示意图，干净科技风",
      "size": "1024x1024"
    }
  ]
}

查询状态​

GET /v1/images/batches/{batch_id}
Authorization: Bearer sk-your-dinghui-key

常见状态：

状态说明
queued已提交，等待处理
running正在生成
completed已完成
partial_failed部分失败
failed全部失败

下载结果​

如果接口返回图片 URL，业务侧应尽快下载并保存。临时 URL 可能有有效期，不建议长期依赖。

批量任务建议​

  • 每批数量不要过大。
  • 给每个任务保存业务侧任务 ID。
  • 对失败项单独重试，不要整批重复提交。
  • 设置并发限制和预算上限。
  • Prompt 使用统一模板，方便后续比较效果。

常见问题​

为什么部分失败？​

可能是单个 Prompt 不合规、图片尺寸不支持、上游超时或模型临时异常。建议只重试失败项。

轮询频率设置多少？​

建议 3 到 10 秒查询一次，避免过高频率浪费请求。