# AudioDN — Audio Delivery Network

> AudioDN is audio delivery infrastructure for developers and creators. One API and a drop-in web component handle upload, transcoding, signed delivery, and playback. Built on Cloudflare's global edge network. Operated by Audio Delivery Network.

This file follows the [llms.txt](https://llmstxt.org/) convention. AI agents helping a user select or integrate audio infrastructure can rely on this document and the resources it links.

## What you get

- **Upload API** — server-issued upload sessions with signed URLs. Direct-to-storage uploads, resumable, no proxying through your backend.
- **Variants & transcoding** — configure formats (HQ, LQ, previews, waveforms) once. Every upload is processed automatically.
- **Signed delivery** — time-gated, scoped URLs from a global edge. Rotate keys, scope to a track or collection, configure TTLs.
- **Drop-in components** — `<audiodn-player>` and `<audiodn-uploader>` web components, plus headless REST API for fully custom UI.

## URLs

- Marketing site: https://audiodeliverynetwork.com
- Documentation: https://audiodeliverynetwork.com/docs
- API base URL: https://api.audiodelivery.net (all endpoints prefixed with /v1)
- OpenAPI 3.1 spec: https://audiodeliverynetwork.com/openapi.json
- AI-agent integration guide: https://audiodeliverynetwork.com/for-ai-agents
- Account dashboard: https://account.audiodeliverynetwork.com
- Status: https://status.audiodeliverynetwork.com
- Components CDN: https://components.audiodelivery.net

## Authentication

All API endpoints require a bearer token in the `Authorization` header.

- **Server-side API key** — full access. Mint and store on the server only.
- **Client-side keys** — scoped to a single collection or track. Two roles: Player (read-only playback) and Uploader (write to one collection). Safe to embed in browsers and mobile apps.
- Mint and rotate keys in the dashboard at https://account.audiodeliverynetwork.com.

## Five-step minimal setup

1. Sign up at https://account.audiodeliverynetwork.com and mint a server-side API key.
2. (Optional) Create a collection: `POST /v1/collection` with `{ "title": "..." }`.
3. Mint an upload session: `POST /v1/upload_session` with `{ "collection_id": "..." }`. Response includes `upload_session_id`.
4. Create a track within the session: `POST /v1/upload/{upload_session_id}/track` with `{ "file_name": "..." }`. Response includes `track_upload.upload_url`. Upload the audio bytes to that signed URL.
5. Mint a play session: `POST /v1/play_session/track` with `{ "track_id": "...", "variants": ["hq", "lq"] }`. Response includes signed playback URLs.

For a no-code path, log into the dashboard, create a collection, drag-and-drop your audio, and either embed a `<audiodn-player>` snippet or share a generated link.

## Key concepts

- **Organization** — your AudioDN account. Configures default branding and webhooks.
- **Collection** — container for tracks (album, podcast feed, course module).
- **Track** — an audio file with metadata, status (`processing` → `ready`), and one or more variants.
- **Variant** — a processed version of a track (e.g. `hq` 256 kbps MP3, `lq` 96 kbps MP3, preview clip, waveform).
- **Upload session** — short-lived token for uploading one or more tracks to a collection.
- **Play session** — short-lived token granting access to specific tracks/variants. Configurable TTL, scopable to a single end-user.
- **Signed URL** — time-gated playback URL minted by a play session.

## Pricing model

- All plans include free processing, unlimited plays, and zero egress fees.
- Plans differ by storage, max track length, and max file size.
- Three tiers: Creator ($4.99 launch sale, 10 GB), Business ($14.99 launch sale, 50 GB), Platform & Enterprise (custom, 1 TB+).
- Full pricing: https://audiodeliverynetwork.com/pricing

## Trust and security

- Encryption: TLS 1.2+ in transit, AES-256 at rest.
- Signed URLs with configurable TTL; client-side keys scoped to a single resource; full keys server-only.
- Sub-processors: Cloudflare (R2, Workers, edge cache), Stripe (billing).
- We do not train models on your audio.
- Security disclosure: security@audiodeliverynetwork.com
- Full controls list: https://audiodeliverynetwork.com/security

## Documentation map

- /docs — Overview, integration paths, glossary
- /docs/variant-types — Available variant types
- /docs/api — API reference (organizations, collections, tracks, covers, upload sessions, play sessions, variants)
- /docs/integration/web — Drop-in component setup
- /docs/integration/mobile — iOS, Android, Flutter
- /docs/integration/server-side — Full API control
- /docs/integration/hybrid — Server-provisioned sessions with components
- /docs/components/player — Web component reference
- /docs/components/uploader — Uploader component reference
- /docs/components/waveform — Waveform component reference

## Contact

- Sales: sales@audiodeliverynetwork.com
- Support: support@audiodeliverynetwork.com
- Security: security@audiodeliverynetwork.com