/v1/api Programmatic access available on Visionary plan. Build AI video into your product.
API · v1.0 · ENTERPRISE

One API. Every
model.

The Kaiber API gives developers programmatic access to every model in the Kaiber stack — Veo 3.1, Kling 3.0, Luma Ray, Runway Gen-4.5, Flux Pro, plus Cuts auto-edit and custom-trained models. One integration, fifteen-plus models, no per-vendor contracts.

POST /v1/generate/video Live
12345678910
curl -X POST https://api.kaiber.ai/v1/generate/video \ -H "Authorization: Bearer $KAIBER_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "veo-3.1", "prompt": "Synthwave skyline at dusk, neon city lights pulsing", "duration": 5, "aspect_ratio": "16:9", "audio": true }'
15+Models exposed via API
RESTJSON · webhook callbacks
99.9%SLA on Visionary plan
3SDK languages supported
Concurrent jobs (enterprise)
01 · The API

Generative video as a service.

The Kaiber API exposes the same model stack and creative tooling that powers Superstudio wrapped in a clean REST interface designed for developers building video AI into their own products.

Most generative video APIs are single-model offerings. You sign up for Runway's API and you get Runway models. You sign up for Pika and you get Pika. You sign up for Luma and you get Luma. Each contract is separate, each billing system is separate, each authentication scheme is separate. By the time you've integrated three or four model vendors to give your product enough creative range, you're managing a small constellation of API contracts and your finance team is asking why there are so many AI invoices.

The Kaiber API takes a different approach. One integration, every model. Through a single REST endpoint, you can generate video on Veo 3.1 (Google's native-audio model), Kling 3.0, Luma Ray, Runway Gen-4.5, MiniMax Hailuo, Mochi, plus image generation on Flux Pro, Recraft, and Stable Diffusion. You can run a custom-trained LoRA model. You can trigger a Cuts auto-edit. You can upscale to 4K. All of it, one API key, one billing system, one set of credits.

The API is positioned for builders companies embedding generative video into their own products, agencies running custom workflow tooling for clients, and large content operations automating production pipelines. It's not a self-serve developer tier; access is provisioned through the Visionary plan (Kaiber's enterprise tier) and includes dedicated technical onboarding. We'll cover access in section 07.

API status

The Kaiber API is currently in private access for Visionary-tier customers. Self-serve developer access is on the public roadmap. To get early access or evaluate the API for your product, contact support@kaiber.ai with a brief description of your use case and expected volume.

Under the hood, the API is a thin orchestration layer over Kaiber's existing model integrations. When you submit a video generation job to /v1/generate/video with model: "veo-3.1", your request gets routed to Kaiber's Veo integration, runs on Google's infrastructure, and returns a finished video URL alongside metadata. When you submit the same prompt with model: "kling-3.0", the same request flows to Kuaishou's Kling backend instead. From your application's perspective, switching between premium video models is a one-string change no separate auth, no separate contract, no different request shape.

02 · Capabilities

What the API can do.

Every Kaiber capability that's available in the web platform is exposed through a corresponding API endpoint. Here's the full surface area, organized by what you'll build with.

POST/v1/generate/video

Video generation

Submit text or image prompts, choose any of 7+ video models, set duration and aspect ratio. Returns a job ID for async polling or webhook delivery.

POST/v1/generate/image

Image generation

Generate stills via Flux Pro, Recraft v3, or Stable Diffusion 3.5. Returns image URLs, supports batch requests of up to 8 images per call.

POST/v1/generate/transform

Video transform & restyle

Re-skin existing footage in any AI style. Upload a video, choose a style preset or custom model, get back the transformed clip.

POST/v1/cuts/render

Cuts auto-edit

Submit audio plus visuals, get back a beat-synced video. Programmatic access to the same Cuts engine that powers the Kaiber web app — including auto-clip and lyric overlays.

POST/v1/training/start

Custom model training

Trigger a LoRA training run from a set of reference images. Trained models become available across all video and image generation endpoints.

POST/v1/upscale

Upscaling

Push images and videos to higher resolution via Magnific (image) and Topaz (video) integrations. 1080p, 2K, or 4K targets supported.

GET/v1/jobs/<id>

Job status & polling

Check the status of any submitted job. Returns queued, processing, completed, or failed status plus output URLs and metadata when ready.

GET/v1/models

Model registry

List every available model with current pricing, supported parameters, and availability status. Useful for building dynamic UIs in your own app.

POST/v1/webhooks

Webhook callbacks

Register webhook URLs that receive POST notifications when jobs complete. Eliminates polling for long-running generation tasks.

03 · Authentication

API keys, scoped & rotatable.

Authentication uses standard Bearer tokens. Keys are scoped, rotatable, and rate-limited per environment. Here's the full flow.

01.

Request API access.

Email support@kaiber.ai with your use case and expected volume. Visionary-plan customers can request keys directly from their dashboard.

02.

Generate scoped keys.

From your dashboard, generate keys scoped to specific endpoints (video, image, cuts, training). Separate keys for production, staging, and CI.

03.

Authenticate every request.

Pass the key as Authorization: Bearer $KAIBER_API_KEY on every request. HTTPS required; HTTP requests are rejected.

04.

Rotate as needed.

Rotate keys at any time without downtime - old and new keys overlap for 24 hours. Compromised keys can be revoked instantly.

Rate limits

Standard API access on Visionary plan: 60 requests per minute on read endpoints, 10 concurrent generation jobs. Custom limits available on enterprise contracts. Rate-limit headers (X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset) return on every response.

04 · Code Examples

Copy, paste, ship.

Generate a 5-second video on Veo 3.1 in any of three languages. Authentication, request shape, and error handling are identical across SDKs - so switching between languages is mechanical.

Generate a video

Submit a text prompt to Veo 3.1 and get a job ID back. The actual video URL becomes available once the job completes typically in 20-60 seconds.

terminal — generate-video.sh
12345678
# Submit a video generation job to Veo 3.1 curl -X POST https://api.kaiber.ai/v1/generate/video \ -H "Authorization: Bearer $KAIBER_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"veo-3.1", "prompt":"Synthwave skyline at dusk", "duration":5,"aspect_ratio":"16:9"}' # Returns: { "job_id": "gen_8K3jH4mN2pQr", "status": "queued" }
node.js — generate-video.js
1234567891011121314
import Kaiber from '@kaiber/sdk'; const kaiber = new Kaiber({ apiKey: process.env.KAIBER_API_KEY }); const job = await kaiber.video.generate({ model: 'veo-3.1', prompt: 'Synthwave skyline at dusk', duration: 5, aspect_ratio: '16:9' }); console.log(job.id); // "gen_8K3jH4mN2pQr"
python — generate_video.py
123456789101112
from kaiber import Kaiber client = Kaiber(api_key=os.environ["KAIBER_API_KEY"]) job = client.video.generate( model="veo-3.1", prompt="Synthwave skyline at dusk", duration=5, aspect_ratio="16:9", ) print(job.id) # "gen_8K3jH4mN2pQr"

Poll for completion

Generation jobs run async. Either poll the job endpoint until status is completed, or register a webhook to receive a callback when the job finishes (recommended for production).

terminal — poll.sh
12345678910
# Poll job status until completed curl https://api.kaiber.ai/v1/jobs/gen_8K3jH4mN2pQr \ -H "Authorization: Bearer $KAIBER_API_KEY" # When complete, returns: # { # "id": "gen_8K3jH4mN2pQr", # "status": "completed", # "output_url": "https://cdn.kaiber.ai/output/...mp4", # "duration_ms": 22340, "credits_used": 180 # }
node.js — poll.js
12345678910
async function waitForJob(jobId) { while (true) { const job = await kaiber.jobs.get(jobId); if (job.status === 'completed') return job; if (job.status === 'failed') throw new Error(job.error); await new Promise(r => setTimeout(r, 2000)); } } const result = await waitForJob(job.id); console.log(result.output_url);
python — poll.py
123456789
import time def wait_for_job(job_id): while True: job = client.jobs.get(job_id) if job.status == "completed": return job if job.status == "failed": raise Exception(job.error) time.sleep(2) result = wait_for_job(job.id)

Programmatic Cuts auto-edit

Submit an audio file plus a set of visuals, get back a beat-synced video — the same Cuts engine that powers the web app, exposed via API.

terminal — cuts.sh
123456789
# Submit a Cuts auto-edit job curl -X POST https://api.kaiber.ai/v1/cuts/render \ -H "Authorization: Bearer $KAIBER_API_KEY" \ -d '{"audio_url":"https://your.cdn/song.mp3", "visuals":["https://...","https://...","https://..."], "template":"high-energy", "aspects":["9:16","1:1","16:9"], "variations":5}'
node.js — cuts.js
12345678
const render = await kaiber.cuts.render({ audio_url: 'https://your.cdn/song.mp3', visuals: ['https://...', 'https://...'], template: 'high-energy', aspects: ['9:16', '1:1', '16:9'], variations: 5, }); console.log(render.id);
python — cuts.py
12345678
render = client.cuts.render( audio_url="https://your.cdn/song.mp3", visuals=["https://...", "https://..."], template="high-energy", aspects=["9:16", "1:1", "16:9"], variations=5, ) print(render.id)
05 · Models & Cost

Every model. One API.

The full list of models exposed via the Kaiber API, with current credit costs. API costs match the in-app costs you're not paying a developer-tier markup.

Model ID Provider Type Credit Cost
veo-3.1 Google Video + native audio 36 cr/sec
kling-3.0 Kuaishou Video, long takes ~10–15 cr/sec
luma-ray-3 Luma Labs Cinematic video, HDR ~12 cr/sec
runway-gen-4.5 Runway Filmmaker-grade video ~14 cr/sec
hailuo-01 MiniMax Fast iteration video ~8 cr/sec
mochi-1 Genmo Stylized video ~10 cr/sec
flux-pro Black Forest Labs Photorealistic image ~3–5 cr/image
recraft-v3 Recraft Design / typography ~3 cr/image
sd-3.5 Stability AI Versatile image ~2 cr/image
topaz-vid-upscale Topaz Labs Video 4K upscale ~40 cr/clip
magnific-img-upscale Magnific Image hi-res upscale ~10 cr/image
cuts-render Kaiber Beat-sync auto-edit 0 cr (free)
custom/<your_model_id> Kaiber Trained LoRA model 500 cr (one-time)
Same models, same costs as the app

The credit costs above are identical to the in-app costs in Kaiber Canvas. There's no API surcharge or developer-tier multiplier. The same 5-second Veo 3.1 generation that costs 180 credits when you click "Generate" in Superstudio costs 180 credits when you submit it via POST /v1/generate/video. Beat Sync (cuts-render) is free in both contexts.

06 · Use Cases

What people build with it.

Four representative use cases across content platforms, agencies, music labels, and creative tooling — drawn from real Visionary-tier customers.

Content platform

AI video features inside a creator app

Social and creator platforms embed Kaiber-powered video generation directly into their app — users type a description and get back a styled video without ever leaving the platform. Kaiber handles model selection, queueing, and delivery; the platform handles UI and user accounts.

/v1/generate/video /v1/cuts/render webhooks
Creative agency

Pitch-deck video automation for clients

A creative agency builds an internal tool that takes a client's brief, generates 5–10 video variations across multiple AI models in parallel, and assembles them into a pitch deck. What used to be a 3-day storyboard process becomes a 30-minute review meeting.

/v1/generate/video model: veo-3.1 model: kling-3.0
Music label

Spotify Canvas at album-release scale

A label automates the production of Spotify Canvas loops for every track on every release. The pipeline ingests track audio + a brand visual reference, generates 16:9 and 9:16 visuals on the appropriate model, and queues them for QA before shipping to Spotify.

/v1/cuts/render /v1/training/start aspects: 9:16
Creative tooling

Embedded AI inside an NLE plugin

A video-editing software vendor adds a "Generate B-roll with AI" panel to their NLE. Editors describe what they need ("aerial drone shot of a coastline at sunset"), the plugin calls the Kaiber API in the background, and finished clips drop straight into the project bin.

/v1/generate/video /v1/upscale model: hailuo-01
07 · Get Access

How to start building.

API access is currently provisioned through the Visionary plan with custom pricing tied to your expected volume. Here's the path from intro email to first generation.

Visionary plan · custom-quoted

The Kaiber API is included on the Visionary plan along with white-glove technical onboarding, a dedicated account manager, custom credit allocation matched to your volume, SSO for team access, and SLA guarantees. Pricing is custom-quoted based on expected monthly credit consumption, number of seats, and integration support requirements.

Typical Visionary engagements start in the low four figures per month and scale from there. Companies running production at meaningful volume (tens of thousands of generations per month) can negotiate volume discounts off standard credit rates. Smaller teams running lower-volume integrations may be a better fit for credit packs purchased through the Pro plan.

01. Email support@kaiber.ai with use case & volume
02. 30-min call with Kaiber's enterprise team
03. Custom proposal & API keys within 5 days
Contact sales See plan details
08 · FAQ

API, explained.

Is there a self-serve developer tier?
Not at the moment. API access is currently provisioned through the Visionary plan with custom onboarding. Self-serve developer access is on Kaiber's public roadmap but doesn't have a public launch date. To request early access or get on the waitlist, email support@kaiber.ai.
Can I use the API to power a consumer product?
Yes. Visionary-plan customers are explicitly permitted to embed Kaiber-powered generation in their own consumer or B2B products, with full commercial-use rights on outputs. The standard Kaiber attribution requirement does not apply to API-generated content — you can present the output as part of your own product without crediting Kaiber.
How does API billing work?
API usage draws from your Visionary credit allocation, which is custom-set based on your contract. Credits consumed per generation match the in-app rates (e.g. veo-3.1 at 36 credits/second). Overage beyond your allocation is billed at standard credit-pack rates. Detailed usage reports are available in the dashboard, broken down by model, endpoint, and time window.
What's the SLA?
Visionary-plan API access includes a 99.9% monthly uptime SLA on Kaiber's orchestration layer. Note that individual model endpoints (Veo, Kling, Luma) are subject to upstream provider availability — Kaiber routes around outages where possible but cannot guarantee uptime on third-party model providers. Failover to alternative models can be configured per request.
Are there content restrictions on API generations?
Yes. The same content policies that apply to the Kaiber web platform apply to API-generated content — no NSFW, no copyrighted-character generation, no impersonation of real public figures, no content involving minors in inappropriate contexts. Each model provider also has its own content policy, which the API enforces. Submissions that violate policy return a 400 Bad Request with a policy-violation error code.
Can I train custom models via API?
Yes. The POST /v1/training/start endpoint accepts a set of reference images and triggers a LoRA training run. Training takes 10–30 minutes and costs ~500 credits per run. Once complete, the trained model is referenced by custom/<your_model_id> in subsequent generation requests and is private to your organization.
How do webhooks work?
Register a webhook URL via POST /v1/webhooks or per-job in the generation request. When a job completes (or fails), Kaiber sends a signed POST to your URL with the job result payload. Signatures use HMAC-SHA256 with a per-org webhook secret — verify them before acting on the payload to prevent spoofed callbacks.
Is there an SDK?
Official SDKs are available for JavaScript/TypeScript (@kaiber/sdk on npm), Python (kaiber on PyPI), and Go (github.com/kaiber-ai/go-sdk). All three SDKs cover the full API surface and handle authentication, polling, and webhook signature verification automatically. The raw REST API can be called from any language that can make HTTPS requests.
What happens if a model provider deprecates a model?
Kaiber maintains versioned model IDs (veo-3.1, kling-3.0) and provides at least 90 days notice before deprecating any specific version. New model versions ship with new IDs (e.g. veo-3.2) so existing integrations don't break automatically. The GET /v1/models endpoint always reflects current availability and any deprecation warnings.
Can I get a sandbox / test environment?
Yes. Visionary-plan customers get a separate sandbox environment with its own API base URL (https://sandbox-api.kaiber.ai) and reduced-cost test credits. Sandbox responses are real generations on real models — there's no mock mode — but they're tagged in your usage reports and can be billed against a separate test allocation.

curl -X POST
a generation.

The Kaiber API is in private access for Visionary-tier customers. Get in touch with use case, expected volume, and integration timeline — typical responses within 1 business day.