初始提交
This commit is contained in:
138
README.md
Normal file
138
README.md
Normal file
@@ -0,0 +1,138 @@
|
||||
# 亚马逊产品图生成工作流
|
||||
|
||||
这是一个基于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
|
||||
|
||||
Reference in New Issue
Block a user