视频号 → 通义听悟转写 → R2 归档

粘贴视频号分享链接，自动下载视频、转写口播文字稿，并把全部产物存入 Cloudflare R2。

API 用法

方法 / 路径	说明
`POST /api/jobs`	提交任务，body 为 `{"url":"视频号链接"}`；返回 id / taskId / status / metadata
`GET /api/jobs/:id`	查询任务；COMPLETED 时返回 transcript 文字稿、chapters 分章、artifacts 产物链接
`GET /api/jobs`	列出全部任务
`GET /files/<key>`	下载 R2 产物，如 `text/<id>.txt`、`result/<id>.json`

命令行示例

# 1) 提交任务
curl -X POST https://shipinhao.8720.top/api/jobs -H "content-type: application/json" -d '{"url":"https://weixin.qq.com/sph/XXXX"}'

# 2) 轮询结果（每 5 秒一次，直到 status=COMPLETED）
curl https://shipinhao.8720.top/api/jobs/XXXX

给 AI / 程序的调用指南

Base URL: https://shipinhao.8720.top
用途：把一条视频号视频转成文字稿（transcript）与结构化数据（作者、文案、互动数、分章）。

调用步骤：
1. 提交：POST /api/jobs，请求体 JSON {"url":"<视频号分享链接>"}。
   响应 {"id","taskId","status":"ONGOING","metadata":{...}}，记下 id。
2. 轮询：每隔 5 秒 GET /api/jobs/<id>，读 status 字段：
   • ONGOING   → 继续等待，再次轮询；
   • COMPLETED → 响应含 transcript（纯文本口播稿）、chapters（自动分章）、
                 artifacts（各产物的 /files 下载路径）；
   • FAILED    → 读 error 字段获取原因。
3. 取文件：GET /files/<key>，例如 text/<id>.txt、result/<id>.json。

约定：id = 视频号短链尾段（如 .../sph/AmenFRYdwJ 的 AmenFRYdwJ）；
      转写通常 20–60 秒完成；所有响应均为 UTF-8 JSON。

R2 产物结构

key	内容
`videos/<id>.mp4`	原视频
`meta/<id>.json`	文案 / 作者 / 互动数据
`text/<id>.txt`	纯文字稿
`transcripts/<id>.json`	听悟原始转写（时间戳 / 说话人）
`chapters/<id>.json`	自动分章
`result/<id>.json`	汇总（元数据 + 文字稿 + 分章）