asin-video-pipeline（asin 视频管道）

ASIN营销视频全自动流水线

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

核心工作流

ASIN列表 → 产品信息提取 → 图片上传 → 视频生成 → 审核 → 导出成品

工作流1：主流程（生成预览视频）

1. 读取 & 筛选 - 从Google Sheets读取ASIN列表，跳过已有视频的行
2. 提取产品信息 - 通过Apify抓取Amazon产品详情
3. 上传图片到Topview - 将产品图上传至Topview AI
4. 提交视频生成任务 - 调用Topview API创建视频任务
5. 等待 & 查询 - 等待5分钟后查询任务状态
6. 回填链接 - 将预览视频URL写回Google Sheets

工作流2：导出流程（生成正式版）

1. 读取审核通过项 - 从Sheets读取标记为"审核通过"的行
2. 获取scriptId - 用taskId查询任务详情
3. 调用导出接口 - 调用 /v1/m2v/task/export 导出无水印版
4. 等待导出完成 - 等待3分钟查询导出结果
5. 回填最终URL - 将成品视频URL写回Sheets

快速开始

前置要求

• n8n 实例（本地或云）
• Topview AI API Key
• Apify API Key
• Google Cloud 项目 + Service Account

1. 配置Google Sheets

创建表格，包含以下列：

2. 导入n8n工作流

使用提供的JSON工作流文件：

# 工作流1：生成预览视频
n8n import:workflow --input=./references/n8n-workflow-preview.json

# 工作流2：导出正式版
n8n import:workflow --input=./references/n8n-workflow-export.json

3. 配置Credentials

在n8n中配置以下凭证：

• topviewApiKey - Topview AI API Key
• apifyApiKey - Apify API Key
• googleSheetsOAuth2 - Google Sheets API

Topview AI API 参考

上传图片

POST /v1/m2v/image/upload
Content-Type: multipart/form-data
Authorization: Bearer {API_KEY}

Body:
- image: 图片文件

创建视频任务

POST /v1/m2v/task
Authorization: Bearer {API_KEY}
Content-Type: application/json

{
  "script_id": "your_script_id",
  "images": ["image_url_1", "image_url_2"],
  "texts": ["产品卖点文案"],
  "callback_url": "https://your-webhook.com"
}

查询任务状态

GET /v1/m2v/task/{task_id}
Authorization: Bearer {API_KEY}

导出无水印版

POST /v1/m2v/task/export
Authorization: Bearer {API_KEY}
Content-Type: application/json

{
  "task_id": "task_id_to_export",
  "script_id": "script_id"
}

工具清单

详细配置指南

完整配置步骤和节点说明：WORKFLOW_SETUP.md

自动化脚本

• scripts/init_pipeline.py - 初始化流水线配置
• scripts/validate_setup.py - 验证配置完整性

故障排查

进阶用法

• 批量处理 - 修改n8n Batch节点参数调整并发数
• 自定义模板 - 在Topview后台创建品牌专属视频模板
• 多语言支持 - 通过Apify提取多语言产品描述
• 定时触发 - 使用n8n Schedule节点实现定时批量处理