香蕉模型（异步）

适用于 nano_banana_*-异步 和 gpt-image-2*-异步。文生图、图生图、图文生图的请求格式与 gpt-image-2-1k-同步 相同，但提交后返回异步任务，需 查询任务 获取图片 URL。

支持模型

• nano_banana_2-异步
• nano_banana_pro-1K-异步 / nano_banana_pro-2K-异步 / nano_banana_pro-4K-异步
• gpt-image-2-1k-异步 / gpt-image-2-2K-异步 / gpt-image-2-4K-异步

认证与请求头

Authorization: Bearer sk-xxxxxx
Content-Type: application/json

接口一览

能力	提交接口	是否传 image	结果获取
文生图	POST /v1/images/generations	否	GET /v1/videos/{task_id}
图生图	POST /v1/images/generations 或 edits	是	同上
图文生图	POST /v1/images/generations 或 edits	是	同上

---

1. 文生图

纯文本生成，不传 image。

请求示例

{
  "model": "nano_banana_2-异步",
  "prompt": "生成一张商品海报，极简风，白底",
  "size": "1792x1024"
}

cURL

curl --request POST \
  --url 'https://bigbangtoken.com/v1/images/generations' \
  --header 'Authorization: Bearer sk-xxxxxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "nano_banana_2-异步",
    "prompt": "生成一张商品海报，极简风，白底",
    "size": "1792x1024"
  }'

提交响应（非图片）

{
  "id": "task_xxx",
  "object": "image",
  "model": "nano_banana_2-异步",
  "status": "queued",
  "progress": 0,
  "created": 1709876543
}

轮询 GET /v1/videos/task_xxx，status 为 completed 时从 url 取图。

---

2. 图生图

传 image，基于参考图生成新图。

请求示例（generations）

{
  "model": "gpt-image-2-1k-异步",
  "prompt": "把这张图改成赛博朋克风格，霓虹高光",
  "image": "https://example.com/reference.jpg",
  "size": "1024x1024"
}

多图参考

{
  "model": "nano_banana_pro-2K-异步",
  "prompt": "融合两张图的构图与主体",
  "image": [
    "https://example.com/a.jpg",
    "https://example.com/b.jpg"
  ],
  "size": "1536x1024"
}

cURL

curl --request POST \
  --url 'https://bigbangtoken.com/v1/images/generations' \
  --header 'Authorization: Bearer sk-xxxxxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2-1k-异步",
    "prompt": "把这张图改成赛博朋克风格",
    "image": "https://example.com/reference.jpg",
    "size": "1024x1024"
  }'

---

3. 图文生图

prompt 描述修改意图，image 提供视觉参考；接口仍是 generations 或 edits。

示例：保留主体改背景

{
  "model": "nano_banana_2-异步",
  "prompt": "保留产品主体，背景改为春节红色促销场景",
  "image": "https://example.com/product.jpg",
  "size": "1024x1024"
}

示例：参考图 + 文字生成同风格新场景

{
  "model": "gpt-image-2-4K-异步",
  "prompt": "参考图片的光影和配色，生成同风格的雪山营地",
  "image": "https://example.com/style-ref.jpg",
  "size": "1792x1024"
}

完整流程

1. 提交 → 拿到 task_id
2. 轮询 GET /v1/videos/{task_id}（建议 3–5 秒一次）
3. status: completed → 读取 url

查询响应示例：

{
  "id": "task_xxx",
  "status": "completed",
  "progress": 100,
  "url": "https://example.com/images/result.jpg"
}

详见 异步任务查询。

---

四、参数标注（适用部分 key）

字段	类型	文生图	图生图 / 图文生图	说明
model	string	必填	必填	见支持模型列表
prompt	string	必填	必填	描述或编辑意图
size	string	可选	可选	转为 aspect_ratio
image	string | string[]	不传	必填	URL 或 base64

size 映射

OpenAI size	aspect_ratio
1024x1024	1:1
1024x1792	9:16
1792x1024	16:9
1024x1536	2:3
1536x1024	3:2

image 形式

• 单张 URL 或 data:image/...;base64,...
• 字符串数组多张图
• 不支持 multipart/form-data

---

五、与图片2（同步）的区别

对比项	香蕉 / GPT 异步	gpt-image-2-1k-同步 同步
文生图返回	任务 ID	直接返回图片
图生图返回	任务 ID	直接返回图片
图文生图	同左，需轮询	同左，即时返回
查询接口	GET /v1/videos/{task_id}	不需要

计费

• 提交一次扣一次
• 查询不重复扣费

相关文档

• 图片2 接入总览
• 图片2（同步）
• 异步任务查询