generate-poster

# 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个字符 | | 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` 中描述产品、风格和构图。 保留用户的创意意图。当用户描述模糊时，根据上下文（平台、语言等）推断合理的默认值。