Metadata

name: generate-poster
description: 通过 Flyelep API 生成电商产品主图、详情图海报和白底主图，支持异步（提交后轮询）与同步（一次请求出图）两种模式。当用户要求生成产品图、电商海报、Amazon 商品图、详情页图片、白底图、白底主图、纯白背景产品图时使用此技能。

Flyelep 电商海报生图

通过 Flyelep AI API 生成电商产品主图、详情图海报和白底主图，支持异步与同步两种模式。

重要：这是一个 HTTP API 调用技能。必须通过 HTTP POST 请求调用 API 接口，禁止通过浏览器访问 Flyelep 网站。

两种调用模式

模式	入口	返回	适用场景
异步（推荐）	`/generateAsync`	立即返回任务 ID，再轮询 `/queryTaskResult`	绝大多数场景，尤其是多张详情图
同步	`/generate`、`/whiteBgMainImgGen`	一次请求内挂住连接直到出图，直接返回图片结果	只出 1 张图、且调用方不方便实现轮询时

两种模式的请求参数完全一致，共用同一套排队与计费逻辑，差别只在于结果怎么拿。

默认用异步模式。同步模式的连接要挂最长 15 分钟，容易被中间的网关、代理或客户端超时切断，而且它不返回任务 ID，一旦连接断开就无法再查回这次生成的结果。只有用户明确要求"一次请求拿到图"时才用同步。

API 接口信息

创建任务（异步，推荐）

URL: POST https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/generateAsync
Content-Type: application/json
认证方式: secretKey 可放在请求 Header 或 Body 中，两者都传时以 Header 为准；所有 generateType 的规则一致
超时时间: 建议 120 秒（创建任务为瞬时操作）

请求头示例：

Content-Type: application/json
secretKey: 用户提供的API密钥

查询结果接口同样支持 Header 传 secretKey，推荐统一放在 Header 里。

安全说明：API 密钥仅在请求时传递给 Flyelep 服务器，不存储在技能代码中。请勿将真实的密钥直接写在示例代码中，运行时由用户动态提供。

查询结果（仅异步模式需要）

URL: POST https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/queryTaskResult
Content-Type: application/json
认证方式: 在请求 Header 中传入 secretKey
说明: 异步接口，需轮询获取最终图片 URL（生图耗时较长，可能需要数分钟）

创建任务（同步）

URL: POST https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/generate
Content-Type: application/json
认证方式: 与异步模式一致，secretKey 放 Header 或 Body 均可，Header 优先
超时时间: 服务端最长挂 15 分钟（900 秒）后返回超时失败，客户端 --max-time 要设到 900 秒以上，否则会自己先断开
说明: 请求会一直挂住直到生成完成，响应里直接带图片结果，不返回任务 ID

白底主图另有一个语义化的同步入口：

URL: POST https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/whiteBgMainImgGen
说明: 等价于 /generate + generateType=101，服务端会强制把 generateType 置为 101，因此 body 里传不传 generateType 都一样。其余参数、鉴权、超时与 /generate 完全相同

请求 Body

以下 Body 结构对异步（/generateAsync）和同步（/generate、/whiteBgMainImgGen）都适用。

generateType=100/200（产品单图/详情图）

{
  "query": "生图需求描述，最多1000个字符",
  "generateType": 200,
  "posterType": 5,
  "platformType": "amazon",
  "languageType": "英文",
  "detailPictureNumber": 10,
  "modelEdition": 9,
  "channel": "promotion",
  "needText": true,
  "secretKey": "用户提供的API密钥",
  "fileUrlList": ["https://example.com/product.png"],
  "aspectRatio": "1:1"
}

generateType=101（白底主图）

注意：白底主图不需要 platformType、languageType、needText 参数。

{
  "query": "生成白底主图的需求描述，最多1000个字符",
  "generateType": 101,
  "posterType": 5,
  "detailPictureNumber": 1,
  "modelEdition": 9,
  "channel": "promotion",
  "secretKey": "用户提供的API密钥",
  "fileUrlList": ["https://example.com/product.png"],
  "aspectRatio": "1:1"
}

查询结果

{
  "agentGenerateTaskId": "创建任务返回的任务ID"
}

响应格式

创建任务响应（异步模式）

{
  "code": 200,
  "data": "20374084144913*****"
}

data 为异步任务 ID，用于后续轮询获取结果。

创建任务响应（同步模式）

{
  "code": 200,
  "data": "https://xxx.com/image1.png;https://xxx.com/image2.png;"
}

同步模式的 data 是一个字符串，不是任务 ID，也不是数组
服务端把工作流逐段输出的内容用英文分号 ; 拼接后返回，末尾可能带一个多余的 ;
拿到后按 ; 拆分、丢掉空片段，再从片段中取出图片 URL 展示给用户
内容由工作流决定，可能夹带非 URL 的文本片段，因此要按"是否以 http 开头"过滤，不要假设每一段都是图片
失败时 code 非 200，原因在 msg 里，例如 当前并发请求过多，请稍后重试、任务执行超时，请稍后重试、任务执行失败: xxx

查询结果响应

{
  "code": 200,
  "data": {
    "taskList": [
      {
        "taskStatus": 2,
        "executeResult": "https://xxx.com/image1.png"
      },
      {
        "taskStatus": 2,
        "executeResult": "https://xxx.com/image2.png"
      }
    ]
  }
}

taskStatus: 0-待生成，1-生成中，2-生成成功，3-生成失败
executeResult 为生成的图片 URL
将成功的图片逐个展示给用户，不要回读图片内容

参数说明

必传参数

重要：以下必传参数必须通过询问用户获取，agent 不可自行填写。调用本技能时，应先向用户列出必传参数与可选参数表格，由用户确认或提供后再执行。

字段	默认值	说明
query	-	生图需求描述，最多1000个字符
generateType	200	100=产品单图，101=白底主图，200=产品详情图
posterType	由平台推导	5=跨境电商，6=中文电商。见「平台联动规则」
platformType	amazon	电商平台（见下方映射表）。generateType=101 时不需要
languageType	由平台推导	生成图片上的文案语种：中文平台默认 `中文简体`，跨境平台默认 `英文`。generateType=101 时不需要
detailPictureNumber	10	产品单图限1张；详情图可选5、10、15张
modelEdition	9	模型类型：2=Flyelep 2.0，3=Flyelep 3.0，9=Flyelep Image 2（默认）
needText	true	图片上是否包含文案。generateType=101 时不需要
secretKey	-	API 密钥，放在 Header 或 Body 中均可，Header 优先

可选参数

字段	默认值	说明
fileUrlList	-	参考图片 URL 数组，最多6张
aspectRatio	随机	图片比例：1:1、3:2、2:3、3:4、4:3、4:5、5:4、9:16、16:9、21:9
channel	`promotion`	特惠通道（`promotion`，默认）/尊享通道（`premium`）。特惠通道仅支持 `modelEdition` 为 `3` 或 `9`

参数映射规则

平台联动规则（先定平台，再推导 posterType 和 languageType）

用户提到平台名后，posterType 和 languageType 都由平台推导，不要再反过来问用户，也不要一律套用跨境的英文默认值：

用户提到的平台	platformType	posterType	languageType 默认值
淘宝、天猫、京东、拼多多、1688、小红书、抖音（国内）	对应中文平台名	6	`中文简体`
Amazon、Temu、Shopee、TikTok Shop、AliExpress、OZON、eBay、Lazada、Wish 等	对应英文平台名	5	`英文`

用户明确指定了语种（例如"淘宝的图但文案用英文"、"Amazon 日语版"）时，以用户指定的为准，posterType 仍按平台归属决定
用户只说"电商图"没提平台时，才需要询问目标平台；询问时按中文电商 / 跨境电商两类给选项
用户用中文描述需求但指定了跨境平台，不等于要中文文案，仍默认 英文

platformType（电商平台）

跨境电商：amazon、Temu、Shopee、TikTok Shop、AliExpress、OZON
中文电商：淘宝、京东、拼多多、1688、小红书

languageType（文案语种）

跨境：英文（默认）、俄语、日语、韩语、阿拉伯语、德语、西班牙语、法语、泰语、马来语、越南语、葡萄牙语、菲律宾语、印尼语、意大利语、荷兰语、波兰语、中文繁体
中文：中文简体（中文平台默认）

posterType（海报类型）

根据市场区域选择：

跨境电商 → posterType=5，语种默认 英文
中文电商 → posterType=6，语种默认 中文简体

aspectRatio（图片比例）

正方形：1:1
横版：3:2、4:3、16:9、21:9
竖版：2:3、3:4、4:5、5:4、9:16
未提及比例 → 不传此字段（API 自动随机选择）

detailPictureNumber（图片数量）

产品单图（generateType=100）：固定为 1
白底主图（generateType=101）：白底单图固定为 1，白底详情图可选 5、10 或 15
产品详情图（generateType=200）：5、10 或 15

fileUrlList（参考图片）

数组格式，最多6张
每个链接都应为公网可访问的图片直链
如果用户提供本地文件路径，先按「本地文件上传」章节换取公网直链，再填入此参数

modelEdition（模型类型）

2：Flyelep 2.0（posterType=5 时为 gemini-2.5，posterType=6 时为 doubao-seedream）
3：Flyelep 3.0（gemini-3.1），服务端在不传此字段时的兜底值
9：Flyelep Image 2，本技能的默认模型
用户未指定模型时一律显式传 "modelEdition": 9，不要省略该字段——省略会被服务端按 3 处理，与本技能的默认不一致

channel（通道）

promotion：特惠通道，本技能的默认通道，线路更经济，仅支持 modelEdition 为 3（Flyelep 3.0）或 9（Flyelep Image 2）
premium：尊享通道，官方专线，支持全部模型

默认规则：用户没有指定通道时，一律显式传 "channel": "promotion"。 默认模型 modelEdition=9（Flyelep Image 2）在特惠通道的支持范围内，两者可以直接组合。

只有这两种情况才传 premium：

用户明确要求走尊享通道
本次要用 modelEdition=2（Flyelep 2.0），特惠通道不支持该模型

显式传 promotion 又搭配 modelEdition=2 时，接口会直接报错拒绝，不会自动降级，所以选模型和选通道必须一起决定：一旦用户要求 Flyelep 2.0，通道就要跟着改成 premium。

完全不传 channel 时，服务端也是按特惠通道处理，并且在模型不支持特惠时自动回落尊享。但显式传值能让通道和计费可预期，因此按上面的规则明确传入，不要依赖服务端兜底。

异步任务流程

重要：走 generateAsync 时必须先调用主接口获取 agentGenerateTaskId，然后调用 queryTaskResult 接口轮询任务结果，不能省略轮询步骤。

调用主接口（generateAsync）提交任务，从响应中获取 agentGenerateTaskId
使用 agentGenerateTaskId 调用 queryTaskResult 接口轮询任务结果（建议每 5-10 秒查询一次）
当 taskStatus=2 时，表示生成成功，获取 executeResult 结果
当 taskStatus=3 时，表示生成失败

同步任务流程

调用 /generate（白底主图可用 /whiteBgMainImgGen），Body 与异步模式完全一致
把客户端超时设到 900 秒以上，请求会一直挂住等出图，中途没有任何进度反馈
响应返回后先看 code：非 200 时按 msg 处理，不要把 msg 当成图片结果
code=200 时把 data 按英文分号 ; 拆分，过滤掉空片段和非 http 开头的片段，剩下的就是图片 URL
逐个展示图片 URL 给用户

连接断开就拿不回结果：同步接口不返回任务 ID，客户端超时、网关断连或进程退出后，这次生成的结果无法再查询（算力照常扣除）。需要可靠拿到结果时改用异步模式。

本地文件上传

用户提供的是本地文件路径而不是公网直链时，先把文件上传换取直链，再调用本接口。已安装 file-upload 技能时以该技能为准；未安装时按下面的说明直接调用上传接口。

URL: POST https://www.flyelep.cn/prod-api/poster-design/api/v1/file/upload
请求方式: multipart/form-data，文件字段名固定为 file，单次只能上传一个文件，多个文件并发调用多次
认证方式: 请求头传 secretKey，与本技能使用同一个密钥
超时时间: 图片建议 60-120 秒
不要手动设置 Content-Type 请求头，让 HTTP 客户端自动生成带 boundary 的值，手写会导致服务端解析失败
图片仅支持 bmp、gif、jpg、jpeg、png，webp 需先转成 png 或 jpg；文件名必须带正确后缀，服务端靠它判断格式
原文件名不会出现在 URL 里，中文名、空格、特殊字符都能直接上传，不需要提前改名
上传不消耗算力，但服务端不做去重：同一个文件在一次任务里只上传一次，记下 fullPath 复用

成功响应取 data.fullPath 作为公网直链，永久有效、不带签名：

{
  "code": 200,
  "msg": null,
  "data": {
    "relativePath": "cos_ai_agent/2026-08-11/3f2a9c1b7d84e6f5a012.png",
    "fullPath": "https://agent-1404002717.cos.ap-guangzhou.myqcloud.com/cos_ai_agent/2026-08-11/3f2a9c1b7d84e6f5a012.png",
    "serviceProvider": null
  }
}

判断成功只看 code，业务失败时 HTTP 状态码仍是 200，code 为 500 或 9999，原因在 msg 里。

# Windows/PowerShell（用 curl.exe，PowerShell 里的 curl 是 Invoke-WebRequest 的别名）
curl.exe -X POST "https://www.flyelep.cn/prod-api/poster-design/api/v1/file/upload" -H "secretKey: 你的密钥" --max-time 120 -F "file=@C:/path/to/product.png"

# macOS/Linux
curl -X POST "https://www.flyelep.cn/prod-api/poster-design/api/v1/file/upload" -H "secretKey: 你的密钥" --max-time 120 -F "file=@./product.png"

图片入桶前会先过内容审核，审核不通过整个请求失败，需换图重试。拿到 code=9999、msg 为 服务繁忙，请稍后再试 时，先自查三项：是否漏了 secretKey 请求头、表单字段名是否为 file、文件是否超出服务端体积上限。密钥、格式、审核、体积类错误重试无效，只有网络超时、5xx 和存储类异常值得重试。

调用示例

跨平台调用说明：

请求头必须包含 Content-Type: application/json; charset=utf-8 和 secretKey

Windows/PowerShell：因 GBK 编码问题，必须先将 JSON 写入临时文件 payload_temp.json（UTF-8 无 BOM），再用 curl.exe --% --data-binary @payload_temp.json 发送请求。使用 Write 工具创建文件，或用 .NET API [System.IO.File]::WriteAllText("payload_temp.json", $json, [System.Text.UTF8Encoding]::new($false))。调用后用 rm payload_temp.json 清理。

macOS/Linux：bash/zsh 默认 UTF-8，可直接内联 JSON：curl -X POST URL -H "Content-Type: application/json; charset=utf-8" --data-binary 'JSON单行内容'（按需追加 -H "secretKey: 你的密钥"）

示例 1：生成产品主图（跨境电商，Amazon）

步骤 1：创建任务

Windows/PowerShell：

创建 payload_temp.json（两种方式任选其一）：

方式 A（使用 Write 工具）：

{
  "query": "为这个蓝牙耳机生成一张产品主图",
  "generateType": 100,
  "posterType": 5,
  "platformType": "Amazon",
  "languageType": "英文",
  "detailPictureNumber": 1,
  "modelEdition": 9,
  "channel": "promotion",
  "needText": true,
  "secretKey": "你的密钥"
}

方式 B（无 Write 工具，PowerShell 执行）：

[System.IO.File]::WriteAllText("payload_temp.json", '{"query":"为这个蓝牙耳机生成一张白底产品主图","generateType":100,"posterType":5,"platformType":"Amazon","languageType":"英文","detailPictureNumber":1,"modelEdition":9,"channel":"promotion","needText":true,"secretKey":"你的密钥"}', [System.Text.UTF8Encoding]::new($false))

执行请求：

curl.exe --% -X POST "https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/generateAsync" -H "Content-Type: application/json; charset=utf-8" --max-time 120 --data-binary @payload_temp.json

清理临时文件：

rm payload_temp.json

macOS/Linux：

curl -X POST "https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/generateAsync" -H "Content-Type: application/json; charset=utf-8" --max-time 120 --data-binary '{"query":"为这个蓝牙耳机生成一张白底产品主图","generateType":100,"posterType":5,"platformType":"Amazon","languageType":"英文","detailPictureNumber":1,"modelEdition":9,"channel":"promotion","needText":true,"secretKey":"你的密钥"}'

步骤 2：查询任务结果

Windows/PowerShell：

创建 payload_temp.json（两种方式任选其一）：

方式 A（使用 Write 工具）：

{
  "agentGenerateTaskId": "上一步返回的任务ID"
}

方式 B（无 Write 工具，PowerShell 执行）：

[System.IO.File]::WriteAllText("payload_temp.json", '{"agentGenerateTaskId":"上一步返回的任务ID"}', [System.Text.UTF8Encoding]::new($false))

执行请求：

curl.exe --% -X POST "https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/queryTaskResult" -H "Content-Type: application/json; charset=utf-8" -H "secretKey: 你的密钥" --max-time 30 --data-binary @payload_temp.json

清理临时文件：

rm payload_temp.json

macOS/Linux：

curl -X POST "https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/queryTaskResult" -H "Content-Type: application/json; charset=utf-8" -H "secretKey: 你的密钥" --max-time 30 --data-binary '{"agentGenerateTaskId":"上一步返回的任务ID"}'

步骤 3：处理结果

轮询查询直到 taskStatus=2（生成成功），提取 executeResult 中的图片 URL 展示给用户。

示例 2：生成产品详情图（带参考图）

前置步骤：向用户索取图片路径或 URL。如用户提供本地文件，先按「本地文件上传」章节换取公网直链。

步骤 1：创建任务

Windows/PowerShell：

创建 payload_temp.json（两种方式任选其一）：

方式 A（使用 Write 工具）：

{
  "query": "根据上传的图片生成对应的产品图",
  "generateType": 200,
  "posterType": 5,
  "platformType": "Amazon",
  "languageType": "英文",
  "detailPictureNumber": 5,
  "modelEdition": 9,
  "channel": "promotion",
  "needText": true,
  "secretKey": "你的密钥",
  "fileUrlList": ["https://example.com/product1.png", "https://example.com/product2.png"],
  "aspectRatio": "1:1"
}

方式 B（无 Write 工具，PowerShell 执行）：

[System.IO.File]::WriteAllText("payload_temp.json", '{"query":"根据上传的图片生成对应的产品图","generateType":200,"posterType":5,"platformType":"Amazon","languageType":"英文","detailPictureNumber":5,"modelEdition":9,"channel":"promotion","needText":true,"secretKey":"你的密钥","fileUrlList":["https://example.com/product1.png","https://example.com/product2.png"],"aspectRatio":"1:1"}', [System.Text.UTF8Encoding]::new($false))

执行请求：

curl.exe --% -X POST "https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/generateAsync" -H "Content-Type: application/json; charset=utf-8" --max-time 120 --data-binary @payload_temp.json

清理临时文件：

rm payload_temp.json

macOS/Linux：

curl -X POST "https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/generateAsync" -H "Content-Type: application/json; charset=utf-8" --max-time 120 --data-binary '{"query":"根据上传的图片生成对应的产品图","generateType":200,"posterType":5,"platformType":"Amazon","languageType":"英文","detailPictureNumber":5,"modelEdition":9,"channel":"promotion","needText":true,"secretKey":"你的密钥","fileUrlList":["https://example.com/product1.png","https://example.com/product2.png"],"aspectRatio":"1:1"}'

步骤 2：查询任务结果

Windows/PowerShell：

创建 payload_temp.json（两种方式任选其一）：

方式 A（使用 Write 工具）：

{
  "agentGenerateTaskId": "上一步返回的任务ID"
}

方式 B（无 Write 工具，PowerShell 执行）：

[System.IO.File]::WriteAllText("payload_temp.json", '{"agentGenerateTaskId":"上一步返回的任务ID"}', [System.Text.UTF8Encoding]::new($false))

执行请求：

curl.exe --% -X POST "https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/queryTaskResult" -H "Content-Type: application/json; charset=utf-8" -H "secretKey: 你的密钥" --max-time 30 --data-binary @payload_temp.json

清理临时文件：

rm payload_temp.json

macOS/Linux：

curl -X POST "https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/queryTaskResult" -H "Content-Type: application/json; charset=utf-8" -H "secretKey: 你的密钥" --max-time 30 --data-binary '{"agentGenerateTaskId":"上一步返回的任务ID"}'

步骤 3：处理结果

轮询查询直到 taskStatus=2（生成成功），提取 executeResult 中的图片 URL 展示给用户。

示例 3：中文电商主图（淘宝，中文简体）

步骤 1：创建任务

Windows/PowerShell：

创建 payload_temp.json（两种方式任选其一）：

方式 A（使用 Write 工具）：

{
  "query": "为这款智能手表生成一张电商主图，突出科技感",
  "generateType": 100,
  "posterType": 6,
  "platformType": "淘宝",
  "languageType": "中文简体",
  "detailPictureNumber": 1,
  "modelEdition": 9,
  "channel": "promotion",
  "needText": true,
  "secretKey": "你的密钥",
  "aspectRatio": "1:1"
}

方式 B（无 Write 工具，PowerShell 执行）：

[System.IO.File]::WriteAllText("payload_temp.json", '{"query":"为这款智能手表生成一张电商主图，突出科技感","generateType":100,"posterType":6,"platformType":"淘宝","languageType":"中文简体","detailPictureNumber":1,"modelEdition":9,"channel":"promotion","needText":true,"secretKey":"你的密钥","aspectRatio":"1:1"}', [System.Text.UTF8Encoding]::new($false))

执行请求：

curl.exe --% -X POST "https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/generateAsync" -H "Content-Type: application/json; charset=utf-8" --max-time 120 --data-binary @payload_temp.json

清理临时文件：

rm payload_temp.json

macOS/Linux：

curl -X POST "https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/generateAsync" -H "Content-Type: application/json; charset=utf-8" --max-time 120 --data-binary '{"query":"为这款智能手表生成一张电商主图，突出科技感","generateType":100,"posterType":6,"platformType":"淘宝","languageType":"中文简体","detailPictureNumber":1,"modelEdition":9,"channel":"promotion","needText":true,"secretKey":"你的密钥","aspectRatio":"1:1"}'

步骤 2：查询任务结果

Windows/PowerShell：

创建 payload_temp.json（两种方式任选其一）：

方式 A（使用 Write 工具）：

{
  "agentGenerateTaskId": "上一步返回的任务ID"
}

方式 B（无 Write 工具，PowerShell 执行）：

[System.IO.File]::WriteAllText("payload_temp.json", '{"agentGenerateTaskId":"上一步返回的任务ID"}', [System.Text.UTF8Encoding]::new($false))

执行请求：

curl.exe --% -X POST "https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/queryTaskResult" -H "Content-Type: application/json; charset=utf-8" -H "secretKey: 你的密钥" --max-time 30 --data-binary @payload_temp.json

清理临时文件：

rm payload_temp.json

macOS/Linux：

curl -X POST "https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/queryTaskResult" -H "Content-Type: application/json; charset=utf-8" -H "secretKey: 你的密钥" --max-time 30 --data-binary '{"agentGenerateTaskId":"上一步返回的任务ID"}'

步骤 3：处理结果

轮询查询直到 taskStatus=2（生成成功），提取 executeResult 中的图片 URL 展示给用户。

示例 4：生成白底主图（generateType=101）

注意：白底主图不需要 platformType、languageType、needText 参数。

前置步骤：向用户索取图片路径或 URL。如用户提供本地文件，先按「本地文件上传」章节换取公网直链。

步骤 1：创建任务

Windows/PowerShell：

创建 payload_temp.json（无 platformType/languageType/needText，两种方式任选其一）：

方式 A（使用 Write 工具）：

{
  "query": "生成一张蓝牙耳机白底产品主图，产品居中，背景纯白",
  "generateType": 101,
  "posterType": 5,
  "detailPictureNumber": 1,
  "modelEdition": 9,
  "channel": "promotion",
  "secretKey": "你的密钥",
  "aspectRatio": "1:1"
}

方式 B（无 Write 工具，PowerShell 执行）：

[System.IO.File]::WriteAllText("payload_temp.json", '{"query":"生成一张蓝牙耳机白底产品主图，产品居中，背景纯白","generateType":101,"posterType":5,"detailPictureNumber":1,"modelEdition":9,"channel":"promotion","secretKey":"你的密钥","aspectRatio":"1:1"}', [System.Text.UTF8Encoding]::new($false))

执行请求：

curl.exe --% -X POST "https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/generateAsync" -H "Content-Type: application/json; charset=utf-8" -H "secretKey: 你的密钥" --max-time 120 --data-binary @payload_temp.json

清理临时文件：

rm payload_temp.json

macOS/Linux：

curl -X POST "https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/generateAsync" -H "Content-Type: application/json; charset=utf-8" -H "secretKey: 你的密钥" --max-time 120 --data-binary '{"query":"生成一张蓝牙耳机白底产品主图，产品居中，背景纯白","generateType":101,"posterType":5,"detailPictureNumber":1,"modelEdition":9,"channel":"promotion","secretKey":"你的密钥","aspectRatio":"1:1"}'

步骤 2：查询任务结果

Windows/PowerShell：

创建 payload_temp.json（两种方式任选其一）：

方式 A（使用 Write 工具）：

{
  "agentGenerateTaskId": "上一步返回的任务ID"
}

方式 B（无 Write 工具，PowerShell 执行）：

[System.IO.File]::WriteAllText("payload_temp.json", '{"agentGenerateTaskId":"上一步返回的任务ID"}', [System.Text.UTF8Encoding]::new($false))

执行请求（secretKey 在 Header 中）：

curl.exe --% -X POST "https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/queryTaskResult" -H "Content-Type: application/json; charset=utf-8" -H "secretKey: 你的密钥" --max-time 30 --data-binary @payload_temp.json

清理临时文件：

rm payload_temp.json

macOS/Linux：

curl -X POST "https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/queryTaskResult" -H "Content-Type: application/json; charset=utf-8" -H "secretKey: 你的密钥" --max-time 30 --data-binary '{"agentGenerateTaskId":"上一步返回的任务ID"}'

步骤 3：处理结果

轮询查询直到 taskStatus=2（生成成功），提取 executeResult 中的图片 URL 展示给用户。

示例 5：同步模式生成产品主图（一次请求拿到图）

注意：同步模式一个请求就返回图片，不需要查询步骤，但必须把超时设到 900 秒以上。

Windows/PowerShell：

创建 payload_temp.json（两种方式任选其一）：

方式 A（使用 Write 工具）：

{
  "query": "为这个蓝牙耳机生成一张产品主图",
  "generateType": 100,
  "posterType": 5,
  "platformType": "Amazon",
  "languageType": "英文",
  "detailPictureNumber": 1,
  "modelEdition": 9,
  "channel": "promotion",
  "needText": true,
  "secretKey": "你的密钥"
}

方式 B（无 Write 工具，PowerShell 执行）：

[System.IO.File]::WriteAllText("payload_temp.json", '{"query":"为这个蓝牙耳机生成一张产品主图","generateType":100,"posterType":5,"platformType":"Amazon","languageType":"英文","detailPictureNumber":1,"modelEdition":9,"channel":"promotion","needText":true,"secretKey":"你的密钥"}', [System.Text.UTF8Encoding]::new($false))

执行请求（--max-time 960 留出比服务端 900 秒更长的余量）：

curl.exe --% -X POST "https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/generate" -H "Content-Type: application/json; charset=utf-8" -H "secretKey: 你的密钥" --max-time 960 --data-binary @payload_temp.json

清理临时文件：

rm payload_temp.json

macOS/Linux：

curl -X POST "https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/generate" -H "Content-Type: application/json; charset=utf-8" -H "secretKey: 你的密钥" --max-time 960 --data-binary '{"query":"为这个蓝牙耳机生成一张产品主图","generateType":100,"posterType":5,"platformType":"Amazon","languageType":"英文","detailPictureNumber":1,"modelEdition":9,"channel":"promotion","needText":true,"secretKey":"你的密钥"}'

处理结果：把 data 按 ; 拆分，取出以 http 开头的片段作为图片 URL 展示给用户。

示例 6：同步模式生成白底主图（whiteBgMainImgGen）

注意：该入口会强制 generateType=101，Body 中不必再传；同样不需要 platformType、languageType、needText。

Windows/PowerShell：

创建 payload_temp.json（两种方式任选其一）：

方式 A（使用 Write 工具）：

{
  "query": "生成一张蓝牙耳机白底产品主图，产品居中，背景纯白",
  "posterType": 5,
  "detailPictureNumber": 1,
  "modelEdition": 9,
  "channel": "promotion",
  "secretKey": "你的密钥",
  "aspectRatio": "1:1"
}

方式 B（无 Write 工具，PowerShell 执行）：

[System.IO.File]::WriteAllText("payload_temp.json", '{"query":"生成一张蓝牙耳机白底产品主图，产品居中，背景纯白","posterType":5,"detailPictureNumber":1,"modelEdition":9,"channel":"promotion","secretKey":"你的密钥","aspectRatio":"1:1"}', [System.Text.UTF8Encoding]::new($false))

执行请求：

curl.exe --% -X POST "https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/whiteBgMainImgGen" -H "Content-Type: application/json; charset=utf-8" -H "secretKey: 你的密钥" --max-time 960 --data-binary @payload_temp.json

清理临时文件：

rm payload_temp.json

macOS/Linux：

curl -X POST "https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/whiteBgMainImgGen" -H "Content-Type: application/json; charset=utf-8" -H "secretKey: 你的密钥" --max-time 960 --data-binary '{"query":"生成一张蓝牙耳机白底产品主图，产品居中，背景纯白","posterType":5,"detailPictureNumber":1,"modelEdition":9,"channel":"promotion","secretKey":"你的密钥","aspectRatio":"1:1"}'

常见错误及解决方案

错误	原因与解决
HTTP 405 Not Allowed	URL 路径错误，确保包含 `/prod-api` 前缀
code 500 "当前并发请求过多"	服务繁忙，稍后重试
HTTP 401	密钥无效或已过期，在 Flyelep 平台重新生成
查询结果 taskStatus 一直为 1	生图任务仍在进行中，继续轮询或稍后重试
查询结果 taskStatus 为 3	生图失败，检查参数是否正确或稍后重试
描述超过1000字符	缩短 query 内容
同步模式 `msg` 为 `任务执行超时，请稍后重试`	生成超过服务端 15 分钟上限，改用异步模式或减少 `detailPictureNumber`
同步模式 `msg` 为 `任务执行失败: xxx`	工作流执行报错，按 `xxx` 排查参数或稍后重试
同步模式客户端先超时断开	`--max-time` 小于服务端 900 秒上限，调大超时；结果无法找回，需重新生成
同步模式 `data` 拆分后没有图片 URL	工作流本次未输出图片，改用异步模式提交并用 `queryTaskResult` 确认任务状态
`生图类型不能为空`	`/generate` 与 `/generateAsync` 必须传 `generateType`；用 `/whiteBgMainImgGen` 时可不传

执行流程

向用户询问 secretKey（API 密钥必须由用户提供，agent 不可自行填写）
收集用户的生成需求并写入 query
确定目标平台 platformType，再按「平台联动规则」推导 posterType 与 languageType：中文平台（淘宝、拼多多、京东、1688、小红书等）→ posterType=6 + languageType=中文简体；跨境平台（Amazon、Temu、Shopee、TikTok Shop 等）→ posterType=5 + languageType=英文。用户显式指定语种时以用户为准
选择 generateType：100=产品单图，101=白底主图，200=产品详情图
设置参数：detailPictureNumber、needText、aspectRatio 等；modelEdition 用户未指定时显式传 9（Flyelep Image 2）
设置通道 channel：默认传 promotion（特惠通道）；用户要求尊享通道或需要 modelEdition=2 时才传 premium
如用户提供参考图，收集图片 URL 写入 fileUrlList（本地文件先按「本地文件上传」章节换取公网直链）
在请求头中传入 secretKey
选择调用模式：默认异步；用户明确要求"一次请求出图"时才用同步
异步模式：调用 /generateAsync 读取任务 ID → 轮询 /queryTaskResult 直到 taskStatus=2 → 取 executeResult
同步模式：调用 /generate（白底主图可用 /whiteBgMainImgGen），超时设 900 秒以上 → 把 data 按 ; 拆分取出图片 URL
将生成的图片逐个展示给用户

提示词处理：

基于参考图生成：将用户的产品描述传入 query，通过 fileUrlList 附上参考图片 URL。仅在描述明显不足时才优化
无参考图生成：在 query 中描述产品、风格和构图
保留用户的创意意图。当用户描述模糊时，根据上下文（平台、语言等）推断合理的默认值

generate-poster

安装技能

Flyelep 电商海报生图

两种调用模式

API 接口信息

创建任务（异步，推荐）

查询结果（仅异步模式需要）

创建任务（同步）

请求 Body

generateType=100/200（产品单图/详情图）

generateType=101（白底主图）

查询结果

响应格式

创建任务响应（异步模式）

创建任务响应（同步模式）

查询结果响应

参数说明

必传参数

可选参数

参数映射规则

平台联动规则（先定平台，再推导 posterType 和 languageType）

platformType（电商平台）

languageType（文案语种）

posterType（海报类型）

aspectRatio（图片比例）

detailPictureNumber（图片数量）

fileUrlList（参考图片）

modelEdition（模型类型）

channel（通道）

异步任务流程

同步任务流程

本地文件上传

调用示例

示例 1：生成产品主图（跨境电商，Amazon）

步骤 1：创建任务

步骤 2：查询任务结果

步骤 3：处理结果

示例 2：生成产品详情图（带参考图）

步骤 1：创建任务

步骤 2：查询任务结果

步骤 3：处理结果

示例 3：中文电商主图（淘宝，中文简体）

步骤 1：创建任务

步骤 2：查询任务结果

步骤 3：处理结果

示例 4：生成白底主图（generateType=101）

步骤 1：创建任务

步骤 2：查询任务结果

步骤 3：处理结果

示例 5：同步模式生成产品主图（一次请求拿到图）

示例 6：同步模式生成白底主图（whiteBgMainImgGen）

常见错误及解决方案

执行流程