Last updated 2026-10-25
Kinsy API
Kinsy turns a brief and your source documents into a finished, editable PowerPoint deck: a native .pptx with real text boxes, tables and charts, embedded fonts and a slide master, and a PDF beside it. The API is the same product the web app uses, for command-line tools and agents.
- Base URL:
https://kinsy.ai/v1 - Auth:
Authorization: Bearer ksy_live_…(create a key) - Format: JSON in, JSON out; errors use one envelope
- Spec:
/v1/openapi.json(OpenAPI 3.1) - CLI:
npx kinsy-cli login, thennpx kinsy-cli create "…" --wait --out deck.pptx(command line) - MCP:
https://mcp.kinsy.ai/mcpfor any MCP client (MCP server) - Agents: one skill, installable in Claude Code, Codex, Cursor and more (use Kinsy from your agent)
What you can do
| Call | What it does | Credits |
|---|---|---|
POST /v1/decks | Start a deck from a brief and sources. Answers in under two seconds with a deck id to poll. | 40 (up to 10 slides) · 60 (11–16) · 90 (17–25), plus 10 per picture the deck needs |
GET /v1/decks/{id} | Status, progress, and the download links once the deck is done | free |
GET /v1/decks/{id}/files/pptx | The .pptx (or pdf, or a png zip of the slides) | free |
POST /v1/decks/{id}/edits | Rewrite one slide from an instruction | 5, plus 10 if the slide gets a new picture |
POST /v1/intake | The questions the builder would ask about a brief | free |
POST /v1/files | Extract the text of a PDF, spreadsheet, document or image to use as a source | free |
GET /v1/decks | Your decks, newest first | free |
GET /v1/me | Your plan, credit balance and key | free |
GET /v1/themes · GET /v1/templates | The catalogues | free |
A finished deck usually takes one to two minutes. The first slides render well before that, so an agent can show progress while it waits.
Limits and pricing
Pricing is identical on every surface: there is no separate API plan and no surcharge. Keys are available on every plan, including the free one, and spend the same credits as the web app.
| Limit | Value |
|---|---|
| Free credits at signup | 100 once your email is verified (50 before) |
| Credit packs | $5 for 200 · $12 for 500 · $30 for 1,500; packs never expire |
| Plans | Pro $20/month for 1,000 credits · Max $50/month for 3,000 credits |
| Watermark | Removed by any purchase, a pack or a plan |
| Builds per account | 15 per day |
| Edits, intake and file extractions per account | 40 per hour |
| Requests per key | 120 per minute |
| Keys per account | 10 active |
| Brief | 50,000 characters |
| Sources per deck | 10, each up to 120,000 characters of extracted text |
| Files for extraction | 25 MB each |
| Slides per deck | 4 to 25 |
| Download links | Valid for 1 hour; fetch a fresh one from the status call at any time |
Credits are bought on kinsy.ai/pricing and consumed anywhere. When a call needs more credits than the account has, it answers 402 with a checkout_url; the builder never starts work it cannot finish.
Where next
- Quickstart: brief in, .pptx out, in one command or four calls.
- Command line: the
kinsyCLI, every flag and exit code. - MCP server: connect Claude Code, Codex, Cursor or VS Code to the remote server.
- Use Kinsy from your agent: the skill and how to install it where your agent runs.
- Authentication: keys, headers, idempotency.
- API reference: every call, field by field.
- Errors: the envelope and what each code means.