Files
Amazon_img/README.md
2026-01-03 14:18:48 +08:00

3.7 KiB
Raw Permalink Blame History

亚马逊产品图生成工作流

这是一个基于Node.js的自动化工作流用于通过速创API生成亚马逊所需的主图和产品图。

功能特性

  • 自动生成亚马逊主图(白底图、生活场景图)
  • 自动生成亚马逊产品图(细节图、使用场景图、功能展示图)
  • 定时查询图片生成状态
  • 自动下载并保存生成的图片
  • 支持批量处理多个图片生成任务

安装依赖

npm install

配置说明

  1. 复制环境变量示例文件:
# Windows
copy config.example.env .env

# Linux/Mac
cp config.example.env .env
  1. 编辑 .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. 运行工作流

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/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_PROMPTSPRODUCT_IMAGE_PROMPTS 数组修改或添加prompt模板。

Q: 查询接口已根据官方文档配置

A: 查询接口已完全按照 官方文档 实现,支持状态码 0-3 的完整处理流程。

Q: 如何调整查询频率?

A: 修改 .env 文件中的 QUERY_INTERVAL 参数(单位:毫秒)。

注意事项

  1. 确保API密钥有效且有足够的余额
  2. 源图片URL必须是外网可访问的HTTPS链接
  3. 图片生成可能需要较长时间,请耐心等待
  4. 建议在测试环境先运行,确认配置正确后再批量生成

许可证

MIT