图片接口

概述

图片接口（Image API）以 任务式 方式提交图片生成请求：所有模型共用同一个提交端点 POST /api/generate/submit，区别只在 model 字段与 input.metadata 透传字段。提交后立刻返回 task_id，再用 GET /api/generate/status/{task_id} 轮询直到 status=finished。

共用请求骨架

{
  "model": "gpt-image-2 | nano-banana-2 | nano-banana-pro",
  "input": {
    "prompt": "图片描述",
    "size": "1:1 | 16:9 | 9:16 | auto | 1024x1024",
    "image": "参考图 URL（可选）",
    "images": ["参考图 URL 列表（可选）"],
    "metadata": { /* 模型专属参数 */ }
  }
}

只有 prompt / size / image / images / duration / seconds 允许出现在 input 顶层；任何其它字段（例如 quality、resolution、n、mask_url）必须放进 input.metadata，否则会被 400 拒绝。

模型