---
title: "Read per-beat music and sound effects."
method: GET
path: "/trailers/{jobId}/storyboard/audio"
tags: ["Trailer"]
---

# Read per-beat music and sound effects.

`GET /trailers/{jobId}/storyboard/audio`

## Request

- Base URL: `https://docs.sleeperhit.studio/api/v1`
- URL: `https://docs.sleeperhit.studio/api/v1/trailers/{jobId}/storyboard/audio`
- Auth: HTTP bearer

Returns each beat's music bed and the sound-effect cues placed within it. This is the per-beat view: every bed is generated for one beat on its own, so beds read here share no tempo, key or phrase with their neighbours. Read the audio timeline instead for anything that spans or crossfades across beats. A fully-scored cut normally shows `music: null` on every beat here: most cuts are scored on the project TIMELINE rather than beat by beat, because a per-beat bed is generated on its own and so shares no tempo, key or phrase with its neighbours. Read `audioTimeline.musicClips` in the response before concluding a cut is silent. Scope: `story:read`.

## Response `200`

Per-beat music beds and placed sound-effect cues, plus `audioTimeline` counts for what is scored on the project timeline instead.

- object
  - `audioTimeline` object: What the per-beat view is NOT showing: music clips, SFX cues and layer count on the project timeline. Non-zero `musicClips` with every beat bed null is the normal state of a scored cut.
    - `musicClips` integer
    - `sfxCues` integer
    - `musicLayers` integer

## Other responses

- `401`: Missing, malformed, revoked, or expired API key.
- `403`: API key is valid but lacks the scope, is blocked by IP allowlist, or the account is disabled.
- `404`: The named project or source does not exist or is owned by another account.
- `429`: Rate limit for this API key + IP + route family was exceeded.
- `500`: The API failed unexpectedly. Safe to retry with the same Idempotency-Key.

---

[API](https://skmtc.dev/sleeperhit/apis/sleeper-hit-studio-story-api.md) · [All operations](https://skmtc.dev/sleeperhit/apis/sleeper-hit-studio-story-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sleeperhit/apis/sleeper-hit-studio-story-api/revisions/86e084144cef?raw)