初始提交

This commit is contained in:
2026-01-03 14:18:48 +08:00
commit 282608a482
7 changed files with 815 additions and 0 deletions

138
README.md Normal file
View 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