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

# TurboAds Developer Docs

> Build with the TurboAds public API and CLI.

# TurboAds Developer Docs

Use the TurboAds API to generate ad creative assets from your own tools, automations, and backend workflows.

## Start here

* Create an API key in `Settings > Developers`.
* Pick an existing `project_id` from your workspace.
* Create an image, video, or talking actor generation job.
* Poll the job by ID.
* Fetch the final asset URL from the matching `/url` endpoint.

## Current API shape

```text theme={null}
POST /v1/images/generate
GET  /v1/images/{id}
GET  /v1/images/{id}/url

POST /v1/videos/generate
GET  /v1/videos/{id}
GET  /v1/videos/{id}/url

POST /v1/talking-actors/generate
GET  /v1/talking-actors/{id}
GET  /v1/talking-actors/{id}/url
```

## Local docs development

Install the Mintlify CLI and run the docs from this folder:

```bash theme={null}
npm i -g mint
cd docs
mint dev
```

In Mintlify, configure this repository as a monorepo docs project and set the documentation path to `/docs`.