Rendering Video
程序化视频 API

把视频生成能力接入你的产品。

用 API Key 鉴权接口创建预览链接、渲染最终视频、上传文件并追踪积分。

获取 API Key阅读文档
创建 API Key
在设置页生成 key，并以 Bearer Token 方式发送。
发送 Schema
使用包含 meta、assets、tracks 和 clips 的 RenderingVideo JSON 结构。
预览或渲染
先生成临时预览，确认后再转换为永久渲染任务。

代码示例

同一套 API 可以用于 cURL、Node.js、Python 或任何 HTTP 客户端。

curl -X POST https://your-domain.com/api/v1/video \
  -H "Authorization: Bearer rv_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"config":{"meta":{"version":"2.0.0","width":1280,"height":720,"fps":30},"tracks":[{"clips":[{"type":"text","start":0,"duration":3,"text":"Hello RenderingVideo"}]}]}}'

核心接口

由迁移后的 RenderingVideo 渲染服务支撑的产品 API。

POST/api/v1/preview
创建临时预览
返回播放地址，用于快速校验和评审 schema。
POST/api/v1/video
创建视频任务
保存永久任务，并返回预览和配置地址。
POST/api/v1/video/:taskId/render
触发渲染
扣除积分，启动远端渲染流水线，并追踪状态。
GET/api/v1/files
列出上传文件
在 schema 中复用上传素材，并按用户管理媒体。
鉴权
公开 API 需要在 Authorization 头中携带 API Key。控制台页面继续使用登录会话。