API Documentation
Learn how to create API keys and call the Reelbyte API for video and image generation.
Reelbyte API
Reelbyte gives subscribers shared credits that work both on the web app and the API. Use the API to generate images or videos with your own API key.
Reelbyte is an independent service and is not affiliated with any model provider.
Get Your API Key
- Sign in to Reelbyte.
- Go to
Settings → API Keys. - Click Create to generate a new key.
- Copy and store it securely (you won’t see it again).
Base URL
https://reelbyte.videoAuthentication
Send your API key with either header:
Authorization: Bearer YOUR_API_KEY(recommended)x-api-key: YOUR_API_KEY
Generate (Async)
Create a generation task and poll for completion.
Endpoint
POST /api/v1/ai/generateExample (Text to Video)
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": "bytedance/seedance-1-lite",
"scene": "text-to-video",
"prompt": "A cinematic aerial shot of a neon city at night",
"options": {
"duration": 5,
"resolution": "720p",
"aspect_ratio": "16:9"
}
}'Example (Image to Video)
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": "bytedance/seedance-1-pro",
"scene": "image-to-video",
"prompt": "Subtle camera push-in with gentle motion",
"options": {
"image_input": ["https://cdn.reelbyte.video/uploads/example.png"],
"duration": 5,
"resolution": "1080p",
"aspect_ratio": "16:9"
}
}'Response
{
"code": 0,
"message": "ok",
"data": {
"taskId": "<task-id>",
"status": "pending",
"costCredits": 18
}
}Query Task
Endpoint
POST /api/v1/ai/queryExample
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>" }'Response
{
"code": 0,
"message": "ok",
"data": {
"taskId": "<task-id>",
"status": "success",
"taskInfo": "{...}",
"taskResult": "{...}",
"usage": {
"credits": 18
}
}
}Credit Usage
- Credits are shared across web and API.
- A task will be created only if you have enough credits.
- Failed tasks automatically refund credits.
Common Errors
invalid api key→ key missing or invalidinsufficient credits→ add credits in Pricinginvalid params→ checkmediaType,scene, ormodel
If you need help, contact support@reelbyte.video.