Skip to main content

Quick Start

Get from zero to a rendered video in 5 minutes.

1. Sign Up​

Create a free account at vidiking.com. You can test with sandbox mode for free (watermarked output).

2. Get Your API Key​

After logging in, go to the API page (/api) to find your API key. You get both a production key and a sandbox key.

YOUR_API_KEY=your_api_key_here

3. Deposit Funds (Production Only)​

Go to Deposit (/deposit) and add funds to your wallet. Minimum $10. Sandbox mode is free.

4. Render Your First Video​

Submit a render job with a simple timeline: a title clip over a solid background.

curl​

curl -X POST https://api.vidiking.com/v1/render \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "timeline": {
      "background": "#000000",
      "tracks": [
        {
          "clips": [
            {
              "asset": {
                "type": "title",
                "text": "Hello from Vidiking",
                "style": "minimal",
                "size": "large"
              },
              "start": 0,
              "length": 5
            }
          ]
        }
      ]
    },
    "output": {
      "format": "mp4",
      "resolution": "1080p"
    }
  }'

Node.js​

import Vidiai from '@vidiai/sdk';

const client = new Vidiai({ apiKey: 'YOUR_API_KEY' });

const result = await client.render({
  timeline: {
    background: '#000000',
    tracks: [
      {
        clips: [
          {
            asset: {
              type: 'title',
              text: 'Hello from Vidiking',
              style: 'minimal',
              size: 'large',
            },
            start: 0,
            length: 5,
          },
        ],
      },
    ],
  },
  output: {
    format: 'mp4',
    resolution: '1080p',
  },
});

console.log('Job ID:', result.data.id);

Python​

from vidiai import Vidiai

client = Vidiai(api_key="YOUR_API_KEY")

result = client.render({
    "timeline": {
        "background": "#000000",
        "tracks": [
            {
                "clips": [
                    {
                        "asset": {
                            "type": "title",
                            "text": "Hello from Vidiking",
                            "style": "minimal",
                            "size": "large"
                        },
                        "start": 0,
                        "length": 5
                    }
                ]
            }
        ]
    },
    "output": {
        "format": "mp4",
        "resolution": "1080p"
    }
})

print("Job ID:", result["data"]["id"])

5. Check Job Status​

Rendering is asynchronous. Poll the job status until it completes.

curl https://api.vidiking.com/v1/jobs/JOB_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

Response when complete:

{
  "success": true,
  "data": {
    "id": "abc-123",
    "status": "COMPLETE",
    "outputUrl": "https://api.vidiking.com/files/renders/abc-123.mp4",
    "cost": "0.22",
    "createdAt": "2026-03-31T10:30:00Z"
  }
}

Cost: $0.12 (1 minute render) + $0.10 (infra fee) = $0.22

6. Download Your Video​

The outputUrl in the completed job response is a direct download link.

curl -o my-video.mp4 "https://api.vidiking.com/files/renders/abc-123.mp4"

Or Use the Visual Editor​

Don't want to write code? Use the Timeline Studio at vidiking.com/studio — a canvas-based editor with drag-and-drop, AI image/video/voiceover generation, and real-time cost tracking.

Next Steps​