Kadraris API documentation
A single key covers every model: video, images, audio and chat. The first page gets you to a working request in a few minutes; the rest is reference you open when you need it.
What is in here
| Section | Page |
|---|---|
| Getting started | Quickstart First Kadraris API requests step by step - get a key, call a chat model, render an image and read your balance using curl, Python or JavaScript. |
| Authentication Kadraris API key guide - the sk-kd- key format, Authorization and x-api-key headers, monthly spend caps per key, rotation and storing keys safely. | |
| Billing Kadraris billing explained - prepaid USD balance that never expires, top-up amounts, holds on running tasks, GET /v1/balance, key spend caps and referrals. | |
| Endpoints | Chat completions Kadraris POST /v1/chat/completions - one OpenAI-compatible endpoint for Claude, GPT, Gemini, DeepSeek and others, with streaming, tool calls and usage. |
| Anthropic Messages Kadraris POST /v1/messages - an Anthropic-compatible endpoint for Claude models that works with official Anthropic SDKs, streaming, tools and Claude Code. | |
| Generate Kadraris POST /v1/generate reference - start image, video and music tasks, input validated against each model schema, waiting for results and costs. | |
| Tasks Kadraris GET /v1/tasks/{id} reference - task statuses, output files, final cost and errors, with polling loops and file download code in Python and JS. | |
| Models Kadraris GET /v1/models reference - browse chat, image, video and audio models with USD or PLN prices and read a model's input schema before calling it. | |
| Guides | Webhooks Kadraris webhooks for finished tasks - payload and headers, verifying the HMAC-SHA256 signature in Python and Node.js, retry timing and deduplication. |
| Errors Kadraris API errors in one place - JSON error shape, every error type and HTTP code, default rate limits, which calls to retry and backoff code samples. | |
| Claude Code and IDE tools Point Claude Code, Cursor, Cline, Continue and other OpenAI-compatible coding tools at Kadraris with a new base URL and key. Steps for macOS, Linux, Windows. | |
| n8n, Make and Zapier Connect Kadraris to n8n, Make or Zapier without code - HTTP step settings for chat and media, polling loops and webhook-triggered flows for video jobs. | |
| Integrations | Integrations: Claude Code, Codex, Cursor and more Set up Kadraris in Claude Code, Codex, Cursor, Cline, VS Code, n8n, Claude Desktop and other tools. One overview table with a ready command for each one. |
| MCP server: generate video and images from your agent Add the Kadraris MCP server to Claude Code, Codex, Cursor, VS Code or Cline so your agent checks the cost, then makes video, images and music on one key. | |
| Codex CLI with Kadraris Connect OpenAI Codex CLI to Kadraris over MCP to generate video and images or ask Claude and Gemini, with config.toml steps for Windows, macOS and Linux. | |
| AGENTS.md file for agents Drop the ready Kadraris AGENTS.md into your repo so Codex, Cursor, Claude Code and other agents know how to generate video, images and call chat models. |
Reference
GET /v1/models- every model with its price and input schema, as JSON, no key needed.- Models - the same list for people, with examples.