# Media and dynamic values

> Generated field reference from the AQVEN Python package.

[Read in the browser](https://aqvenstudio.com/reference/media/)

<!-- Generated by tools/generate_reference.py. Do not edit this file by hand. -->

This reference is generated from the package's Pydantic models. Fields use their YAML aliases. Unknown fields are rejected. Cross-field rules implemented by validators may not appear in JSON Schema; run `aqven check` on a complete project.

## Audio

| YAML field | Type | Required | Default | Constraints |
| --- | --- | --- | --- | --- |
| `$media` | `string` | Yes | `—` | maxLength=255, pattern=^audio/[a-z0-9.+-]+$ |
| `blob_id` | `string` | Yes | `—` | pattern=^sha256-[0-9a-f]{64}$ |
| `size_bytes` | `integer` | Yes | `—` | minimum=0 |
| `name` | `string \| null` | Yes | `—` | — |
| `url` | `string \| null` | No | `None` | — |
| `poster_blob_id` | `string \| null` | No | `None` | — |
| `note` | `string \| null` | No | `None` | — |

[JSON Schema](/reference/schemas/Audio.json)

## Document

| YAML field | Type | Required | Default | Constraints |
| --- | --- | --- | --- | --- |
| `$media` | `string` | Yes | `—` | maxLength=255, pattern=^(application\|text)/[a-z0-9.+-]+$ |
| `blob_id` | `string` | Yes | `—` | pattern=^sha256-[0-9a-f]{64}$ |
| `size_bytes` | `integer` | Yes | `—` | minimum=0 |
| `name` | `string \| null` | Yes | `—` | — |
| `url` | `string \| null` | No | `None` | — |
| `poster_blob_id` | `string \| null` | No | `None` | — |
| `note` | `string \| null` | No | `None` | — |

[JSON Schema](/reference/schemas/Document.json)

## DynamicLimits

| YAML field | Type | Required | Default | Constraints |
| --- | --- | --- | --- | --- |
| `max_fields` | `integer` | Yes | `—` | minimum=1 |
| `max_depth` | `integer` | Yes | `—` | minimum=1, maximum=3 |
| `max_text_length` | `integer` | Yes | `—` | minimum=1 |
| `max_items` | `integer` | Yes | `—` | minimum=1 |

[JSON Schema](/reference/schemas/DynamicLimits.json)

## DynamicValue

| YAML field | Type | Required | Default | Constraints |
| --- | --- | --- | --- | --- |
| `value` | `JsonValue` | Yes | `—` | — |
| `fields` | `FieldSpec[]` | Yes | `—` | — |
| `schema_hash` | `string` | Yes | `—` | pattern=^sha256-[0-9a-f]{64}$ |

[JSON Schema](/reference/schemas/DynamicValue.json)

## FieldSpec

| YAML field | Type | Required | Default | Constraints |
| --- | --- | --- | --- | --- |

[JSON Schema](/reference/schemas/FieldSpec.json)

## Image

| YAML field | Type | Required | Default | Constraints |
| --- | --- | --- | --- | --- |
| `$media` | `string` | Yes | `—` | maxLength=255, pattern=^image/[a-z0-9.+-]+$ |
| `blob_id` | `string` | Yes | `—` | pattern=^sha256-[0-9a-f]{64}$ |
| `size_bytes` | `integer` | Yes | `—` | minimum=0 |
| `name` | `string \| null` | Yes | `—` | — |
| `url` | `string \| null` | No | `None` | — |
| `poster_blob_id` | `string \| null` | No | `None` | — |
| `note` | `string \| null` | No | `None` | — |

[JSON Schema](/reference/schemas/Image.json)

## MapItemError

| YAML field | Type | Required | Default | Constraints |
| --- | --- | --- | --- | --- |
| `index` | `integer` | Yes | `—` | minimum=0 |
| `code` | `string` | Yes | `—` | maxLength=64 |
| `message` | `string` | Yes | `—` | maxLength=400 |

[JSON Schema](/reference/schemas/MapItemError.json)

## MediaFileRef

| YAML field | Type | Required | Default | Constraints |
| --- | --- | --- | --- | --- |
| `$media` | `string` | Yes | `—` | minLength=3, maxLength=255, pattern=^[a-z]+/[a-z0-9.+-]+$ |
| `file` | `string` | Yes | `—` | minLength=1, maxLength=1024 |
| `name` | `string \| null` | No | `None` | — |

[JSON Schema](/reference/schemas/MediaFileRef.json)

## MediaValue

| YAML field | Type | Required | Default | Constraints |
| --- | --- | --- | --- | --- |
| `$media` | `string` | Yes | `—` | minLength=3, maxLength=255, pattern=^[a-z]+/[a-z0-9.+-]+$ |
| `blob_id` | `string` | Yes | `—` | pattern=^sha256-[0-9a-f]{64}$ |
| `size_bytes` | `integer` | Yes | `—` | minimum=0 |
| `name` | `string \| null` | Yes | `—` | — |
| `url` | `string \| null` | No | `None` | — |
| `poster_blob_id` | `string \| null` | No | `None` | — |
| `note` | `string \| null` | No | `None` | — |

[JSON Schema](/reference/schemas/MediaValue.json)

## Video

| YAML field | Type | Required | Default | Constraints |
| --- | --- | --- | --- | --- |
| `$media` | `string` | Yes | `—` | maxLength=255, pattern=^video/[a-z0-9.+-]+$ |
| `blob_id` | `string` | Yes | `—` | pattern=^sha256-[0-9a-f]{64}$ |
| `size_bytes` | `integer` | Yes | `—` | minimum=0 |
| `name` | `string \| null` | Yes | `—` | — |
| `url` | `string \| null` | No | `None` | — |
| `poster_blob_id` | `string \| null` | No | `None` | — |
| `note` | `string \| null` | No | `None` | — |

[JSON Schema](/reference/schemas/Video.json)
