Developer API

One key. Every model.

One bearer token reaches every major AI video, image, voice, and music model across providers — Veo 3.1, Kling 3.0, Seedance 2.0, GPT Image 2, Nano Banana Pro, Runway, ElevenLabs, Suno and more. Normalized request shape, async jobs, capability discovery, transparent billing.

Get an API key OpenAPI 3.1 spec

no credit card · bearer auth · JSON in, JSON out

Quick start

Generate a shot in one call.

Get a vsk_... token — your agent can request one itself with POST /api/v1/agent/connect (you approve once), or create one in one click at /agent/key, export it as VAROSITY_API_KEY, then:

curl -X POST https://varosity.ai/api/v1/video/generate \
  -H "Authorization: Bearer vsk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "modelId": "veo-3.1",
    "prompt": "A lighthouse keeper raises a brass telescope at dusk.",
    "aspectRatio": "16:9",
    "durationSec": 8
  }'
# → { ok: true, jobId: "..." }  — then poll GET /api/v1/jobs/{jobId}

What the API ships with.

One key, every provider

One vsk_... token reaches fal.ai, OpenAI, Google, Replicate, WaveSpeed, ElevenLabs, Cartesia, Fish Audio. Runway models run via Replicate and WaveSpeed; there is no direct Runway integration. Normalized request shape across all of them.

Async jobs + polling

Submit returns a job id immediately. Poll GET /api/v1/jobs/{jobId}; webhooks fire from the poll that sees completion, so keep polling. No synchronous hangs on 60s video renders.

BYOK or Varosity Credits

Per-provider billing choice, the provider's list price either way. BYOK = your provider invoice. Credits = platform-managed, no provider signup. Mix freely.

Capability discovery

GET /api/v1/models returns the full registry with aspect ratios, duration limits, native audio, and prices (per second for video, per image for images). Agents pick the right model per shot.

MCP-native

JSON-RPC 2.0 over Streamable HTTP at /api/mcp. Claude Code, Cursor, Claude.ai, ChatGPT and any MCP host connect with a key or by signing in. Same token, same surface.

CLI + OpenAPI

npm install -g @varosity/cli. --json mode on every command. /api/openapi.json for any codegen you like. /llms.txt for LLM consumption.

Pricing

BYOK vs Varosity Credits.

Every model at its provider's list price, no markup. On your own key the provider invoices you; on Varosity Credits we do, in whole cents — each call rounds up to the next cent (1¢ minimum), so cheap images and short audio cost slightly more on Credits. Mix freely.

Model	Vendor	BYOK price	Credits price	Type
Veo 3.1 Fast veo-3.1	wavespeed	Credits only	$0.15/s	video · 8s
Veo 3.1 (Quality) veo-3.1-quality	wavespeed	Credits only	$0.40/s	video · 8s
Veo 3.1 Lite veo-3.1-lite	wavespeed	Credits only	$0.05/s	video · 8s
Kling 3.0 Pro kling-3.0	fal	$0.168/s	$0.168/s	video · 10s
FLUX 3 Max flux-3-max	fal	$0.0425/s	$0.0425/s	video · 20s
Vidu Q4 vidu-q4	fal	$0.0665/s	$0.0665/s	video · 16s
FLUX.1 [schnell] flux-1-schnell	fal	$0.003/img	$0.01/img	image
FLUX.3 Klein flux-3-klein	fal	$0.009/img	$0.01/img	image
Krea 3 krea-3	fal	$0.025/img	$0.03/img	image
ElevenLabs Multilingual v2 elevenlabs-tts	elevenlabs	$0.072/min	$0.08/min	voice · 600s
ElevenLabs Music elevenlabs-music	elevenlabs	$0.15/min	$0.15/min	music · 300s
Suno V6 (via muapi) suno-v4	muapi	Credits only	$0.10/song	music · 240s

Failures never billImages, voice and ElevenLabs Music stored for you; video is the provider's linkNo per-key Varosity subscription

Ready to build?

Get an API key Read the agent guide