# Dramatis Studio

> Your creative studio for images, characters and short films—with one pay-as-you-go API for every model. Paid from a prepaid balance, private, with retention you control.

## Docs

- [Quick start](/docs/quickstart/): Make a key, list the models, create a task, poll it and download the image.
- [Authentication](/docs/authentication/): Send the key as a bearer token, and keep it on a server.
- [Tasks](/docs/tasks/): A task's statuses, deadlines, polling, cancelling and deleting its content.
- [Images](/docs/images/): List the images and videos Dramatis Studio still keeps, with signed links, for the account or for one namespace.
- [Webhooks](/docs/webhooks/): Get the result pushed to your server, signed, with up to six attempts for each delivery.
- [Idempotency](/docs/idempotency/): Retry a task creation safely with an Idempotency-Key.
- [Uploads](/docs/uploads/): Send an image to Dramatis Studio in three calls and use it in tasks.
- [Video](/docs/video/): Turn an image into a short video: create the task, wait with polling or a webhook, download the clip, and see what it costs and when it fails.
- [Model labels](/docs/labels/): What the Uncensored and May refuse labels mean, when a refusal is refunded, and why a label is not permission.
- [Errors](/docs/errors/): Every error code of a request and of a task, and which to retry.
- [Limits](/docs/limits/): How many tasks and requests an account may have at once, and the headers that report it.
- [Retention](/docs/retention/): How long results are kept, how to change it, and how to delete them sooner.
- [Keys](/docs/keys/): Create, expire, replace and revoke API keys, set spend caps, and keep keys safe.
- [Reporting content](/docs/reporting/): How anyone can report content, with no account, and what happens to a report.

## API reference

- [API reference](/reference/): Every endpoint of the public API, drawn from the OpenAPI file.
- [OpenAPI file](/openapi.yaml): The public API as an OpenAPI 3.1 file.

## Models

- [Models](/models/): The models on offer, with their inputs and limits.
- `GET /v1/models` returns every model with its inputs, limits and prices, as JSON. It needs no key.