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.