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 秒（创建任务为瞬时操作）

请求头示例：

http

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（产品单图/详情图）#

json

{
  "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 参数。

json

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

查询结果#

json

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

响应格式#

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

json

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

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

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

json

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

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

查询结果响应#

json

{
  "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个字符generateType200100=产品单图，101=白底主图，200=产品详情图posterType由平台推导5=跨境电商，6=中文电商。见「平台联动规则」platformTypeamazon电商平台（见下方映射表）。 generateType=101 时不需要languageType由平台推导生成图片上的文案语种：中文平台默认 中文简体，跨境平台默认 英文。 generateType=101 时不需要detailPictureNumber10产品单图限1张；详情图可选5、10、15张modelEdition9模型类型：2=Flyelep 2.0，3=Flyelep 3.0，9=Flyelep Image 2（默认）needTexttrue图片上是否包含文案。 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:9channelpromotion特惠通道（ promotion，默认）/尊享通道（ premium）。特惠通道仅支持 modelEdition 为 3 或 9

参数映射规则#

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

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

用户提到的平台platformTypeposterTypelanguageType 默认值淘宝、天猫、京东、拼多多、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 接口轮询任务结果，不能省略轮询步骤。

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

同步任务流程#

1. 调用 /generate（白底主图可用 /whiteBgMainImgGen），Body 与异步模式完全一致
2. 把客户端超时设到 900 秒以上，请求会一直挂住等出图，中途没有任何进度反馈
3. 响应返回后先看 code：非 200 时按 msg 处理，不要把 msg 当成图片结果
4. code=200 时把 data 按英文分号 ; 拆分，过滤掉空片段和非 http 开头的片段，剩下的就是图片 URL
5. 逐个展示图片 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 作为公网直链，永久有效、不带签名：

json

{
  "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 里。

bash

# 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 工具）：

json

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

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

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))

执行请求：

bash

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

清理临时文件：

bash

rm payload_temp.json

macOS/Linux：

bash

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 工具）：

json

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

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

powershell

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

执行请求：

bash

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

清理临时文件：

bash

rm payload_temp.json

macOS/Linux：

bash

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 工具）：

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"
}

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

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))

执行请求：

bash

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

清理临时文件：

bash

rm payload_temp.json

macOS/Linux：

bash

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 工具）：

json

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

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

powershell

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

执行请求：

bash

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

清理临时文件：

bash

rm payload_temp.json

macOS/Linux：

bash

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 工具）：

json

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

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

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))

执行请求：

bash

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

清理临时文件：

bash

rm payload_temp.json

macOS/Linux：

bash

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 工具）：

json

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

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

powershell

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

执行请求：

bash

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

清理临时文件：

bash

rm payload_temp.json

macOS/Linux：

bash

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 工具）：

json

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

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

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))

执行请求：

bash

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

清理临时文件：

bash

rm payload_temp.json

macOS/Linux：

bash

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 工具）：

json

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

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

powershell

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

执行请求（secretKey 在 Header 中）：

bash

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

清理临时文件：

bash

rm payload_temp.json

macOS/Linux：

bash

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 工具）：

json

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

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

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 秒更长的余量）：

bash

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

清理临时文件：

bash

rm payload_temp.json

macOS/Linux：

bash

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 工具）：

json

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

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

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))

执行请求：

bash

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

清理临时文件：

bash

rm payload_temp.json

macOS/Linux：

bash

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 AllowedURL 路径错误，确保包含 /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 时可不传

执行流程#

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

提示词处理：

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