Developer Platform Overview

SuperAIVideo exposes a REST API and JavaScript SDK so you can programmatically create projects, generate variants, manage credits, and receive render status updates in your own products.

Base URL

https://api.superaivideo.com/v1

Authentication

Create API keys in /app/api-keys. Send the key as a Bearer token. All requests must be made over HTTPS and include a workspace ID header (X-Workspace-ID).

Authorization: Bearer <API_KEY>

Core endpoints

• POST /projects — create a project from a prompt, URL, or storyboard JSON.
• POST /renders — queue a render with scenes, variants, and target channels.
• GET /renders/{id} — check status, download assets, review credit usage.
• POST /templates/install — install marketplace or private templates.
• POST /credits/top-up — purchase or allocate credits programmatically.

Webhooks

Register webhooks from the dashboard or via POST /webhooks. Events include render.started, render.completed, render.failed, and credits.low_balance.

{
  "type": "render.completed",
  "render_id": "rnd_123",
  "project_id": "proj_789",
  "status": "completed",
  "credits_used": 196,
  "outputs": [{
    "url": "https://cdn.superaivideo.com/rnd_123.mp4",
    "thumbnail": "https://cdn.superaivideo.com/rnd_123.jpg",
    "aspect_ratio": "9:16"
  }]
}

SDK

Install the JS SDK to interact with the API from Node or the browser:

npm install @superaivideo/sdk

import { SuperAIVideo } from "@superaivideo/sdk";

const client = new SuperAIVideo({ apiKey: process.env.SUPERAIVIDEO_KEY! });

const project = await client.projects.create({
  workspaceId: "ws_123",
  source: { url: "https://yourstore.com/product/sku-42" }
});

const render = await client.renders.create({
  projectId: project.id,
  variants: [
    { aspectRatio: "9:16", voice: "voice_pro_1", format: "tiktok" },
    { aspectRatio: "16:9", voice: "voice_pro_1", format: "youtube" }
  ]
});

Rate limits

Default rate limits are 60 requests per minute per workspace. Enterprise plans include custom limits, dedicated render pods, and regional routing.

Need something custom? Email devrel@superaivideo.com and our developer relations team will help architect your integration.