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

# Base URL

> API host, versioning, content types, and request basics.

The public API base URL is:

```text theme={"theme":"github-dark"}
https://api.adskull.io/v1
```

All public API paths in these docs are relative to that base URL. For example:

```text theme={"theme":"github-dark"}
POST https://api.adskull.io/v1/image-generations
```

## Versioning

The first public version is `v1`. Breaking changes require a new version path such as `/v2`.

Non-breaking changes can be added to `v1`, including:

* New optional response fields.
* New model IDs.
* New pricing rows.
* New webhook event types.
* New optional request parameters.

## Content Types

Most endpoints accept and return JSON:

```http theme={"theme":"github-dark"}
Content-Type: application/json
Accept: application/json
```

Use `/v1/assets` for multipart uploads, then pass the returned asset URL into JSON generation requests.

## Required Headers

```http theme={"theme":"github-dark"}
Authorization: Bearer sk_live_...
Idempotency-Key: unique-key-for-create-requests
```

`Idempotency-Key` is required for endpoints that create jobs, reserve credits, create custom voices, or create webhook endpoints.