Previous value: -"Exact target length in seconds, inside the duration_profile's range (e.g. 300 for «five minutes» in watch_standard). Without it the profile's own target governs."New value: +"Exact target length in seconds (e.g. 210 for «3:30»). It governs the duration profile: if it falls outside the profile's range, the profile whose range contains it governs and the response says so (`durationProfileSource: target_duration_sec`, `durationProfileDisplaced` names the profile it replaced). Without a profile it picks the one that contains it. Without it the profile's own target governs."

Previous value: -"The idea, in the creator's words (topic, angle, what the viewer takes away)."New value: +"The request, in the creator's words. A single idea is enough; a full brief is honored whole: title, thesis, structure and timing, how the piece opens and closes, what it may claim and from which sources, its look and sound, what to avoid, text that appears on screen. The writers and the direction receive it complete, up to 16000 characters; a longer request is rejected, and long reference material travels in `source`. Sources named by URL are read as primary material; when the request states that facts come only from them, nothing outside those sites is used."

Added value: +16000

Added value: +{
+  "description": "The creator's own uploaded files that belong to this piece (footage, photos, a recorded voice). Each item names one file of the personal library by its `assetId`: the id alone, or an object with `asset_id` and a `purpose` (what the file is for in the piece). The files are stored with the piece; the answer says what the piece does with them (`direction`), and they are not part of the price. While a file is still being verified, the `handle` of its upload is accepted in place of the id, and the request is answered as not ready; a file that is not in the caller's library is answered as not usable.",
+  "items": {
+    "anyOf": [
+      {
+        "description": "The `assetId` of a file of the personal library.",
+        "type": "string"
+      },
+      {
+        "properties": {
+          "asset_id": {
+            "description": "The `assetId` of a file of the personal library.",
+            "type": "string"
+          },
+          "purpose": {
+            "description": "What the file is for in the piece, e.g. 'the interview that closes the piece'.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "asset_id"
+        ],
+        "type": "object"
+      }
+    ]
+  },
+  "type": "array"
+}

Previous value: -"Who narrates and who appears. THREE ways, and you can mix them: (a) name someone from `list_cast` by `id` or `@handle` (`voice` / `face`) — a name that does not resolve is an error, never a silent fallback; (b) DESCRIBE the presenter you want in `describe_face` and casting picks the closest face from the catalogue — with enough detail (features, or two of gender/age/ethnicity) it can GENERATE a new one for this piece, which costs money and needs `production.confirm_spend=true`; (c) say nothing and the casting decides by ear. `on_camera` puts the presenter on screen. A named `face` wins over `describe_face`."New value: +"Who narrates and who appears, in THREE ways that combine: (a) a name from the catalogue of voices and presenters, by `id` or `@handle` (`voice` / `face`) — a name that does not resolve is an error, not a silent fallback; (b) the wanted presenter DESCRIBED in `describe_face`, which casting resolves to the closest face of the catalogue — with enough detail (features, or two of gender/age/ethnicity) it can GENERATE a new one for this piece, which costs money and needs `production.confirm_spend=true`; (c) nothing, and casting decides by ear. `on_camera` puts the presenter on screen. A named `face` wins over `describe_face`."

Previous value: -"The presenter you want, in words, when no catalogue handle fits. Casting resolves it against the catalogue and may generate."New value: +"The wanted presenter, in words, for when no catalogue handle fits. Casting resolves it against the catalogue and may generate one."

Previous value: -"Presenter `id` or `@handle` from `list_cast`."New value: +"A presenter `id` or `@handle` from the catalogue of nameable presenters."

Previous value: -"Voice `id` or `@handle` from `list_cast`."New value: +"A voice `id` or `@handle` from the catalogue of nameable voices."

Previous value: -"The format/style referent id (see `list_referents`)."New value: +"The format referent id from Vixdeo's catalogue of formats."

Previous value: -"How to produce it. Omit for the platform defaults."New value: +"The production settings; without them, the platform defaults apply."

Previous value: -"Run the whole line to the final video (default true)."New value: +"Whether the whole line runs to the final video (default true)."

Previous value: -"Required true for formats that declare `requiresSpendConfirmation` (the wallet must also cover the band: otherwise `insufficient-funds-for-estimate` and no project is created)."New value: +"True confirms the spend of a format that declares `requiresSpendConfirmation`; the wallet also has to cover the band, otherwise the answer is `insufficient-funds-for-estimate` and no project is created."

Previous value: -"Alternative to `confirm_spend`: the `economics.requestRef` that `estimate` returned for THIS exact request — an informed confirmation. A ref of another request is rejected (`spend-not-confirmed`)."New value: +"Alternative to `confirm_spend`: the `economics.requestRef` of the price quote for THIS exact request — an informed confirmation. A ref of another request is rejected (`spend-not-confirmed`)."

Previous value: -"Target length profile (see `list_referents.durationProfiles` for seconds)."New value: +"Target length profile (`durationProfiles` in the catalogue of formats gives the seconds)."

Previous value: -"What to do when the era check finds an anachronism in a GENERATED shot (a modern helmet in 1906): `note` records it and mounts the shot; `rebuy` buys the shot again ONCE, telling the generator what to avoid, within the piece's recomposition cap. Omit it and the budget tier decides (premium rebuys; standard and economy note)."New value: +"What happens when the era check finds an anachronism in a GENERATED shot (a modern helmet in 1906): `note` records it and mounts the shot; `rebuy` buys the shot again ONCE, telling the generator what to leave out, within the piece's recomposition cap. Without it the budget tier decides (premium rebuys; standard and economy note)."

Previous value: -"Language of the SUBTITLES (BCP-47: `es`, `pt-BR`…). Its OWN axis, independent of `target_language`: omit it and the subtitles follow the piece; declare it and the piece is narrated in one language and read in another (measured: 21 live projects declare the two on purpose)."New value: +"Language of the SUBTITLES (BCP-47: `es`, `pt-BR`…), its OWN axis, independent of `target_language`: without it the subtitles follow the piece; with it the piece is narrated in one language and read in another (measured: 21 live projects declare the two on purpose)."

Previous value: -"How the script is written — see `list_referents.writingProfiles` for each profile's meaning and the measured cost/time ratio per format. Default `estandar`."New value: +"How the script is written (`writingProfiles` in the catalogue of formats gives each profile's meaning and the measured cost/time ratio per format). Default `estandar`."

Previous value: -"The idea, in your own words (topic, angle, what the viewer should take away)."New value: +"The idea, in the creator's words (topic, angle, what the viewer takes away)."

Previous value: -"Your OWN material. `kind=script` + `respect=strict`: the piece narrates your text verbatim (you keep word-level control from the start); `kind=content`: an article/notes the Director adapts (`respect` guided|adaptive). Omit to let the Director write from `prompt_seed`."New value: +"The creator's OWN material. `kind=script` + `respect=strict`: the piece narrates the text verbatim (word-level control from the start); `kind=content`: an article or notes the Director adapts (`respect` guided|adaptive). Without it the Director writes from `prompt_seed`."