Skip to main content

Quickstart

Get up and running with PixelByte API in three simple steps.

Step 1: Get Your API Key

Create an API key from the PixelByte Dashboard.
  1. Sign in to your account
  2. Navigate to Settings > API Keys
  3. Click Create New Key
  4. Copy your key and store it securely
Your API key is shown only once. Store it in a secure location like an environment variable.
export PIXELBYTE_API_KEY="pb_your_api_key_here"

Step 2: Submit Your First Job

Let’s generate a video using Google’s Veo model.
curl -X POST https://api.muvi.video/v1/jobs/submit \
  -H "Authorization: Bearer $PIXELBYTE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/veo-3.1-fast/text-to-video",
    "input": {
      "prompt": "A cat playing piano"
    }
  }'
Response:
{
  "success": true,
  "data": {
    "jobId": "job_abc123",
    "status": "pending",
    "model": "google/veo-3.1-fast/text-to-video",
    "estimatedCost": 500000,
    "createdAt": "2026-02-18T12:00:00Z"
  },
  "requestId": "req_xyz789"
}
Save the jobId from the response — you’ll need it to check the status and retrieve the result.

Step 3: Check Job Status & Get Result

AI generation takes time. Poll the status endpoint until the job completes.
curl https://api.muvi.video/v1/jobs/job_abc123 \
  -H "Authorization: Bearer $PIXELBYTE_API_KEY"
Completed response:
{
  "success": true,
  "data": {
    "jobId": "job_abc123",
    "status": "completed",
    "model": "google/veo-3.1-fast/text-to-video",
    "output": {
      "url": "https://cdn.muvi.video/outputs/job_abc123/output.mp4",
      "contentType": "video/mp4",
      "durationSeconds": 8
    },
    "cost": 480000,
    "createdAt": "2026-02-18T12:00:00Z",
    "completedAt": "2026-02-18T12:01:30Z"
  },
  "requestId": "req_def456"
}
Tip: Use webhooks instead of polling to get notified when jobs complete.

Next Steps