免费视频预览链接：正式渲染前先把 JSON 视频审清楚

正式渲染之后才发现标题被裁切、图片地址失效或镜头节奏太快，返工成本会很高。更合理的流程是先生成临时预览，在 JSON 仍然容易修改时完成审核。

RenderingVideo 的公开预览接口就是为这个阶段设计的。提交有效的视频 Schema 后，可以得到浏览器直接打开的预览链接，发给同事或客户审核。公开预览无需登录和 API Key，不消耗正式渲染积分，链接通常保留七天。

预览链接是什么

预览是对当前 Schema 的临时交互式呈现，适合检查版式、时序、字体、动画和远程素材。它不是可下载的 MP4，也不适合作为永久存储。

推荐流程如下：

1. 生成或修改 JSON Schema。
2. 提交到公开预览接口。
3. 打开并分享接口返回的 viewer 链接。
4. 根据反馈调整 JSON，再生成新预览。
5. 审核通过后再创建永久任务并启动正式渲染。

创建公开预览

把完整 Schema 直接提交到视频服务，不要再套一层 config。

curl -X POST https://video.renderingvideo.com/api/preview \
  -H "Content-Type: application/json" \
  --data-binary @video.json

成功响应会包含临时 ID 和一个或多个地址。优先使用接口实际返回的 viewerUrl，其次再选择 previewUrl、url 或 playerUrl。有效期也应以响应中的 expiresIn 为准。

正式渲染前检查什么

• 安全区域： 标题和字幕在目标比例下没有贴边或被裁切。
• 时序： 每段文案都留有足够阅读时间。
• 素材： 图片、字体、视频、音频和字幕数据都能从公开地址加载。
• 动效： 动画帮助表达，而不是抢夺注意力。
• 对比度： 每个背景画面上的文字都清晰可读。
• 结尾： 最后的行动提示停留时间足够。

数据驱动的视频还要测试超长名称、缺少可选字段和极端数值。只对理想样例有效的模板，进入真实业务后很容易出问题。

团队如何使用临时链接

开发者可以把预览链接放进 Pull Request，AI Agent 可以在生成 Schema 后返回链接等待人工审核，市场团队也可以在后端触发付费渲染前确认文案和节奏。

链接负责展示结果，JSON 负责保留可编辑的事实来源，两者应一起保存。

什么时候转为永久任务

当内容审核完成、素材地址稳定后，再创建永久任务。认证 API 支持直接从 Schema 创建任务，也支持把临时预览转换成永久任务，然后单独启动渲染。这样产品可以先验证，再在真正批准后消耗积分。

现在可以前往 Playground 修改真实示例并生成可分享链接，或阅读预览与 API 文档了解完整字段。