程序化视频 API

SDK、Skills 与视频 API

使用官方 SDK、为 AI Agent 安装视频 Skill,或用你自己的 API Key 直接调用 API。

官方 SDK

安装对应语言的 SDK,使用你自己的 API Key 管理视频、预览、文件和积分。

获取 API Key

AI Skills

按需选择无需密钥的临时公开预览,或操作你账户内资源的鉴权工作流。

将 Skill 仓库克隆到 Agent 的 skills 目录,再加载 SKILL.md。具体目录位置请参考所用 Agent 的说明。API Key 应保存在环境变量中。

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

代码示例

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

curl -X POST https://renderingvideo.com/api/v1/video \
  -H "Authorization: Bearer sk-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。控制台页面继续使用登录会话。