# The storyboard preview object

## Attributes

- `object` (string, required):
- `id` (string, required): Id of the preview.
- `film_id` (string, required): Id of the film.
- `status` (enum, required):  Values: `queued`, `rendering`, `ready`, `failed`, `expired`.
- `storyboard_version` (integer, required): Version of the storyboard the preview shows.
- `current` (boolean, required): true if every scene is current and the preview belongs to the current storyboard.
- `duration_s` (nullable number, required): Duration in seconds (planned until ready).
- `fps` (nullable number, required): Frames per second.
- `resolution` (nullable string, required): Resolution, e.g. 1280x720.
- `bytes` (nullable integer, required): Size of the file in bytes (when ready).
- `sha256` (nullable string, required): SHA-256 of the file (hex, when ready); the same as the ETag of the download.
- `watermark` (boolean, required): true: the preview carries a visible watermark.
- `scenes` (array of objects, required):
  - `nr` (integer, required): Number of the scene.
  - `start_s` (number, required): Start of the scene in the preview (seconds).
  - `end_s` (number, required): End of the scene in the preview (seconds).
  - `state` (enum, required): current: clip of the current version; stale: clip of an earlier version (marked „outdated“); missing: no clip yet (dark panel). Values: `current`, `stale`, `missing`.
- `file_url` (nullable string, required): Path of the file download (when ready).
- `created_at` (string (date-time), required): Time of the request (UTC).
- `ready_at` (nullable string (date-time), required): Time the preview became ready (UTC).
- `expires_at` (nullable string (date-time), required): Time the preview expires (UTC); afterwards the file is deleted.

## Example

```json
{
  "object": "storyboard_preview",
  "id": "pv_8c1e4a7d2b5f9e3c6a0d1b4e7f2a5c8d",
  "film_id": "k7m2xq9v4t8n1b5r3c6d0wza",
  "status": "ready",
  "storyboard_version": 1,
  "current": true,
  "duration_s": 181.2,
  "fps": 25,
  "resolution": "1280x720",
  "bytes": 18342210,
  "sha256": "3a7bd3e2360a3d29eea436fcfb7e44c735d117c42d1c1835420b6b9942dd4f1b",
  "watermark": true,
  "scenes": [
    {
      "nr": 1,
      "start_s": 0,
      "end_s": 12.4,
      "state": "current"
    },
    {
      "nr": 2,
      "start_s": 12.4,
      "end_s": 25.9,
      "state": "current"
    }
  ],
  "file_url": "https://api.cream-ai.de/api/v1/films/k7m2xq9v4t8n1b5r3c6d0wza/storyboard-preview/file?preview_id=pv_8c1e4a7d2b5f9e3c6a0d1b4e7f2a5c8d",
  "created_at": "2026-11-10T08:25:00Z",
  "ready_at": "2026-11-10T08:27:41Z",
  "expires_at": "2026-11-24T08:27:41Z"
}
```