> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kodisc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Welcome

> Render Manim scenes from your own apps with the Kodisc API.

Kodisc turns [Manim](https://www.manim.community) Python code into rendered MP4 videos, JPEG thumbnails, and WebVTT captions — without you running the toolchain. Send a `Scene`, get back a URL.

The API is intentionally small: enqueue a render, poll (or webhook) for the result, top up credits when you need to.

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Render your first scene end-to-end in under five minutes.
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/introduction">
    Three endpoints, fully typed, with live Try-It panels.
  </Card>

  <Card title="Authentication" icon="key" href="/authentication">
    `kdsc_live_*` keys, Bearer auth, key rotation.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/webhooks">
    Get pinged the moment a render is ready — with verifiable signatures.
  </Card>
</CardGroup>

## How it works

<Steps>
  <Step title="Submit Manim code">
    `POST /api/v2/render` with your `Scene` source and the class name to render. You get back a `jobId` immediately — renders run asynchronously.
  </Step>

  <Step title="Wait for the result">
    Either poll `GET /api/v2/render/{jobId}` until `status` is `completed`, or configure a [webhook](/webhooks) to be notified the moment it lands.
  </Step>

  <Step title="Use the assets">
    Completed jobs return public URLs to an MP4 video, a thumbnail image, and (when applicable) a captions file. Download or hot-link them.
  </Step>
</Steps>

## What's not covered here

This site documents the **public** Kodisc API only. The in-app surfaces — project management, the generation chat, narration uploads, internal tRPC procedures — are intentionally not part of the public contract and aren't documented here. If you need something that isn't in the reference, [let us know](https://kodisc.com).
