# The template object

## Attributes

- `object` (string, required):
- `id` (string, required): Id of the template in mint.
- `key` (string, required): Key of the template, unique in the company. Use it as template in POST /films.
- `name` (string, required):
- `language` (nullable enum, required): Language the template sets, or null if it does not set one. Values: `de`, `en`, `fr`, `es`, `it`, `pt`, `nl`, `pl`, `cs`, `sk`, `hu`, `ro`, `hr`, `sl`, `sv`, `da`, `no`, `fi`, `tr`, `id`, `vi`, `el`, `uk`, `ru`, `bg`.
- `settings` (object, required): Values the template sets, with the names and values of settings in POST /films. Fields the template does not set are missing.
  - `format` (enum): Aspect ratio. Missing if the template does not set it. Values: `16x9`, `9x16`, `1x1`.
  - `style_id` (string): Id of the style. Missing if the template does not set it.
  - `brand_id` (nullable string): Brand, or null for no brand. Missing: mint chooses the brand automatically.
  - `voice_id` (nullable string): Voice, or null for the automatic voice. Missing if the template does not set it.
  - `narration_mode` (enum): How the text is spoken. Missing if the template does not set it. Values: `verbatim`, `smooth`, `free`.
  - `tempo` (enum): Pace of the film. Missing if the template does not set it. Values: `presenting`, `lively`, `kinetic`.
  - `freedom` (enum): Creative freedom in percent. Missing if the template does not set it. Values: `0`, `25`, `40`, `65`, `100`.
  - `video_share` (enum): Share of moving video clips in percent. Missing if the template does not set it. Values: `0`, `25`, `50`, `75`, `100`.
  - `target_duration_s` (integer): Target duration in seconds (in steps of 6 seconds). Templates in mint allow up to 60 minutes; POST /films accepts at most 900 seconds in settings. Missing if the template does not set it.
- `updated_at` (string (date-time), required): Last change of the template (UTC).

## Example

```json
{
  "object": "template",
  "id": "tpl_51",
  "key": "lesson-standard",
  "name": "Lesson – standard",
  "language": "de",
  "settings": {
    "format": "16x9",
    "style_id": "b6ed57e1-2c4f-4b8a-9d3e-6f1a0c2b7e45",
    "brand_id": "brand-northwind-x7k2p9",
    "voice_id": "Xb7hH8MSUJpSbSDYk0k2",
    "narration_mode": "verbatim",
    "tempo": "presenting",
    "freedom": 40,
    "video_share": 25,
    "target_duration_s": 180
  },
  "updated_at": "2026-10-30T16:20:00Z"
}
```