API 文档
了解如何创建 API Key，并通过 Reelbyte API 生成视频与图片。
Reelbyte API
Reelbyte 的订阅积分在 网页端与 API 端共享。你可以使用 API Key 通过接口发起图片或视频生成任务。
Reelbyte 是独立服务，与任何模型提供商无隶属关系。
获取 API Key
- 登录 Reelbyte。
- 进入
Settings → API Keys。 - 点击 Create 创建新密钥。
- 复制并妥善保存（创建后不会再次完整展示）。
Base URL
https://reelbyte.video鉴权方式
请求头任选其一：
Authorization: Bearer YOUR_API_KEY（推荐）x-api-key: YOUR_API_KEY
发起生成（异步）
先创建任务，再轮询查询任务状态。
接口
POST /api/v1/ai/generate示例（文生视频）
模型 ID 请以你后台可用模型为准。
curl -X POST "https://reelbyte.video/api/v1/ai/generate" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"mediaType": "video",
"provider": "replicate",
"model": "<model-id>",
"scene": "text-to-video",
"prompt": "夜晚霓虹城市的电影感航拍镜头",
"options": {
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9"
}
}'示例（图生视频）
curl -X POST "https://reelbyte.video/api/v1/ai/generate" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"mediaType": "video",
"provider": "replicate",
"model": "<model-id>",
"scene": "image-to-video",
"prompt": "轻微推进镜头与自然运动",
"options": {
"image_input": ["https://cdn.reelbyte.video/uploads/example.png"],
"duration": 5,
"resolution": "1080p",
"aspect_ratio": "16:9"
}
}'返回示例
{
"code": 0,
"message": "ok",
"data": {
"taskId": "<task-id>",
"status": "pending",
"costCredits": 18
}
}查询任务状态
接口
POST /api/v1/ai/query示例
curl -X POST "https://reelbyte.video/api/v1/ai/query" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "taskId": "<task-id>" }'返回示例
{
"code": 0,
"message": "ok",
"data": {
"taskId": "<task-id>",
"status": "succeeded",
"output": [
"https://cdn.reelbyte.video/output/xxx.mp4"
]
}
}常见状态
pending: 已创建，等待执行processing: 生成中succeeded: 生成成功failed: 生成失败
错误处理建议
code !== 0视为失败，读取message作为错误原因。- 对
pending/processing任务使用轮询（如每 2-5 秒查询一次）。 - 对网络超时、429、5xx 实现指数退避重试。
积分说明
- 仅任务成功时扣除积分。
- 消耗积分与模型、时长、分辨率相关。
- 余额不足时会返回相应错误。
安全建议
- 仅在服务端保存和使用 API Key。
- 不要把 API Key 暴露到前端代码或公开仓库。
- 定期轮换密钥，并撤销不再使用的密钥。