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

# Introduction

> Start building with the Uncensored AI Developers API.

# Uncensored AI Developers API

The Uncensored AI Developers API gives developers programmatic access to media generation and AI model workflows.

<Note>
  Image generation and image studio (edit) are available today. Chat, video, audio, tools, and embeddings are on the roadmap — see the availability table below.
</Note>

## Base URL

```text theme={null}
https://api.uncensored.com/api
```

All documented endpoint paths are relative to this base URL. For example:

```text theme={null}
POST https://api.uncensored.com/api/v1/images/generations
```

## Current availability

| Product area           | Status                                                 | Notes                                                                |
| ---------------------- | ------------------------------------------------------ | -------------------------------------------------------------------- |
| Image generation       | <Badge color="green" shape="pill">Live</Badge>         | Generate images from text prompts.                                   |
| Image studio / editing | <Badge color="green" shape="pill">Live</Badge>         | Edit existing images with a text instruction and reference image(s). |
| Chat completions       | <Badge color="green" shape="pill">Live</Badge>         | OpenAI-compatible chat API.                                          |
| Video generation       | <Badge color="green" shape="pill">Live</Badge>         | Async video generation.                                              |
| Audio                  | <Badge color="orange" shape="pill">Coming soon</Badge> | Audio APIs planned.                                                  |
| Tools                  | <Badge color="orange" shape="pill">Coming soon</Badge> | Utility APIs such as prompt enhancement planned.                     |
| Embeddings             | <Badge color="orange" shape="pill">Coming soon</Badge> | Embedding APIs planned.                                              |

## Quick start

Generate an image with a live image model:

```bash theme={null}
curl --request POST "https://api.uncensored.com/api/v1/images/generations" \
  --header "x-api-key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "model-dev",
    "prompt": "A cinematic portrait, natural light, high detail",
    "image_width": 1024,
    "image_height": 1024
  }'
```

## Response format

Successful API responses return JSON. Async endpoints return a `job_id` and a `status_url` that can be polled until the job completes.

Errors use a consistent envelope:

```json theme={null}
{
  "error": {
    "message": "Human-readable error description",
    "type": "invalid_request_error",
    "param": "model",
    "code": "model_not_found"
  }
}
```