文章 / 新闻 → 短视频

输入任意包含实质性正文内容的 URL，自动生成竖版短视频，含配音 + 自动剪辑的免版税库存画面（b-roll）+ 字幕。

适用场景

• 原始素材为新闻报道、长篇博客、新闻稿或议论文。
• 期望输出：一段经过编辑的摘要视频，含配音与视觉素材，时长 30–60 秒。
• 用户不希望使用真人出镜口播形式（如需该效果，请使用 revid-blog-to-avatar-video）。
• 针对电商商品页，请优先选用 revid-shopify-product-promo —— 工作流相同，但默认参数已针对商品推广优化。

输入参数

操作步骤

1. 校验 URL 的有效性。
2. 发送下方所示的请求载荷（payload）。
3. 轮询 /status 接口（详见下方“轮询”章节中的标准轮询循环）。
4. 获取并返回 videoUrl。

API 调用模板

POST /api/public/v3/render
Host: www.revid.ai
Content-Type: application/json
key: $REVID_API_KEY

{
  "workflow": "article-to-video",
  "source": {
    "url": "{ARTICLE_URL}",
    "scrapingPrompt": "Summarize the article body. Skip ads, related links, navigation, and footer."
  },
  "aspectRatio": "9:16",
  "voice":    { "enabled": true, "stability": 0.6, "speed": 1.0, "language": "en-US" },
  "captions": { "enabled": true, "position": "middle", "autoCrop": true },
  "music":    { "enabled": true, "syncWith": "beats" },
  "media": {
    "type": "stock-video",
    "density": "medium",
    "animation": "soft",
    "quality": "pro",
    "videoModel": "pro",
    "imageModel": "good"
  },
  "options": {
    "targetDuration": 45,
    "summarizationPreference": "summarize",
    "soundEffects": true,
    "hasToGenerateCover": true,
    "coverTextType": "headline"
  },
  "render": { "resolution": "1080p", "frameRate": 30 }
}

示例文件

• examples/article-techreview.json
• examples/run.sh

轮询机制

在调用 POST /render 后，持续轮询直至响应中 status === "ready"：

PID=""
while :; do
  R=$(curl -fsSL "https://www.revid.ai/api/public/v3/status?pid=$PID" 
        -H "key: $REVID_API_KEY")
  S=$(echo "$R" | jq -r .status)
  case "$S" in
    ready)  echo "$R" | jq .; break ;;
    failed) echo "FAILED: $R"; exit 1 ;;
    *)      sleep 5 ;;
  esac
done

在生产环境中，建议于请求体中设置 webhookUrl 参数，从而避免主动轮询。

常见失败模式及修复方法

参阅

• revid-shopify-product-promo
• revid-news-to-daily-short：适用于根据指定主题生成新闻短视频，而非对已有 URL 进行摘要。
• revid-pdf-to-video：用于处理 PDF 文件（而非 HTML 页面）。