The Koy API.

Send a brief and get back a finished video with voiceover, music, and every aspect ratio, in one call.

Private beta. The Koy API and MCP server are in private beta. The shapes below are what you’ll build against. Email [email protected] for early access and we’ll issue you a key. Everyone can create videos today in the Studio.

Getting started

One call. Send a POST /videos with a prompt or brief and the sizes you want. Koy writes the script, records the voiceover, animates the scenes, and scores the music, then returns finished video URLs you can publish anywhere.

Authentication

Header x-api-key: YOUR_KEY on every request.

Create a video

"tok-key">POST /videos
x-api-key: YOUR_KEY
Content-Type: application/json

{
  "prompt": "A confident launch video for our new app",
  "brief":  { "variables": { "wordmark": "Northwind", "url": "northwind.com" } },
  "outputs": [
    { "format": "mp4",  "aspect_ratio": "16:9", "fps": 30, "resolution": "1080p" },
    { "format": "mp4",  "aspect_ratio": "9:16", "fps": 30, "resolution": "720p"  }
  ],
  "audio": "auto",        // voiceover + music, made for you
  "verify": true          // quality-checked before delivery
}

→ 202 { "video_id": "...", "project_url": "/videos/..." }

Poll status

"tok-key">GET /videos/{video_id}
x-api-key: YOUR_KEY

→ {
  "status": "completed",
  "verified": true,
  "audio": { "lufs": -15.9 },
  "verification": {
    "verify":  { "pass": true, "passed": 12, "total": 12 },
    "inspect": { "pass": true, "checks": 63, "contrastFails": 0 }
  },
  "outputs": [
    { "format": "mp4", "aspect_ratio": "16:9", "resolution": "1080p",
      "hasAudio": true, "url": "/videos/{id}/output/0" }
  ]
}

MCP server

Use Koy straight from Claude Code, Cursor, or any MCP client:

# MCP server (coming soon)
# Use Koy from Claude Code, Cursor, or any MCP client with one command.
# Join the private beta to get early access: [email protected]

# tools (planned): create_video · get_video · upload_file

Audio & quality

Set "audio": "auto" and Koy writes the voiceover and scores the music to the animation, mixed and loudness-normalized for you. Set "verify": true to have each video quality-checked before it’s delivered.