📦 Generate Poster通过 — 生成海报通过
v1.0.0Flyelep API 生成电商产品主图和详情图海报。当用户要求生成产品图、电商海报、Amazon 商品图、详情页图片时使用此技能。
by 详细分析 ▾
运行时依赖
版本
- 首次发布“generate-poster”技能，通过 Flyelep API 生成电商商品海报与详情图。 - 支持跨境及国内电商平台（如 Amazon、淘宝），多语言、多海报类型。 - 可深度定制：参考图、文字、画幅比例、平台专属选项等参数任意组合。 - 安全处理 API key：按 Flyelep API 要求，key 置于 JSON body 传输。 - 提供完整文档：API 用法、参数映射、错误处理及示例一应俱全。
安装命令
点击复制技能文档
通过 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个字符 |
| generateType | 200 | 100=产品单图，200=产品详情图 |
| posterType | 5 | 5=跨境电商，6=中文电商 |
| platformType | amazon | 电商平台（见下方映射表） |
| languageType | 英文 | 生成图片上的文案语种 |
| detailPictureNumber | 10 | 产品单图固定为1；详情图可选5、10、15 |
| modelEdition | 3 | 2=Flyelep 2.0，3=Flyelep 3.0 |
| needText | true | 图片上是否包含文案 |
| 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 Allowed | URL 路径错误，确保包含 /prod-api 前缀 |
| code 500 "当前并发请求过多" | 服务繁忙，稍后重试 |
| HTTP 401 | 密钥无效或已过期，在 Flyelep 平台重新生成 |
| 请求超时 | 生图最多需要5分钟，增大超时时间 |
| data 为空 | 生图任务在排队中，稍后重试 |
| 描述超过1000字符 | 缩短 query 内容 | 提示词处理
基于参考图生成：
将用户的产品描述传入 query，通过 fileUrlList 附上参考图片 URL。仅在描述明显不足时才优化。 无参考图生成：
在 query` 中描述产品、风格和构图。
保留用户的创意意图。当用户描述模糊时，根据上下文（平台、语言等）推断合理的默认值。