Flyelep 电商海报生图#

通过 Flyelep AI API 生成电商产品主图和详情图海报。 重要：这是一个 HTTP API 调用技能。必须通过 HTTP POST 请求调用 API 接口，禁止通过浏览器访问 Flyelep 网站。

API 接口信息#

• URL: POST https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/generate
• Content-Type: application/json
• 超时时间: 建议 300-600 秒（生图需要较长时间）

认证方式#

在请求 JSON body 的 secretKey 字段中传入 API 密钥。用户需在 Flyelep 平台（ https://www.flyelep.cn）获取密钥。

安全说明：将 secretKey 放在 JSON body 中是 Flyelep API 的设计要求，该 API 不支持 header 认证方式。API 密钥仅在请求时传递给 Flyelep 服务器，不存储在技能代码中。请勿将真实的密钥直接写在示例代码中，运行时由用户动态提供。

请求 Body#

json

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

响应格式#

成功：

json

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

data 中多张图片 URL 以分号 ; 分隔。将分号分隔的 URL 拆分后逐个展示给用户，不要回读图片内容。 失败：

json

{
  "code": 500,
  "msg": "错误信息"
}

参数说明#

必传参数#

字段默认值说明query-生图需求描述，最多1000个字符generateType200100=产品单图，200=产品详情图posterType55=跨境电商，6=中文电商platformTypeamazon电商平台（见下方映射表）languageType英文生成图片上的文案语种detailPictureNumber10产品单图固定为1；详情图可选5、10、15modelEdition32=Flyelep 2.0，3=Flyelep 3.0needTexttrue图片上是否包含文案secretKey-API 密钥

可选参数#

字段默认值说明fileUrlList-参考图片 URL 数组，最多6张aspectRatio随机图片比例：1:1、3:2、2:3、3:4、4:3、4:5、5:4、9:16、16:9、21:9

参数映射规则#

platformType（电商平台）#

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

languageType（文案语种）#

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

posterType（海报类型）#

根据市场区域选择，再搭配 modelEdition：

• 跨境电商 → 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=200）： 5、 10 或 15

调用示例#

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

bash

curl -X POST "https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/generate" \
  -H "Content-Type: application/json" \
  --max-time 600 \
  -d '{
    "query": "为这个蓝牙耳机生成一张白底产品主图",
    "generateType": 100,
    "posterType": 5,
    "platformType": "amazon",
    "languageType": "英文",
    "detailPictureNumber": 1,
    "modelEdition": 3,
    "needText": true,
    "secretKey": "你的密钥"
  }'

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

bash

curl -X POST "https://www.flyelep.cn/prod-api/poster-design/api/v1/poster/generate" \
  -H "Content-Type: application/json" \
  --max-time 600 \
  -d '{
    "query": "根据上传的图片生成对应的产品图",
    "generateType": 200,
    "posterType": 5,
    "platformType": "amazon",
    "languageType": "英文",
    "detailPictureNumber": 5,
    "modelEdition": 3,
    "needText": true,
    "secretKey": "你的密钥",
    "fileUrlList": ["https://example.com/product1.png", "https://example.com/product2.png"],
    "aspectRatio": "1:1"
  }'

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

bash

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

常见错误及解决方案#

错误原因与解决HTTP 405 Not AllowedURL 路径错误，确保包含 /prod-api 前缀code 500 "当前并发请求过多"服务繁忙，稍后重试HTTP 401密钥无效或已过期，在 Flyelep 平台重新生成请求超时生图最多需要5分钟，增大超时时间data 为空生图任务在排队中，稍后重试描述超过1000字符缩短 query 内容

提示词处理#

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