Skip to main content

Migrate from Shotstack

Vidiking uses a Shotstack-compatible timeline format. Migration is straightforward -- change the base URL, swap your API key, and you are done.

Step 1: Change the Base URL

Replace the Shotstack API endpoint with the Vidiking endpoint.

ShotstackVidiking
Base URLhttps://api.shotstack.io/v1https://api.vidiking.com/v1
RenderPOST /renderPOST /render
StatusGET /render/{id}GET /render/{id}
StitchPOST /stitchPOST /stitch

Step 2: Swap Your API Key

Replace your Shotstack API key with your Vidiking API key. The header format is the same.

# Before (Shotstack)
curl -H "x-api-key: your_shotstack_key" https://api.shotstack.io/v1/render

# After (Vidiking)
curl -H "Authorization: Bearer your_vidiking_key" https://api.vidiking.com/v1/render
Header Change

Shotstack uses x-api-key while Vidiking uses the standard Authorization: Bearer header.

Step 3: Update SDK Imports

Node.js

// Before
import Shotstack from 'shotstack-sdk';
const client = new Shotstack({ apiKey: 'your_key' });

// After
import Vidiai from '@vidiking/sdk';
const client = new Vidiai({ apiKey: 'your_key' });

Python

# Before
import shotstack_sdk
client = shotstack_sdk.Client(api_key="your_key")

# After
from vidiai import Vidiai
client = Vidiking(api_key="your_key")

Step 4: Verify Your Timelines

Your existing timeline JSON works as-is. No changes needed to the structure.

{
"timeline": {
"background": "#000000",
"tracks": [
{
"clips": [
{
"asset": {
"type": "video",
"src": "https://example.com/video.mp4"
},
"start": 0,
"length": 10
}
]
}
]
},
"output": {
"format": "mp4",
"resolution": "hd"
}
}

This exact JSON works on both Shotstack and Vidiking.

Pricing Comparison

FeatureShotstackVidiking
Video render (per min)$0.049$0.039 ($0.22)
HD render$0.049$0.039
4K renderNot available$0.079 (20 credits)
AI image generationNot available$0.019 ($0.14)
AI video generationNot available$0.199 ($0.55)
VoiceoverNot available$0.029 ($0.18)
Auto subtitlesNot available$0.019 ($0.14)
Free tier40 free renders/month100 sandbox mode
OveragePer-render pricingCredit-based, no surprises

What You Gain

By migrating to Vidiking, you get access to features not available on Shotstack:

  • AI image generation with DALL-E 3, Flux, and Stable Diffusion
  • AI video generation with Runway Gen-4
  • AI voiceover with ElevenLabs
  • Auto subtitles with Whisper
  • AI script writing with Claude
  • 4K upscaling
  • Templates marketplace
  • Credit-based pricing with no monthly minimums

FAQ

Do I need to change my timeline JSON?

No. Vidiking accepts the same timeline JSON format as Shotstack. Your existing timelines work without modification.

Can I use both services during migration?

Yes. Run both in parallel during your transition. Use Vidiking's sandbox mode to test your existing timelines before switching production traffic.

Are webhooks compatible?

The webhook payload format is similar but not identical. Vidiking webhooks include additional fields like credits_used and wallet_balance. See Webhooks for the full payload specification.

What about hosted assets?

If you use Shotstack's hosted asset URLs, those will continue to work as long as your Shotstack account is active. For long-term migration, re-upload assets to your own CDN or use Vidiking's asset hosting.

Is there a migration tool?

Not currently. Given that the timeline format is compatible, most migrations only require changing the base URL and API key. If you have complex integrations and need help, contact support@vidiking.com.