# Generation API

All personal-key generation endpoints at a glance.

## Base URL

```text
https://letsgen.app
```

Authenticate using `Authorization: Bearer $LETSGEN_API_KEY`. Send JSON with `Content-Type: application/json` except for the raw-media and multipart voice uploads.

## Endpoints

| Method | Path | Scope | Reference |
| --- | --- | --- | --- |
| GET | `/api/generate/models` | read | [Discover models](/docs/api/models) |
| POST | `/api/generate/image` | generate | [Images](/docs/api/image) |
| POST | `/api/generate/video` | generate | [Videos](/docs/api/video) |
| POST | `/api/generate/audio` | generate | [Audio](/docs/api/audio) |
| GET / HEAD | `/api/generate/tasks/{id}` | read | [Tasks](/docs/api/tasks) |
| POST | `/api/generate/assets` | generate | [Upload assets](/docs/api/assets) |
| GET | `/api/generate/voices` | read | [Voices](/docs/api/voices) |
| POST | `/api/generate/voices` | generate | [Voices](/docs/api/voices) |
| POST | `/api/generate/text/v1/chat/completions` | generate | [Text and streaming](/docs/api/text) |
| POST | `/api/generate/extract/video` | generate | [Video extraction](/docs/api/extract) |

Image, video, audio, text, and extraction submissions require `Idempotency-Key`. Asset and voice uploads are explicit mutations and do not implement generation idempotency. Avoid automatically repeating an upload after an ambiguous response.

## Machine-readable reference

Download [OpenAPI 3.1](/openapi.json) for API tooling. Agents can use [llms.txt](/llms.txt), [the full Markdown reference](/llms-full.txt), or **Read as Markdown** on any page. Schemas describe the public envelope; model-specific parameters are validated by the generation service.

There is no public webhook registration, cancellation endpoint, model-detail endpoint, or caller-supplied provider routing in this API. Poll media tasks; consume text as JSON or SSE.