云凡智联

首页/开放能力

genImage

图片生成

支持 Nano Banana、gpt-image-2、gpt-image-2.5 系列与 Seedream 5.0 Pro。

2-6积分/次

基础说明

支持 Nano Banana、gpt-image-2、gpt-image-2.5 系列与 Seedream 5.0 Pro。

提交任务

提交图片生成任务。适用于单商品换背景、营销图生成、风格延展等场景。

POST/api/third-party/genImage/generate

请求头

字段	类型	必填	说明
X-API-Token	string	是	平台提供的调用凭证，用于识别当前账号或租户。
Content-Type	string	是	提交任务时固定使用 application/json。

请求参数

字段	类型	必填	说明
prompt	string	是	图片生成提示词，建议写清主体保留、背景、风格和用途。
model	string	否	模型，可传 Nano Banana 2、Nano Banana Pro、gpt-image-2、gpt-image-2.5、gpt-image-2.5-flare、gpt-image-2.5-sunburst 或 Seedream 5.0 Pro；默认 Nano Banana 2。
images	string[]	否	参考图 URL 列表，Nano Banana 支持 0-8 张；GPT Image 系列支持 0-5 张；Seedream 支持 0-10 张。
resolution	string	否	输出分辨率；gpt-image-2.5 仅支持 1k，Seedream 仅支持 1k/2k，其他模型可传 1k/2k/4k。
aspectRatio	string	否	输出比例，如 1:1、4:3、16:9、auto。

请求示例

bash

curl -X POST "https://yunfanzhilian.com/api/third-party/genImage/generate" \
  -H "X-API-Token: your_token" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "保留产品主体与瓶身文字，生成干净明亮的电商主图，背景简洁，突出高级感",
    "model": "Nano Banana 2",
    "images": [
      "https://your-cdn.com/product-front.jpg",
      "https://your-cdn.com/product-side.jpg"
	    ],
	    "resolution": "1k",
	    "aspectRatio": "1:1"
	  }'

响应字段

字段	类型	必填	说明
code	number	-	业务状态码，200 表示请求成功。
message	string	-	本次请求的结果说明。
data.taskId	string	-	任务 ID。提交成功后请保存，用于查询生成结果。
data.cost	number	-	本次提交预扣积分。
data.status	string	-	任务初始状态，通常为 pending 或 processing。
timestamp	string	-	响应时间，ISO 8601 格式。

响应示例

json

{
  "code": 200,
  "message": "图片生成任务已提交",
  "data": {
    "taskId": "task_xxxxxxxx",
    "status": "pending",
    "images": [
      "https://your-cdn.com/product-front.jpg",
      "https://your-cdn.com/product-side.jpg"
    ],
    "resolution": "1k",
    "aspectRatio": "1:1",
    "model": "Nano Banana 2",
    "cost": 4
  },
  "timestamp": "2026-03-31T09:30:00.000Z"
}

注意事项

参考图建议使用可公网访问的 HTTPS URL。
Seedream 5.0 Pro：1K 3 积分、2K 6 积分。
gpt-image-2：1K/2K/4K 分别为 4/5/6 积分；gpt-image-2.5：仅支持 1K，为 2 积分；gpt-image-2.5-flare：1K/2K/4K 分别为 2/3/4 积分；gpt-image-2.5-sunburst：1K/2K/4K 分别为 2/3/4 积分；Nano Banana 2：1K/2K/4K 分别为 4/4/4 积分；Nano Banana Pro：1K/2K/4K 分别为 4/4/4 积分。
提交接口只负责创建任务，生成结果请通过获取结果接口查询。
单次最多生成 100 个子任务；当前提交接口每次创建 1 个图片生成任务。
达到服务端并发提交上限时会进入等待队列；等待超时或队列满时返回 429，请稍后重试。