Kadraris

Generate video and images from your AI agent

Connect Kadraris to Claude Code, Codex or Cursor over MCP. The agent picks a model, shows the cost before it starts and saves files into your project.

A key with a limit

In the dashboard, under API keys, generate a key and enter a monthly spending cap.

Go to keys

One command

Paste the command for your tool. You do it once.

Show commands

Request and approval

“Prepare a cover and a 10-second teaser. Before generating anything, tell me the total cost.”

What the conversation looks like

Illustrative example, not a real session log

You
I need two vertical clips announcing a gig. Do not generate anything without my OK.

Agent
I look for a model with sound in 9:16 and call estimate_cost for both clips. Here is the total - do you accept?

You
Yes, go ahead.

Agent
Running generate with confirm_token, waiting for results, saving files to the project folder and listing the paths.

Install commands

Put your own key in place of sk-kd-... and keep it out of the repo. Codex and Cursor read KADRARIS_API_KEY from the environment - set it and restart the tool.

Claude Code

claude mcp add --transport http kadraris https://kadraris.com/mcp --header "Authorization: Bearer sk-kd-..."

Codex

codex mcp add kadraris --url https://kadraris.com/mcp --bearer-token-env-var KADRARIS_API_KEY

Cursor

Add to Cursor

Full MCP guide plus env vars for PowerShell, macOS, Linux

Without an agent: plain REST /v1

The model catalog is public, no key needed. These requests only read model data - they cost nothing.

curl

curl --fail https://kadraris.com/v1/models/seedance-2.5

Node.js

const r = await fetch('https://kadraris.com/v1/models/seedance-2.5');
if (!r.ok) throw new Error('HTTP ' + r.status);
console.log(await r.json());

Python

import json, urllib.request
with urllib.request.urlopen('https://kadraris.com/v1/models/seedance-2.5') as r:
    print(json.load(r))

AGENTS.md · Creating tasks via API · Calculator · Pricing

Guides for specific tools

FAQ

How do I stop an agent from burning my balance?

Set a monthly cap on the key and tell the agent to show a quote before every job. The estimate_cost and confirm_token tools exist so generation starts only after you agree.

Where do the generated files end up?

The result link works only for a while, so ask the agent to download the file into the project right away and check it saved.