# lorem.media — placeholder video, photos, and audio

> Free placeholder media for developers. **Video-first** — HLS adaptive streaming and auto-generated English captions on every clip, served from Cloudflare's edge. No signup, no API keys, no bandwidth caps. URLs are the entire API.

## Get started

```html
<!-- Video, drop-in (mp4) — works in every browser, no player library needed -->
<video src="https://www.lorem.media/video/16x9" autoplay muted loop playsinline></video>

<!-- Video, HLS with auto-captions — production-shape adaptive streaming -->
<video controls playsinline>
  <source src="https://www.lorem.media/video/16x9.m3u8" type="application/vnd.apple.mpegurl">
  <source src="https://www.lorem.media/video/16x9" type="video/mp4">
</video>

<!-- Photo — exact 800×600, smart-cropped -->
<img src="https://www.lorem.media/photo/800/600" alt="placeholder">

<!-- Audio — ~60s public-domain clip -->
<audio src="https://www.lorem.media/audio" controls></audio>

<!-- Deterministic seed for Storybook / snapshot tests -->
<video src="https://www.lorem.media/video/seed/hero/16x9"></video>
```

## Every URL

```
Video — HLS + auto-captions on every clip
  /video                          random video, 720p mp4
  /video/<aspect>                 random at aspect (16x9 / 9x16 / 1x1)
  /video/<aspect>/<height>        specific rung (240/360/480/720/1080)
  /video/<aspect>.m3u8            HLS master playlist (adaptive bitrate)
  /video/seed/<seed>/<aspect>     deterministic
  /video/id/<id>                  specific asset
  /video/id/<id>.m3u8             specific, HLS
  /video/id/<id>.vtt              auto-captions (English, Whisper)

Photos — exact W×H, smart-cropped
  /photo                          random, source size
  /photo/<w>/<h>                  exact W×H
  /photo/seed/<seed>/<w>/<h>      deterministic
  /photo/id/<id>/<w>/<h>          specific asset

Audio — public-domain clips
  /audio                          random ~60s MP3
  /audio/seed/<seed>              deterministic
  /audio/id/<id>                  specific asset

Metadata + bytes
  /v2/list/<type>                 paginated JSON
  /v2/info/<type>/<id>            single asset, full metadata
  /cdn/<key>                      direct byte serving
  /openapi.json                   OpenAPI 3.1 spec
```

**Aspects:** `16x9`, `9x16`, `1x1`. Aliases: `landscape`, `portrait`, `square`; colon form `16:9` also works.

## More

- [Full docs](https://www.lorem.media/llms-full.txt) — patterns, gotchas, metadata API
- [OpenAPI spec](https://www.lorem.media/openapi.json) — programmatic surface
- [0.media](https://0.media) — paid sibling for your own content (same edge, flat-rate pricing, BYO-DRM, signed URLs)