开发者 API
使用我们简单直观的 REST API 构建强大的视频应用程序。几分钟内以编程方式创建精美的视频。
快速开始
5 分钟内开始使用 RenderingVideo API。
1. 获取 API Key
从控制台设置中创建 API Key
2. 准备配置
使用 JSON Schema 定义您的视频
3. 发送请求
发送 API 请求并获取您的视频
1 积分 = 1 秒视频
代码示例
真实示例帮助您快速上手。
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" },
"video": { "width": 1920, "height": 1080, "duration": 10 },
"tracks": [{ "type": "visual", "clips": [{ "type": "text", "text": "你好世界", "start": 0, "duration": 5 }] }]
}
}'API 端点
探索我们全面的 API 端点。
POST
/api/v1/video
创建视频渲染任务
提交视频配置并开始渲染。根据视频时长消耗积分。
GET
/api/v1/video
列出所有视频任务
获取您的视频任务分页列表及其当前状态。
GET
/api/v1/video/:taskId
获取任务详情
获取特定视频任务的详细信息，包括状态和 URL。
POST
/api/v1/video/:taskId/render
触发渲染
开始或重新渲染视频任务。支持自定义 Webhook URL 通知。
GET
/api/v1/credits
获取积分余额
检查您当前的积分余额。1 积分 = 1 秒视频。
POST
/api/v1/preview
创建预览链接
创建临时预览链接（7 天有效期）。不消耗积分。
官方 SDK
使用我们的官方 SDK 加速集成。
Python SDK
pip install renderingvideo
from renderingvideo import Client
client = Client(api_key="sk-xxx")
task = client.video.create({
"meta": {"version": "2.0.0"},
"video": {"width": 1920, "height": 1080, "duration": 10},
"tracks": [...]
})
print(task.task_id)Node.js SDK
npm install @renderingvideo/sdk
import { RenderingVideo } from '@renderingvideo/sdk';
const client = new RenderingVideo({ apiKey: 'sk-xxx' });
const task = await client.video.create({
meta: { version: '2.0.0' },
video: { width: 1920, height: 1080, duration: 10 },
tracks: [...]
});
console.log(task.taskId);认证方式
所有 API 请求都需要通过 API Key 进行认证。
认证方式
Authorization 请求头（推荐）
Authorization: Bearer sk-your-api-keyX-API-Key 请求头
X-API-Key: sk-your-api-key查询参数
?api_key=sk-your-api-key安全提示：永远不要在客户端代码中暴露您的 API Key。始终从服务器端发起 API 请求。