1
产品信息
2
卖点分析
3
营销文案
4
生成图片
第1步:产品基本信息
项目内所有图片将使用此质量生成
选择AI生图的模型
点击或拖拽上传产品参考图
支持 JPG, PNG, GIF, WEBP, HEIC上传期望的风格参考图
仅参考字体样式、颜色搭配、氛围感,不会复制具体文字内容上传品牌Logo
建议PNG透明背景,将作为水印添加到生成的图片上
项目列表
暂无项目
选择项目
风格库
暂无风格参考图
图片生成轮询任务
加载中...
暂无轮询任务
生成图片时会自动创建轮询任务| 类型 | 提示词 | 模型 | 状态 | 耗时 | 操作 |
|---|
API接口文档
AI智能体调用说明
以下API接口可供AI智能体调用,实现自动化电商图片生成流程。
以下API接口可供AI智能体调用,实现自动化电商图片生成流程。
调用顺序(必须按此顺序)
- POST /api/create_project - 创建项目(可设置生成质量)
- POST /api/analyze_selling_points - AI卖点分析
- POST /api/generate_marketing_copy - 生成营销文案
- POST /api/project/<project_name>/upload_reference - 上传产品参考图 ✅必须
- POST /api/generate_style_reference - 生成风格参考图 ✅必须
- POST /api/upload_logo - 上传品牌Logo(可选)
- POST /api/generate_image - 逐张生成图片
- GET /api/project/<project_name> - 获取生成的图片列表
快捷方式:POST /api/ai_full_generate 可一次性完成步骤1-3
第1步 创建项目
POST /api/create_project
创建新项目,设置基本信息和生成质量
请求参数:
product_name | string | ✅ 产品名称 |
selling_points | string | ✅ 产品卖点 |
image_size | string | ❌ 生成质量:1K(默认)/2K/4K |
请求示例:
curl -X POST http://localhost:7419/api/create_project \
-H "Content-Type: application/json" \
-d '{
"product_name": "leeban蒸汽眼罩",
"selling_points": "恒温热敷,缓解眼疲劳\n薰衣草香氛,助眠放松",
"image_size": "2K"
}'
快捷 一站式生成接口
POST /api/ai_full_generate
一次性完成:创建项目 → 卖点分析 → 营销文案生成
请求示例:
curl -X POST http://localhost:7419/api/ai_full_generate \
-H "Content-Type: application/json" \
-d '{
"product_name": "leeban蒸汽眼罩",
"selling_points": "恒温热敷,缓解眼疲劳\n薰衣草香氛,助眠放松\n一次一片,卫生便携",
"image_size": "2K",
"reference_image_urls": ["https://example.com/product.jpg"]
}'
返回示例:
{
"success": true,
"project_name": "20260317_143052_leeban蒸汽眼罩",
"project_folder": "/vol1/1000/iflow/dianshangtupian/products/20260317_143052_leeban蒸汽眼罩",
"selling_points_analysis": "## 卖点提炼结果...",
"marketing_copy": "## 主图文案(共5张)...",
"saved_ref_images": ["ref_1_20260317.png"]
}
注意:保存返回的 project_name 和 project_folder,后续接口需要使用
第2步 AI卖点分析
POST /api/analyze_selling_points
使用AI分析产品卖点,提炼核心卖点
curl -X POST http://localhost:7419/api/analyze_selling_points \
-H "Content-Type: application/json" \
-d '{
"product_name": "leeban蒸汽眼罩",
"selling_points": "恒温热敷,缓解眼疲劳",
"project_folder": "/vol1/.../products/20260317_xxx"
}'
第3步 生成营销文案
POST /api/generate_marketing_copy
生成主图文案(5张)、场景图文案(3张)、详情页文案(14部分)
curl -X POST http://localhost:7419/api/generate_marketing_copy \
-H "Content-Type: application/json" \
-d '{
"product_name": "leeban蒸汽眼罩",
"selling_points_analysis": "## 卖点提炼结果...",
"project_folder": "/vol1/.../products/20260317_xxx"
}'
第4步 上传产品参考图
POST /api/project/<project_name>/upload_reference
上传产品参考图(multipart/form-data)
curl -X POST http://localhost:7419/api/project/20260317_143052_leeban蒸汽眼罩/upload_reference \ -F "file=@/path/to/product.jpg"
提示:参考图用于AI生成时参考产品外观,推荐上传1-3张清晰的产品图
第5步 生成风格参考图
POST /api/generate_style_reference
生成风格文案和风格参考图,确保后续图片风格一致
请求参数:
product_name | string | ✅ 产品名称 |
project_folder | string | ❌ 项目路径 |
image_size | string | ❌ 生成质量:1K/2K/4K |
curl -X POST http://localhost:7419/api/generate_style_reference \
-H "Content-Type: application/json" \
-d '{
"product_name": "leeban蒸汽眼罩",
"project_folder": "/vol1/.../products/20260317_xxx",
"image_size": "2K"
}'
可选 上传品牌Logo
POST /api/upload_logo
上传品牌Logo(multipart/form-data)
curl -X POST http://localhost:7419/api/upload_logo \ -F "project_folder=/vol1/.../products/20260317_xxx" \ -F "logo=@/path/to/logo.png"
提示:建议使用PNG透明背景Logo,会自动添加到生成的图片上
第6步 图片生成接口
POST /api/generate_image
根据营销文案生成指定图片
请求参数:
project_folder | string | ✅ 项目路径 |
image_type | string | ✅ 图片类型(见下表) |
aspect_ratio | string | ❌ 图片比例,默认1:1 |
image_size | string | ❌ 生成质量:1K/2K/4K,不传则使用项目默认值 |
curl -X POST http://localhost:7419/api/generate_image \
-H "Content-Type: application/json" \
-d '{
"project_folder": "/vol1/.../products/20260317_xxx",
"image_type": "main1",
"aspect_ratio": "1:1",
"image_size": "2K"
}'
image_type 可选值:
主图 (1:1)
- main1 - 核心转化图
- main2 - 降低选择难度
- main3 - 购买教学图
- main4 - 售后保障图
- main5 - 品牌背书图
场景图 (9:16)
- scene1 - 使用场景一
- scene2 - 使用场景二
- scene3 - 使用场景三
详情页 (3:4)
- detail1 - 核心卖点总述
- detail2 - 使用场景
- ...detail3-detail14
aspect_ratio 可选值:
1:1 | 9:16 | 3:4 | 16:9 | 4:3
image_size 说明:
1K- 短边约1024像素(推荐,速度快)2K- 短边约2048像素(高清)4K- 短边约4096像素(超高清,耗时较长)
第7步 获取生成结果
GET /api/project/<project_name>
获取项目详情,包含所有生成的图片
curl http://localhost:7419/api/project/20260317_xxx
返回示例:
{
"success": true,
"project_name": "20260317_xxx",
"image_size": "2K",
"selling_points": "...",
"marketing_copy": "...",
"reference_images": ["ref_1.jpg", "ref_2.jpg"],
"generated_images": {
"main1": ["20260317_xxx.png", "20260317_yyy.png"],
"main2": [],
"scene1": ["..."]
}
}
其他接口
| 接口 | 方法 | 说明 |
|---|---|---|
/api/projects |
GET | 获取所有项目列表 |
/api/docs |
GET | 获取API文档(JSON格式) |
AI智能体完整调用示例
# 1. 创建项目并生成文案
response1=$(curl -s -X POST http://localhost:7419/api/ai_full_generate \
-H "Content-Type: application/json" \
-d '{"product_name": "测试产品", "selling_points": "卖点1\n卖点2"}')
project_name=$(echo $response1 | jq -r '.project_name')
project_folder=$(echo $response1 | jq -r '.project_folder')
# 2. 上传参考图(可选)
curl -X POST "http://localhost:7419/api/project/$project_name/upload_reference" \
-F "file=@product.jpg"
# 3. 上传Logo(可选)
curl -X POST http://localhost:7419/api/upload_logo \
-F "project_folder=$project_folder" \
-F "logo=@logo.png"
# 4. 生成图片
curl -X POST http://localhost:7419/api/generate_image \
-H "Content-Type: application/json" \
-d "{\"project_folder\": \"$project_folder\", \"image_type\": \"main1\"}"
# 5. 获取结果
curl "http://localhost:7419/api/project/$project_name"