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

  1. Sign in to Reelbyte.
  2. Go to Settings → API Keys.
  3. Click Create to generate a new key.
  4. Copy and store it securely (you won’t see it again).

Base URL

https://reelbyte.video

Authentication

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/generate

Example (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/query

Example

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 invalid
  • insufficient credits → add credits in Pricing
  • invalid params → check mediaType, scene, or model

If you need help, contact support@reelbyte.video.