139 lines
3.7 KiB
Markdown
139 lines
3.7 KiB
Markdown
# 亚马逊产品图生成工作流
|
||
|
||
这是一个基于Node.js的自动化工作流，用于通过速创API生成亚马逊所需的主图和产品图。
|
||
|
||
## 功能特性
|
||
|
||
- ✅ 自动生成亚马逊主图（白底图、生活场景图）
|
||
- ✅ 自动生成亚马逊产品图（细节图、使用场景图、功能展示图）
|
||
- ✅ 定时查询图片生成状态
|
||
- ✅ 自动下载并保存生成的图片
|
||
- ✅ 支持批量处理多个图片生成任务
|
||
|
||
## 安装依赖
|
||
|
||
```bash
|
||
npm install
|
||
```
|
||
|
||
## 配置说明
|
||
|
||
1. 复制环境变量示例文件：
|
||
```bash
|
||
# Windows
|
||
copy config.example.env .env
|
||
|
||
# Linux/Mac
|
||
cp config.example.env .env
|
||
```
|
||
|
||
2. 编辑 `.env` 文件，配置以下参数：
|
||
|
||
```env
|
||
# 必填：API密钥（在速创API控制台->密钥管理查看）
|
||
API_KEY=your_api_key_here
|
||
|
||
# 必填：源图片URL（需要将P1191464.JPG上传到图床服务，获取外网可访问的URL）
|
||
SOURCE_IMAGE_URL=https://your-image-host.com/P1191464.JPG
|
||
|
||
# 可选：图片尺寸 (1K/2K/4K)
|
||
IMAGE_SIZE=2K
|
||
|
||
# 可选：图片比例 (1:1/16:9/4:3等)
|
||
ASPECT_RATIO=1:1
|
||
|
||
# 可选：查询间隔（毫秒）
|
||
QUERY_INTERVAL=5000
|
||
|
||
# 可选：最大查询次数
|
||
MAX_QUERY_COUNT=60
|
||
```
|
||
|
||
## 使用说明
|
||
|
||
### 1. 准备源图片
|
||
|
||
由于API要求图片URL必须是外网可访问的链接，您需要：
|
||
|
||
- 将 `P1191464.JPG` 上传到图床服务（如：Imgur、SM.MS、七牛云等）
|
||
- 获取图片的公开访问URL
|
||
- 将URL填入 `.env` 文件的 `SOURCE_IMAGE_URL`
|
||
|
||
### 2. 配置API密钥
|
||
|
||
在速创API控制台的密钥管理页面获取您的API密钥，填入 `.env` 文件。
|
||
|
||
### 3. 运行工作流
|
||
|
||
```bash
|
||
npm start
|
||
```
|
||
|
||
## 生成图片说明
|
||
|
||
工作流会自动生成以下类型的图片：
|
||
|
||
### 主图（Main Images）
|
||
- `main_image_white_bg.jpg` - 白底主图
|
||
- `main_image_lifestyle.jpg` - 生活场景主图
|
||
|
||
### 产品图（Product Images）
|
||
- `product_detail_1.jpg` - 产品细节图1
|
||
- `product_detail_2.jpg` - 产品细节图2
|
||
- `product_in_use.jpg` - 产品使用场景图
|
||
- `product_features.jpg` - 产品功能展示图
|
||
|
||
所有生成的图片将保存在 `img_2` 文件夹中。
|
||
|
||
## API接口说明
|
||
|
||
### 生图接口
|
||
- 文档：https://api.wuyinkeji.com/doc/43
|
||
- 接口：`POST https://api.wuyinkeji.com/api/img/nanoBanana-pro`
|
||
|
||
### 查询接口
|
||
- 文档：https://api.wuyinkeji.com/doc/9
|
||
- 接口：`GET https://api.wuyinkeji.com/api/img/drawDetail`
|
||
- 请求方式：HTTP GET
|
||
- 请求参数：
|
||
- `id` (必填, int类型) - 图片ID（从生图接口返回）
|
||
- 请求头：
|
||
- `Content-Type: application/json;charset:utf-8;`
|
||
- `Authorization: 接口密钥`
|
||
- 响应格式：
|
||
- `code`: 状态码（200表示成功）
|
||
- `msg`: 状态信息
|
||
- `data.status`: 图片生成状态
|
||
- `0`: 排队中
|
||
- `1`: 生成中
|
||
- `2`: 成功（此时 `data.image_url` 包含图片地址）
|
||
- `3`: 失败
|
||
- `data.image_url`: 生成的图片地址（仅当 status=2 时返回）
|
||
- `data.prompt`: 生成时使用的提示词
|
||
- `data.size`: 图片比例
|
||
- `data.created_at`: 创建时间
|
||
- `data.updated_at`: 更新时间
|
||
|
||
## 常见问题
|
||
|
||
### Q: 如何修改生成的图片类型？
|
||
A: 编辑 `index.js` 文件中的 `MAIN_IMAGE_PROMPTS` 和 `PRODUCT_IMAGE_PROMPTS` 数组，修改或添加prompt模板。
|
||
|
||
### Q: 查询接口已根据官方文档配置
|
||
A: 查询接口已完全按照 [官方文档](https://api.wuyinkeji.com/doc/9) 实现，支持状态码 0-3 的完整处理流程。
|
||
|
||
### Q: 如何调整查询频率？
|
||
A: 修改 `.env` 文件中的 `QUERY_INTERVAL` 参数（单位：毫秒）。
|
||
|
||
## 注意事项
|
||
|
||
1. 确保API密钥有效且有足够的余额
|
||
2. 源图片URL必须是外网可访问的HTTPS链接
|
||
3. 图片生成可能需要较长时间，请耐心等待
|
||
4. 建议在测试环境先运行，确认配置正确后再批量生成
|
||
|
||
## 许可证
|
||
|
||
MIT
|
||
|