\r \r

ASIN营销视频全自动流水线\r

\r 基于n8n + Topview AI + Apify + Google Sheets 构建的ASIN营销视频自动化解决方案。\r \r

核心工作流\r

\r

ASIN列表 → 产品信息提取 → 图片上传 → 视频生成 → 审核 → 导出成品\r
```\r
\r
### 工作流1：主流程（生成预览视频）\r
1. **读取 & 筛选** - 从Google Sheets读取ASIN列表，跳过已有视频的行\r
2. **提取产品信息** - 通过Apify抓取Amazon产品详情\r
3. **上传图片到Topview** - 将产品图上传至Topview AI\r
4. **提交视频生成任务** - 调用Topview API创建视频任务\r
5. **等待 & 查询** - 等待5分钟后查询任务状态\r
6. **回填链接** - 将预览视频URL写回Google Sheets\r
\r
### 工作流2：导出流程（生成正式版）\r
1. **读取审核通过项** - 从Sheets读取标记为"审核通过"的行\r
2. **获取scriptId** - 用taskId查询任务详情\r
3. **调用导出接口** - 调用 `/v1/m2v/task/export` 导出无水印版\r
4. **等待导出完成** - 等待3分钟查询导出结果\r
5. **回填最终URL** - 将成品视频URL写回Sheets\r
\r
## 快速开始\r
\r
### 前置要求\r
- n8n 实例（本地或云）\r
- Topview AI API Key\r
- Apify API Key\r
- Google Cloud 项目 + Service Account\r
\r
### 1. 配置Google Sheets\r
\r
创建表格，包含以下列：\r
| 列名 | 说明 |\r
|------|------|\r
| ASIN | 亚马逊产品ID |\r
| 产品名称 | 自动填充 |\r
| 产品图片URL | 自动填充 |\r
| 视频链接 | 自动填充 |\r
| 审核状态 | 手动填写：待审核/通过/拒绝 |\r
| 任务ID | 自动填充 |\r
\r
### 2. 导入n8n工作流\r
\r
使用提供的JSON工作流文件：\r
```bash\r
# 工作流1：生成预览视频\r
n8n import:workflow --input=./references/n8n-workflow-preview.json\r
\r
# 工作流2：导出正式版\r
n8n import:workflow --input=./references/n8n-workflow-export.json\r
```\r
\r
### 3. 配置Credentials\r
\r
在n8n中配置以下凭证：\r
- `topviewApiKey` - Topview AI API Key\r
- `apifyApiKey` - Apify API Key  \r
- `googleSheetsOAuth2` - Google Sheets API\r
\r
## Topview AI API 参考\r
\r
### 上传图片\r
```\r
POST /v1/m2v/image/upload\r
Content-Type: multipart/form-data\r
Authorization: Bearer {API_KEY}\r
\r
Body:\r
- image: 图片文件\r
```\r
\r
### 创建视频任务\r
```\r
POST /v1/m2v/task\r
Authorization: Bearer {API_KEY}\r
Content-Type: application/json\r
\r
{\r
  "script_id": "your_script_id",\r
  "images": ["image_url_1", "image_url_2"],\r
  "texts": ["产品卖点文案"],\r
  "callback_url": "https://your-webhook.com"\r
}\r
```\r
\r
### 查询任务状态\r
```\r
GET /v1/m2v/task/{task_id}\r
Authorization: Bearer {API_KEY}\r
```\r
\r
### 导出无水印版\r
```\r
POST /v1/m2v/task/export\r
Authorization: Bearer {API_KEY}\r
Content-Type: application/json\r
\r
{\r
  "task_id": "task_id_to_export",\r
  "script_id": "script_id"\r
}\r
```\r
\r
## 工具清单\r
\r
| 工具 | 用途 |\r
|------|------|\r
| **n8n** | 自动化平台，串联所有步骤 |\r
| **Apify** | 抓取Amazon产品信息 |\r
| **Topview AI** | AI视频生成，图片+文案合成营销视频 |\r
| **Google Sheets** | ASIN列表管理和状态追踪 |\r
\r
## 详细配置指南\r
\r
完整配置步骤和节点说明：[WORKFLOW_SETUP.md](references/WORKFLOW_SETUP.md)\r
\r
## 自动化脚本\r
\r
- `scripts/init_pipeline.py` - 初始化流水线配置\r
- `scripts/validate_setup.py` - 验证配置完整性\r
\r
## 故障排查\r
\r
| 问题 | 解决方案 |\r
|------|---------|\r
| 视频生成失败 | 检查Topview API额度、图片格式是否符合要求 |\r
| Google Sheets连接失败 | 确认Service Account有表格编辑权限 |\r
| 产品信息提取失败 | 检查Apify Actor运行状态、ASIN是否有效 |\r
| 导出超时 | 无水印导出耗时较长，可适当增加等待时间 |\r
\r
## 进阶用法\r
\r
- **批量处理** - 修改n8n Batch节点参数调整并发数\r
- **自定义模板** - 在Topview后台创建品牌专属视频模板\r
- **多语言支持** - 通过Apify提取多语言产品描述\r
- **定时触发** - 使用n8n Schedule节点实现定时批量处理\r