Documentation Menu

Quickstart

Rendobar lets you process videos with a single API call. This guide walks you through creating an API key, submitting a job, checking its status, and downloading the output.

Prerequisites

You need a Rendobar account. Sign up at app.rendobar.com to get started with 5 free credits.

Step 1: Create an API key

After signing in to the dashboard, navigate to Settings > API Keys and click Create API Key. Copy the key — it starts with rb_ and will only be shown once.

# Your API key looks like this:
rb_live_a1b2c3d4e5f6g7h8i9j0...

Step 2: Submit a job

Use the API to submit a video processing job. This example adds a watermark to a video:

curl -X POST https://api.rendobar.com/jobs \
  -H "Authorization: Bearer rb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "watermark.add",
    "inputs": {
      "source": "https://example.com/video.mp4",
      "watermark": "https://cdn.rendobar.com/assets/brand/logo-full.png"
    },
    "params": {
      "position": "bottom-right",
      "scale": 0.15,
      "opacity": 0.8
    }
  }'

The response includes a jobId and initial status:

{
  "data": {
    "jobId": "job_a1b2c3d4",
    "status": "dispatched"
  }
}

Step 3: Check job status

Poll the job endpoint to check progress. Jobs typically complete in seconds to a few minutes depending on video length:

curl https://api.rendobar.com/jobs/job_a1b2c3d4 \
  -H "Authorization: Bearer rb_live_YOUR_KEY"
{
  "data": {
    "id": "job_a1b2c3d4",
    "type": "watermark.apply",
    "status": "complete",
    "price": 3000000000,
    "createdAt": 1707436800000,
    "completedAt": 1707436815000
  }
}

Job status progresses through: waiting -> dispatched -> running -> complete (or failed).

Step 4: Download the output

Once the job is complete, fetch the result with a presigned download URL:

curl https://api.rendobar.com/jobs/job_a1b2c3d4/result \
  -H "Authorization: Bearer rb_live_YOUR_KEY"
{
  "data": {
    "url": "https://r2.rendobar.com/...",
    "meta": {
      "durationMs": 127500,
      "width": 1920,
      "height": 1080,
      "fileSize": 15234567
    }
  }
}

The url is a presigned URL valid for 1 hour. Download the file or pass it to your application.

Next steps