changedInput schema / properties / document / properties / brief / properties / native / oneOf
Previous value: -[
- {
- "additionalProperties": false,
- "properties": {
- "input": {
- "additionalProperties": false,
- "properties": {
- "actor_gender": {
- "description": "Gender of the face in image: female | male. Only with image: picks the default voice of that gender (female: sarah, male: george; on gemini-3.8-flash-tts: kore and charon). Refused with actor_id (its gender is known) and without image. An explicit voice or voice_id wins and the response warns that actor_gender changed nothing.",
- "enum": [
- "female",
- "male"
- ],
- "type": "string"
- },
- "actor_id": {
- "description": "Saved Clipwright actor ID from list_actors. Choose actor_id, image, or person; do not combine them. Without voice or voice_id the voice follows the actor's gender. Do not combine with actor_gender.",
- "pattern": "^actor_[a-z0-9][a-z0-9_-]{0,63}$",
- "type": "string"
- },
- "aspect_ratio": {
- "description": "Output format: 9:16 | 1:1 | 16:9. Omitted means 9:16, and a source of another shape is snapped to 9:16 with a warning — pass it explicitly whenever you pass image. A mismatch above 15% between the request and the source is refused (aspect_conflict) before any charge.",
- "enum": [
- "9:16",
- "1:1",
- "16:9"
- ],
- "type": "string"
- },
- "background": {
- "enum": [
- "white",
- "blur",
- "contain"
- ],
- "type": "string"
- },
- "broll_policy": {
- "description": "Saved policy for B-roll: anyone allows people including the actor; no_actor excludes the actor; no_people excludes all people, including hands. Segmented media generation is closed. This setting is stored only and has no effect on actor-only videos. Run override wins over the account actor default; otherwise no_people.",
- "enum": [
- "anyone",
- "no_actor",
- "no_people"
- ],
- "type": "string"
- },
- "call": {
- "additionalProperties": false,
- "description": "A phone call after a quote: the presenter listens, then freezes while the call plays as a phone line, with a ring first, and an in-call phone beside them shows it (a phone_call template covering the call is used instead). Needs script, a 9:16 frame and words after it. The frozen presenter and the call add production seconds, not presenter seconds, and a live-avatar still shown on the call has its own price in list_prices. Long-form qualification on the server.",
- "properties": {
- "after": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "endWord": {
- "exclusiveMinimum": 0,
- "maximum": 9007199254740991,
- "type": "integer"
- },
- "startWord": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "startWord",
- "endWord"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "occurrence": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "quote": {
- "maxLength": 10000,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "quote"
- ],
- "type": "object"
- }
- ],
- "description": "The words the call follows: the presenter stops after the quote's last word and resumes on the next one."
- },
- "lines": {
- "description": "The call's turns in order, from both speakers; at most 1500 characters and about 45 s in all.",
- "items": {
- "additionalProperties": false,
- "properties": {
- "speaker": {
- "enum": [
- "agent",
- "caller"
- ],
- "type": "string"
- },
- "text": {
- "maxLength": 400,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "speaker",
- "text"
- ],
- "type": "object"
- },
- "maxItems": 12,
- "minItems": 2,
- "type": "array"
- },
- "phone": {
- "additionalProperties": false,
- "description": "The in-call phone drawn over the call when no phone_call template covers it; omitted fields are +1 (305) 555-0147 with its digits after the area code masked, \"Hold This Call?\" and \"You'll be notified to pick up.\".",
- "properties": {
- "banner": {
- "maxLength": 32,
- "minLength": 1,
- "type": "string"
- },
- "banner_note": {
- "maxLength": 48,
- "minLength": 1,
- "type": "string"
- },
- "caller": {
- "maxLength": 24,
- "minLength": 1,
- "type": "string"
- },
- "mask_number": {
- "type": "boolean"
- }
- },
- "type": "object"
- },
- "stage": {
- "additionalProperties": false,
- "description": "Where the in-call phone settles and how it rises, as a reference measured them (plan_reference_remake writes it); omitted is the reference call scene's own place and rise.",
- "properties": {
- "enter": {
- "additionalProperties": false,
- "properties": {
- "anchor": {
- "additionalProperties": false,
- "description": "When the rise starts: seconds from the call's freeze, negative before it.",
- "properties": {
- "id": {
- "const": "freeze_start#1",
- "type": "string"
- },
- "offset_s": {
- "maximum": 0,
- "minimum": -10,
- "type": "number"
- }
- },
- "required": [
- "id",
- "offset_s"
- ],
- "type": "object"
- },
- "displacement": {
- "additionalItems": false,
- "description": "Settled minus first position, in shares of width and height.",
- "items": [
- {
- "maximum": 1,
- "minimum": -1,
- "type": "number"
- },
- {
- "maximum": 1,
- "minimum": -1,
- "type": "number"
- }
- ],
- "maxItems": 2,
- "minItems": 2,
- "type": "array"
- },
- "duration_s": {
- "maximum": 5,
- "minimum": 0.1,
- "type": "number"
- },
- "from": {
- "enum": [
- "bottom",
- "lower_left",
- "lower_right"
- ],
- "type": "string"
- }
- },
- "required": [
- "from",
- "displacement",
- "duration_s",
- "anchor"
- ],
- "type": "object"
- },
- "layer": {
- "enum": [
- "behind_presenter"
- ],
- "type": "string"
- },
- "rect": {
- "additionalProperties": false,
- "description": "Where the phone settles, in shares of the frame.",
- "properties": {
- "height": {
- "maximum": 1,
- "minimum": 0,
- "type": "number"
- },
- "left": {
- "maximum": 1,
- "minimum": 0,
- "type": "number"
- },
- "top": {
- "maximum": 1,
- "minimum": 0,
- "type": "number"
- },
- "width": {
- "maximum": 1,
- "minimum": 0,
- "type": "number"
- }
- },
- "required": [
- "left",
- "top",
- "width",
- "height"
- ],
- "type": "object"
- },
- "rect_face": {
- "additionalProperties": false,
- "description": "The same place relative to the presenter's face: origin the face centre, unit the face height.",
- "properties": {
- "height": {
- "exclusiveMinimum": 0,
- "maximum": 20,
- "type": "number"
- },
- "left": {
- "maximum": 20,
- "minimum": -20,
- "type": "number"
- },
- "top": {
- "maximum": 20,
- "minimum": -20,
- "type": "number"
- },
- "width": {
- "exclusiveMinimum": 0,
- "maximum": 20,
- "type": "number"
- }
- },
- "required": [
- "left",
- "top",
- "width",
- "height"
- ],
- "type": "object"
- }
- },
- "required": [
- "rect"
- ],
- "type": "object"
- },
- "voices": {
- "additionalProperties": false,
- "description": "Voice names from list_voices; omitted means en_female_cassidy for the agent and en_male_mark for the caller.",
- "properties": {
- "agent": {
- "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$",
- "type": "string"
- },
- "caller": {
- "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$",
- "type": "string"
- }
- },
- "type": "object"
- }
- },
- "required": [
- "after",
- "lines"
- ],
- "type": "object"
- },
- "caption_emphasis": {
- "description": "Key words or short phrases to emphasise, each quoted from script and matched as an insert quote is (case and punctuation ignored). An item is the quote, or { quote, look }: look punch shows a small lead-in line from the same sentence over the quote as a large glowing keyword, look pill shows the quote alone in a rounded pill, look color shows it in the accent colour at the same size. Without a look, punch draws punch, hormozi and accent draw color, and other presets draw the quote larger in their highlight colour. Every occurrence is emphasised. Requires captions=true and script; a quote absent from script is refused before any charge.",
- "items": {
- "anyOf": [
- {
- "maxLength": 40,
- "minLength": 1,
- "type": "string"
- },
- {
- "additionalProperties": false,
- "properties": {
- "look": {
- "enum": [
- "punch",
- "pill",
- "color"
- ],
- "type": "string"
- },
- "punch_in": {
- "description": "Long form only: zoom into the presenter while the quote is spoken. Drawn only where captions are drawn and the presenter is on screen; otherwise warnings[] names it.",
- "type": "boolean"
- },
- "quote": {
- "maxLength": 40,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "quote"
- ],
- "type": "object"
- }
- ]
- },
- "maxItems": 20,
- "minItems": 1,
- "type": "array"
- },
- "caption_mode": {
- "description": "full (default when omitted): every spoken word is captioned. highlights: captions appear only around caption_emphasis quotes (lead-in, quote, short tail) and nowhere else; requires caption_emphasis. In both modes captions are hidden while a full-frame insert is on screen or a template meets their band.",
- "enum": [
- "full",
- "highlights"
- ],
- "type": "string"
- },
- "caption_position": {
- "description": "Where captions sit: top, middle, lower or bottom (80% of the height). Omitted means the caption_style's own place. Requires captions=true.",
- "enum": [
- "top",
- "middle",
- "lower",
- "bottom"
- ],
- "type": "string"
- },
- "caption_style": {
- "default": "hormozi",
- "description": "Caption look when captions=true. hormozi: the default: heavy white uppercase with a thick black outline, up to three words per cue, one keyword per cue in yellow (emphasised, else the longest non-stop-word). accent: condensed bold white uppercase, no outline, up to three words per cue, one keyword per cue in orange (emphasised, else the longest non-stop-word). tiktok: bold rounded uppercase, one or two words at a time; the spoken word turns yellow and grows. youtube: clean bold sans-serif, five words on a dark rounded box near the bottom; words fade in, the spoken word in red. instagram: comic uppercase with a pink outline, two words at a time; the spoken word pops in orange. minimalist: plain sans-serif, five words on a half-transparent dark band, gentle fade. neon: cyan uppercase with a magenta outline, two words at a time; the spoken word pops in white. genz: large comic uppercase, one word at a time, slamming in with a pink highlight. campfire: rounded comic uppercase, three words; spoken words light up gold and stay lit. midnight: spooky uppercase, two words, slow fade; the spoken word in red. plottwist: heavy sans-serif, three words; the spoken word turns sky blue and grows. headline: tall condensed uppercase on a solid black band, three words; the spoken word scales up in yellow. promo: heavy sans-serif on a blue pill, three words; the spoken word pops in yellow. lecture: readable sans-serif, six words on a dark rounded box; the spoken word in green. highlighter: heavy sans-serif, four words; spoken words turn lime and stay lit. studio: sans-serif, seven words typed in on a blurred dark box; the spoken word in amber. broadcast: outlined sans-serif, eight words low in the frame; the spoken word in pale yellow. arcade: blocky yellow uppercase, two words; the spoken word bounces in white. clutch: brush uppercase, one word at a time, slamming in green. bubblegum: rounded display letters with a pink outline, two words; the spoken word bounces in yellow. crayon: marker handwriting with a navy outline, two words; the spoken word pops in orange. lyrics: handwritten script, five words; spoken words light up pink and stay lit. bassdrop: outlined display uppercase, one word at a time, scaling in orange. punch: mid-frame setup and punch: a small white lead-in line over one or two large blue glowing keywords; other words small and white. Alias: minimal draws minimalist. A font that cannot draw the script's letters is replaced by a plain sans-serif. Previews: https://clipwright.io/captions",
- "enum": [
- "hormozi",
- "accent",
- "tiktok",
- "youtube",
- "instagram",
- "minimalist",
- "neon",
- "genz",
- "campfire",
- "midnight",
- "plottwist",
- "headline",
- "promo",
- "lecture",
- "highlighter",
- "studio",
- "broadcast",
- "arcade",
- "clutch",
- "bubblegum",
- "crayon",
- "lyrics",
- "bassdrop",
- "punch",
- "minimal"
- ],
- "type": "string"
- },
- "captions": {
- "default": false,
- "description": "Burn word-timed captions into the video, over the presenter and over inserts. Not available with segments.",
- "type": "boolean"
- },
- "edit_sounds": {
- "description": "A low sound on every cut (insert, full-frame template, layout window, framing), its peak on the cut. Needs inserts, layout_windows or framing; template_sounds.edit picks it (list_template_sounds). Price unchanged.",
- "type": "boolean"
- },
- "framing": {
- "description": "Text-anchored presenter sizes: each cuts to close or medium on its words and back to the take where they end. Items may not overlap one another, an insert or a layout window. A framing drawn wholly under full-frame templates is named in warnings[]. Where a punch_in emphasis meets a framing, the framing is drawn. Requires script and long-form qualification on the server; the price does not change.",
- "items": {
- "additionalProperties": false,
- "properties": {
- "anchor": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "endWord": {
- "exclusiveMinimum": 0,
- "maximum": 9007199254740991,
- "type": "integer"
- },
- "startWord": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "startWord",
- "endWord"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "occurrence": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "quote": {
- "maxLength": 10000,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "quote"
- ],
- "type": "object"
- }
- ],
- "description": "The words it starts on, as an insert anchor: { startWord, endWord } or { quote, occurrence? }."
- },
- "cover_words": {
- "description": "How many spoken words the size holds, counted from the first word of its anchor. Omitted means the anchored words only.",
- "exclusiveMinimum": 0,
- "maximum": 10000,
- "type": "integer"
- },
- "id": {
- "description": "Unique across inserts, overlays, layout_windows, templates and framing.",
- "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$",
- "type": "string"
- },
- "size": {
- "default": "close",
- "description": "close: the presenter 1.18 times larger about the face; medium: the take as rendered.",
- "enum": [
- "close",
- "medium"
- ],
- "type": "string"
- },
- "transition": {
- "default": "cut",
- "description": "cut: a hard cut to the size; flash: a warm light leak over the cut.",
- "enum": [
- "cut",
- "flash"
- ],
- "type": "string"
- }
- },
- "required": [
- "id",
- "anchor"
- ],
- "type": "object"
- },
- "maxItems": 20,
- "minItems": 1,
- "type": "array"
- },
- "image": {
- "description": "Public https url of the actor's photo (PNG, JPEG or WebP, up to 10 MB). A file on disk goes through upload_image (POST /v1/uploads) first — pass the url it returns. A source we cannot use — private or loopback host, http, unreachable, redirecting, over 10 MB, or not one of those image types — is refused (unusable_source) before any charge. We do not detect the face's gender: pass actor_gender or voice, or the default male voice is used with a warning.",
- "format": "starts_with",
- "maxLength": 2048,
- "pattern": "^https:\\/\\/.*",
- "type": "string"
- },
- "inserts": {
- "description": "Text-anchored image or video inserts over full narration, each covering cover_words spoken words from its anchor; requires long-form qualification on the server, 1080p and explicit broll_policy=anyone. Captions draw over inserts.",
- "items": {
- "additionalProperties": false,
- "properties": {
- "anchor": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "endWord": {
- "exclusiveMinimum": 0,
- "maximum": 9007199254740991,
- "type": "integer"
- },
- "startWord": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "startWord",
- "endWord"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "occurrence": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "quote": {
- "maxLength": 10000,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "quote"
- ],
- "type": "object"
- }
- ]
- },
- "asset_id": {
- "description": "A ready PNG or JPEG image or MP4 video from your own assets (list_assets), instead of media_url. Pass exactly one of the two; media_type must match the asset's kind.",
- "pattern": "^ast_[a-f0-9]{32}$",
- "type": "string"
- },
- "cover_words": {
- "description": "How many spoken words this insert covers, counted from the first word of its anchor. Omitted means the anchored words only. The insert ends where the first uncovered word begins, so inserts whose coverage meets are adjacent frame for frame and leave no actor shot between them.",
- "exclusiveMinimum": 0,
- "maximum": 10000,
- "type": "integer"
- },
- "id": {
- "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$",
- "type": "string"
- },
- "image_motion": {
- "additionalProperties": false,
- "description": "Optional picture zoom. A picture always fills the frame, cut to its shape when the shapes differ (warnings[] names the share cut). amount is the zoom beyond filling: in grows from 1 to 1+amount, out shrinks from 1+amount to 1. No motion by default.",
- "properties": {
- "amount": {
- "exclusiveMaximum": 1,
- "minimum": 0,
- "type": "number"
- },
- "direction": {
- "enum": [
- "in",
- "out"
- ],
- "type": "string"
- }
- },
- "required": [
- "direction",
- "amount"
- ],
- "type": "object"
- },
- "media_type": {
- "description": "image (PNG or JPEG) or video (MP4, H.264 or HEVC, 8-bit SDR). A video plays muted from its first frame and is cut where its words end; one shorter than its words holds its last frame, and warnings[] names it.",
- "enum": [
- "image",
- "video"
- ],
- "type": "string"
- },
- "media_url": {
- "description": "Public https URL of the media. Pass exactly one of media_url or asset_id.",
- "format": "starts_with",
- "maxLength": 2048,
- "pattern": "^https:\\/\\/.*",
- "type": "string"
- },
- "transition": {
- "description": "How the insert comes in and goes out: cut (default), wipe (slides across the presenter), flash (a white flash on the cut) or zoom (eases in from a closer framing). It never moves the insert's start or end.",
- "enum": [
- "cut",
- "wipe",
- "flash",
- "zoom"
- ],
- "type": "string"
- }
- },
- "required": [
- "id",
- "media_type",
- "anchor"
- ],
- "type": "object"
- },
- "maxItems": 49,
- "minItems": 1,
- "type": "array"
- },
- "layout_windows": {
- "description": "Text-anchored reframings of the presenter: split (9:16 only) or card. Windows may not overlap one another or an insert. Same requirements as inserts. A covered or blurred presenter is still delivered vendor work and is billed as face time.",
- "items": {
- "additionalProperties": false,
- "properties": {
- "anchor": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "endWord": {
- "exclusiveMinimum": 0,
- "maximum": 9007199254740991,
- "type": "integer"
- },
- "startWord": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "startWord",
- "endWord"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "occurrence": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "quote": {
- "maxLength": 10000,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "quote"
- ],
- "type": "object"
- }
- ],
- "description": "The words it starts on, as an insert anchor: { startWord, endWord } or { quote, occurrence? }."
- },
- "asset_id": {
- "description": "A ready PNG or JPEG image or MP4 video from your own assets (list_assets), instead of media_url. Pass exactly one of the two; media_type must match the asset's kind.",
- "pattern": "^ast_[a-f0-9]{32}$",
- "type": "string"
- },
- "blur_presenter": {
- "description": "Card only: blur the presenter behind the card.",
- "type": "boolean"
- },
- "cover_words": {
- "description": "How many spoken words it stays on screen, counted from the first word of its anchor. Omitted means the anchored words only.",
- "exclusiveMinimum": 0,
- "maximum": 10000,
- "type": "integer"
- },
- "enter": {
- "description": "How it appears: cut (default), fade, slide (in from the nearest edge) or tilt_in. It leaves with a cut.",
- "enum": [
- "cut",
- "fade",
- "slide",
- "tilt_in"
- ],
- "type": "string"
- },
- "id": {
- "description": "Unique across inserts, overlays and layout_windows.",
- "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$",
- "type": "string"
- },
- "layout": {
- "description": "split: presenter in the top half, media in the bottom half, captions on the seam (9:16 only). card: the media in a centred card over the presenter.",
- "enum": [
- "split",
- "card"
- ],
- "type": "string"
- },
- "media_type": {
- "description": "image (PNG or JPEG) or video (MP4, H.264 or HEVC, 8-bit SDR). A video plays muted from its first frame and is cut where its words end; one shorter than its words holds its last frame, and warnings[] names it.",
- "enum": [
- "image",
- "video"
- ],
- "type": "string"
- },
- "media_url": {
- "description": "Public https URL of the media. Pass exactly one of media_url or asset_id.",
- "format": "starts_with",
- "maxLength": 2048,
- "pattern": "^https:\\/\\/.*",
- "type": "string"
- }
- },
- "required": [
- "id",
- "media_type",
- "anchor",
- "layout"
- ],
- "type": "object"
- },
- "maxItems": 5,
- "minItems": 1,
- "type": "array"
- },
- "look": {
- "default": "natural",
- "enum": [
- "natural",
- "commercial",
- "raw_iphone"
- ],
- "type": "string"
- },
- "name": {
- "maxLength": 100,
- "type": "string"
- },
- "overlays": {
- "description": "Text-anchored images or videos over the visible presenter, in a corner or a band at the top or bottom. At most 2 on screen at once, and two on screen together need positions that do not share a corner. Captions move to the middle or bottom third when an overlay meets them, never up over the face, and hide while neither is free. An overlay is not drawn while a full-frame insert is on screen. Same requirements as inserts: script, long-form qualification on the server, 1080p and explicit broll_policy=anyone. The presenter stays on screen, so the price does not change.",
- "items": {
- "additionalProperties": false,
- "properties": {
- "anchor": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "endWord": {
- "exclusiveMinimum": 0,
- "maximum": 9007199254740991,
- "type": "integer"
- },
- "startWord": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "startWord",
- "endWord"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "occurrence": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "quote": {
- "maxLength": 10000,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "quote"
- ],
- "type": "object"
- }
- ],
- "description": "The words it starts on, as an insert anchor: { startWord, endWord } or { quote, occurrence? }."
- },
- "asset_id": {
- "description": "A ready PNG or JPEG image or MP4 video from your own assets (list_assets), instead of media_url. Pass exactly one of the two; media_type must match the asset's kind.",
- "pattern": "^ast_[a-f0-9]{32}$",
- "type": "string"
- },
- "cover_words": {
- "description": "How many spoken words it stays on screen, counted from the first word of its anchor. Omitted means the anchored words only.",
- "exclusiveMinimum": 0,
- "maximum": 10000,
- "type": "integer"
- },
- "enter": {
- "description": "How it appears: cut (default), fade, slide (in from the nearest edge) or tilt_in. It leaves with a cut.",
- "enum": [
- "cut",
- "fade",
- "slide",
- "tilt_in"
- ],
- "type": "string"
- },
- "id": {
- "description": "Unique across inserts, overlays and layout_windows.",
- "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$",
- "type": "string"
- },
- "media_type": {
- "description": "image (PNG or JPEG) or video (MP4, H.264 or HEVC, 8-bit SDR). A video plays muted from its first frame and is cut where its words end; one shorter than its words holds its last frame, and warnings[] names it.",
- "enum": [
- "image",
- "video"
- ],
- "type": "string"
- },
- "media_url": {
- "description": "Public https URL of the media. Pass exactly one of media_url or asset_id.",
- "format": "starts_with",
- "maxLength": 2048,
- "pattern": "^https:\\/\\/.*",
- "type": "string"
- },
- "position": {
- "description": "A corner (top_left, top_right, bottom_left, bottom_right), or a band across the top or bottom.",
- "enum": [
- "top_left",
- "top_right",
- "bottom_left",
- "bottom_right",
- "top",
- "bottom"
- ],
- "type": "string"
- }
- },
- "required": [
- "id",
- "media_type",
- "anchor",
- "position"
- ],
- "type": "object"
- },
- "maxItems": 10,
- "minItems": 1,
- "type": "array"
- },
- "pause_trim": {
- "additionalProperties": false,
- "description": "Shorten narration pauses longer than these seconds, cutting silence only.",
- "properties": {
- "comma_s": {
- "maximum": 2,
- "minimum": 0.05,
- "type": "number"
- },
- "mid_phrase_s": {
- "maximum": 2,
- "minimum": 0.05,
- "type": "number"
- },
- "sentence_end_s": {
- "maximum": 2,
- "minimum": 0.05,
- "type": "number"
- }
- },
- "type": "object"
- },
- "person": {
- "maxLength": 500,
- "minLength": 1,
- "type": "string"
- },
- "presenter_framing": {
- "description": "close (default) or wide: presenter lower, room above. Needs the actor's wide view (list_actors), 9:16 only; else close plus warnings[].",
- "enum": [
- "close",
- "wide"
- ],
- "type": "string"
- },
- "presenter_mic": {
- "description": "true: presenter holds a tiny mic. Needs the actor's mic view in that framing (list_actors; library ones are wide); else no mic plus warnings[].",
- "type": "boolean"
- },
- "resolution": {
- "description": "Output resolution: 720p | 1080p | 4k (short side 720 / 1080 / 2160 px). Omitted means 1080p.",
- "enum": [
- "720p",
- "1080p",
- "4k"
- ],
- "type": "string"
- },
- "script": {
- "description": "The words the actor says; required unless segments supplies the spoken text. Segments and text-anchored inserts require long-form qualification on the server. Script limits by speech model: eleven_v3: 5000 characters; eleven_flash_v2_5: 10000 characters; eleven_turbo_v2_5: 10000 characters; eleven_v4: 5000 characters; gemini-3.8-flash-tts: 5000 characters. Count includes spaces, audio tags and stress marks; emoji may count as two characters. Break tags are cut from the text sent to eleven_v4 and gemini-3.8-flash-tts and are not counted there. There is no word-count limit. Duration and price are estimates until measured. Russian stress: write the stressed vowel as a capital inside a lowercase word (\"потОм\", \"зАмок\") and eleven_v4 and gemini-3.8-flash-tts receive it as the stress mark U+0301 (\"пото́м\"); a mark typed directly is kept. A capital at the start of a word stays a capital, and a word with a second capital or a capital consonant inside (all caps, \"ВУЗы\") is left as it is. A single capital vowel inside a word is always read as stress, so write \"Яндекс Еда\", not \"ЯндексЕда\". Tell users writing in Russian that they can mark stress this way. eleven_flash_v2_5 and eleven_turbo_v2_5 cost less but misread stress marks: capitals reach them unchanged.",
- "maxLength": 10000,
- "minLength": 1,
- "type": "string"
- },
- "segments": {
- "items": {
- "additionalProperties": false,
- "properties": {
- "duration_seconds": {
- "description": "Required for an image segment; its display duration in seconds. Not accepted for actor or video segments.",
- "exclusiveMinimum": 0,
- "type": "number"
- },
- "image_motion": {
- "additionalProperties": false,
- "properties": {
- "amount": {
- "exclusiveMaximum": 1,
- "minimum": 0,
- "type": "number"
- },
- "direction": {
- "enum": [
- "in",
- "out"
- ],
- "type": "string"
- }
- },
- "required": [
- "direction",
- "amount"
- ],
- "type": "object"
- },
- "kind": {
- "enum": [
- "actor",
- "media"
- ],
- "type": "string"
- },
- "media_type": {
- "description": "Explicit media source type; omission means video, regardless of URL suffix. Availability follows the segments field.",
- "enum": [
- "image",
- "video"
- ],
- "type": "string"
- },
- "media_url": {
- "format": "uri",
- "maxLength": 2048,
- "type": "string"
- },
- "script": {
- "maxLength": 10000,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "kind"
- ],
- "type": "object"
- },
- "maxItems": 5,
- "minItems": 1,
- "type": "array"
- },
- "template_sounds": {
- "anyOf": [
- {
- "const": false,
- "type": "boolean"
- },
- {
- "additionalProperties": false,
- "properties": {
- "answer": {
- "enum": [
- "answer_confirm",
- "answer_open",
- "answer_pop",
- "answer_select",
- "pickup"
- ],
- "type": "string"
- },
- "click": {
- "enum": [
- "click_mouse",
- "click_soft",
- "click_crisp",
- "click_light"
- ],
- "type": "string"
- },
- "edit": {
- "enum": [
- "swell_hit",
- "whoosh_deep",
- "whoosh_low",
- "boom_low",
- "sub_drop",
- "riser_boom",
- "riser_hit"
- ],
- "type": "string"
- },
- "flash": {
- "enum": [
- "shutter",
- "glitch",
- "swish"
- ],
- "type": "string"
- },
- "hangup": {
- "enum": [
- "phone"
- ],
- "type": "string"
- },
- "money": {
- "enum": [
- "cash_register",
- "coins"
- ],
- "type": "string"
- },
- "notify": {
- "enum": [
- "chime",
- "glass_ping",
- "glass_soft",
- "bong",
- "question_ping"
- ],
- "type": "string"
- },
- "pop": {
- "enum": [
- "plop"
- ],
- "type": "string"
- },
- "ring": {
- "enum": [
- "ring_classic",
- "ring_marimba",
- "ring_digital",
- "ring_double"
- ],
- "type": "string"
- },
- "step": {
- "enum": [
- "drop",
- "drop_high",
- "tick",
- "pluck",
- "pluck_bright"
- ],
- "type": "string"
- },
- "toggle": {
- "enum": [
- "switch_flip",
- "toggle_snap",
- "switch_heavy",
- "switch_light"
- ],
- "type": "string"
- },
- "whoosh": {
- "enum": [
- "whoosh",
- "whip",
- "paper_swipe",
- "sweep",
- "slide_quick"
- ],
- "type": "string"
- }
- },
- "type": "object"
- }
- ],
- "description": "Template sounds: false for none, or { beat: name } over the defaults; list_template_sounds names them."
- },
- "template_theme": {
- "additionalProperties": false,
- "description": "The look of every template in the run: a preset and an optional accent; only with templates.",
- "properties": {
- "accent": {
- "description": "#RRGGBB in place of the preset's accent: the pills' fill and the accent text. Refused below 3:1 against the colours it meets.",
- "pattern": "^#[0-9A-Fa-f]{6}$",
- "type": "string"
- },
- "preset": {
- "description": "clean_light (light cards on our blue gradient), bold_dark (dark cards, a yellow accent), neon (black, cyan to blue), paper (warm cream, terracotta) or mono (black and white); omitted is clean_light.",
- "enum": [
- "clean_light",
- "bold_dark",
- "neon",
- "paper",
- "mono"
- ],
- "type": "string"
- }
- },
- "type": "object"
- },
- "templates": {
- "description": "Graphic templates, each { id, kind, anchor, cover_words?, placement?, transition?, data }. On any script run. Templates never change the price: every run is billed by its parts as list_prices states them, and a presenter a template covers is still presenter time. Ids are unique across inserts, overlays, layout_windows and templates. Text is one line of Latin or the script's own letters, digits and common punctuation, with no emoji; a wide CJK glyph counts 2 toward a limit, and long text shrinks to fit the kind's width. size small|medium|large scales a kind; absent is medium. A media field takes { asset_id } of a ready asset of the kind it names. An inner quote names words inside the template's own words, after the one before it: its beat lands on their first word, and must not fall under an insert or full-frame template; a click or step without one is spread evenly. A beat spoken before its template has entered moves just after the enter, with a warning. A template that meets the caption band hides captions while it shows; one elsewhere, such as a small one at the top, leaves them. A full-frame template also hides the presenter, overlays and over-presenter templates while it shows, never meets a wipe or zoom insert, and the covered presenter is billed. At most 2 overlays and over-presenter templates show at once, on footprints that do not overlap. template_theme sets the look of them all. Kinds: tag (over): a short gradient pill over the presenter or an insert; without position it sits in the caption spot and hides captions while it shows; data text ≤ 32, position? top|center|bottom, size? small|medium|large. lower_third (over): a name and role bar low in the frame; captions are hidden while it shows; data name ≤ 28, role? ≤ 36, side left|right, size? small|medium|large. end_card (over): a site pill with an optional call to action in the caption spot; captions are hidden while it shows; data site ≤ 32, cta? ≤ 48, size? small|medium|large. title_card (full): a full-frame hook card: the title (up to two lines) on a white card beside an optional logo image, and an optional chip under it; data title ≤ 48, chip? ≤ 32, logo? {asset_id} image, size? small|medium|large. quote (full): a full-frame quote: marks, the text in up to four lines, then the author with an optional round photo, cut to a circle; data text ≤ 120, author? ≤ 32, photo? {asset_id} image (cut to fill), size? small|medium|large. stat (full|over): a number counting up from 0 to value (up to 2 decimals), with prefix and suffix around it and a label under it; full fills the frame, over sits at chest level on a card; data value number, prefix? ≤ 6, suffix? ≤ 6, label? ≤ 32, size? small|medium|large. callout (over): an arrow or ring that lands on a point of the frame and pulses, target {x,y} in % of the frame from its top left, with an optional label pill below or above it; it may point at the face, its label keeps off the face where it can; also over an insert; data target {x,y}, style arrow|ring, text? ≤ 24, size? small|medium|large. checklist (over): 2–4 rows, each an optional icon, a label and a switch or check box set on or off; a cursor clicks rows in turn (item is the row's index from 0), each click flipping it; below the face; data items 2–4 of {label ≤ 24, on true|false, icon? phone|briefcase|user|clock|chat|star}, clicks? 0–6 of {item number, quote? inner quote}, style? switch|check, size? small|medium|large. phone_call (over): an incoming call on a neutral phone at the side (right unless side left): the caller, a subtitle and a round avatar ring, then the call is answered on answer_at and its timer runs (or a hold banner shows); beside the face in wide frames, under it in tall ones; data caller ≤ 24, subtitle? ≤ 32, avatar? {asset_id} image (cut to fill), answer_at inner quote, side? left|right, size? small|medium|large, banner? ≤ 32, banner_note? ≤ 48, mask_number? true|false. compare (full): a full-frame card showing the before image, then the after image sweeps in on a diagonal on reveal_at and both stay side by side, each with an optional label pill; both images are cut to fill a 3:5 card; data before {asset_id} image (cut to fill), after {asset_id} image (cut to fill), labels? {before? ≤ 20, after? ≤ 20}, reveal_at inner quote, size? small|medium|large. notification (over): a phone notification at the top, above the face: an icon (else the app's initial), the app, a title and a body line; it drops in, holds at least 1.2 s, then leaves before its span ends; data app ≤ 20, title ≤ 32, body ≤ 80, icon? phone|briefcase|user|clock|chat|star, size? small|medium|large. progress (over): 2–5 steps in a column on a card, each completing with a check in turn, on its advance_at quote (one per step, in order) or spread evenly; below the face; data steps 2–5 of ≤ 20, advance_at? 2–5 of inner quote, size? small|medium|large. rating (over): five stars on a card filling in turn up to stars (1–5 in halves, a half star half filled), an optional label under them; at chest level; data stars number, label? ≤ 32, size? small|medium|large.",
- "items": {
- "oneOf": [
- {
- "additionalProperties": false,
- "properties": {
- "anchor": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "endWord": {
- "exclusiveMinimum": 0,
- "maximum": 9007199254740991,
- "type": "integer"
- },
- "startWord": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "startWord",
- "endWord"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "occurrence": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "quote": {
- "maxLength": 10000,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "quote"
- ],
- "type": "object"
- }
- ],
- "description": "The words it starts on, as an insert anchor: { startWord, endWord } or { quote, occurrence? }."
- },
- "cover_words": {
- "description": "How many spoken words it stays on screen, counted from the first word of its anchor. Omitted means the anchored words only.",
- "exclusiveMinimum": 0,
- "maximum": 10000,
- "type": "integer"
- },
- "data": {
- "additionalProperties": false,
- "properties": {
- "position": {
- "enum": [
- "top",
- "center",
- "bottom"
- ],
- "type": "string"
- },
- "size": {
- "enum": [
- "small",
- "medium",
- "large"
- ],
- "type": "string"
- },
- "text": {
- "maxLength": 32,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "text"
- ],
- "type": "object"
- },
- "id": {
- "description": "Unique across inserts, overlays, layout_windows and templates.",
- "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$",
- "type": "string"
- },
- "kind": {
- "const": "tag",
- "type": "string"
- },
- "placement": {
- "description": "over (drawn over the presenter) or full (fills the frame); omitted means the kind's first placement, and a kind takes only the placements its catalog line names.",
- "enum": [
- "over",
- "full"
- ],
- "type": "string"
- },
- "transition": {
- "description": "Full placement only, as an insert's transition.",
- "enum": [
- "cut",
- "wipe",
- "flash",
- "zoom"
- ],
- "type": "string"
- }
- },
- "required": [
- "id",
- "anchor",
- "kind",
- "data"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "anchor": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "endWord": {
- "exclusiveMinimum": 0,
- "maximum": 9007199254740991,
- "type": "integer"
- },
- "startWord": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "startWord",
- "endWord"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "occurrence": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "quote": {
- "maxLength": 10000,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "quote"
- ],
- "type": "object"
- }
- ],
- "description": "The words it starts on, as an insert anchor: { startWord, endWord } or { quote, occurrence? }."
- },
- "cover_words": {
- "description": "How many spoken words it stays on screen, counted from the first word of its anchor. Omitted means the anchored words only.",
- "exclusiveMinimum": 0,
- "maximum": 10000,
- "type": "integer"
- },
- "data": {
- "additionalProperties": false,
- "properties": {
- "name": {
- "maxLength": 28,
- "minLength": 1,
- "type": "string"
- },
- "role": {
- "maxLength": 36,
- "minLength": 1,
- "type": "string"
- },
- "side": {
- "enum": [
- "left",
- "right"
- ],
- "type": "string"
- },
- "size": {
- "enum": [
- "small",
- "medium",
- "large"
- ],
- "type": "string"
- }
- },
- "required": [
- "name",
- "side"
- ],
- "type": "object"
- },
- "id": {
- "description": "Unique across inserts, overlays, layout_windows and templates.",
- "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$",
- "type": "string"
- },
- "kind": {
- "const": "lower_third",
- "type": "string"
- },
- "placement": {
- "description": "over (drawn over the presenter) or full (fills the frame); omitted means the kind's first placement, and a kind takes only the placements its catalog line names.",
- "enum": [
- "over",
- "full"
- ],
- "type": "string"
- },
- "transition": {
- "description": "Full placement only, as an insert's transition.",
- "enum": [
- "cut",
- "wipe",
- "flash",
- "zoom"
- ],
- "type": "string"
- }
- },
- "required": [
- "id",
- "anchor",
- "kind",
- "data"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "anchor": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "endWord": {
- "exclusiveMinimum": 0,
- "maximum": 9007199254740991,
- "type": "integer"
- },
- "startWord": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "startWord",
- "endWord"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "occurrence": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "quote": {
- "maxLength": 10000,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "quote"
- ],
- "type": "object"
- }
- ],
- "description": "The words it starts on, as an insert anchor: { startWord, endWord } or { quote, occurrence? }."
- },
- "cover_words": {
- "description": "How many spoken words it stays on screen, counted from the first word of its anchor. Omitted means the anchored words only.",
- "exclusiveMinimum": 0,
- "maximum": 10000,
- "type": "integer"
- },
- "data": {
- "additionalProperties": false,
- "properties": {
- "cta": {
- "maxLength": 48,
- "minLength": 1,
- "type": "string"
- },
- "site": {
- "maxLength": 32,
- "minLength": 1,
- "type": "string"
- },
- "size": {
- "enum": [
- "small",
- "medium",
- "large"
- ],
- "type": "string"
- }
- },
- "required": [
- "site"
- ],
- "type": "object"
- },
- "id": {
- "description": "Unique across inserts, overlays, layout_windows and templates.",
- "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$",
- "type": "string"
- },
- "kind": {
- "const": "end_card",
- "type": "string"
- },
- "placement": {
- "description": "over (drawn over the presenter) or full (fills the frame); omitted means the kind's first placement, and a kind takes only the placements its catalog line names.",
- "enum": [
- "over",
- "full"
- ],
- "type": "string"
- },
- "transition": {
- "description": "Full placement only, as an insert's transition.",
- "enum": [
- "cut",
- "wipe",
- "flash",
- "zoom"
- ],
- "type": "string"
- }
- },
- "required": [
- "id",
- "anchor",
- "kind",
- "data"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "anchor": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "endWord": {
- "exclusiveMinimum": 0,
- "maximum": 9007199254740991,
- "type": "integer"
- },
- "startWord": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "startWord",
- "endWord"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "occurrence": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "quote": {
- "maxLength": 10000,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "quote"
- ],
- "type": "object"
- }
- ],
- "description": "The words it starts on, as an insert anchor: { startWord, endWord } or { quote, occurrence? }."
- },
- "cover_words": {
- "description": "How many spoken words it stays on screen, counted from the first word of its anchor. Omitted means the anchored words only.",
- "exclusiveMinimum": 0,
- "maximum": 10000,
- "type": "integer"
- },
- "data": {
- "additionalProperties": false,
- "properties": {
- "chip": {
- "maxLength": 32,
- "minLength": 1,
- "type": "string"
- },
- "logo": {
- "additionalProperties": false,
- "properties": {
- "asset_id": {
- "description": "A ready asset from list_assets, of the kind the slot takes.",
- "pattern": "^ast_[a-f0-9]{32}$",
- "type": "string"
- }
- },
- "required": [
- "asset_id"
- ],
- "type": "object"
- },
- "size": {
- "enum": [
- "small",
- "medium",
- "large"
- ],
- "type": "string"
- },
- "title": {
- "maxLength": 48,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "title"
- ],
- "type": "object"
- },
- "id": {
- "description": "Unique across inserts, overlays, layout_windows and templates.",
- "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$",
- "type": "string"
- },
- "kind": {
- "const": "title_card",
- "type": "string"
- },
- "placement": {
- "description": "over (drawn over the presenter) or full (fills the frame); omitted means the kind's first placement, and a kind takes only the placements its catalog line names.",
- "enum": [
- "over",
- "full"
- ],
- "type": "string"
- },
- "transition": {
- "description": "Full placement only, as an insert's transition.",
- "enum": [
- "cut",
- "wipe",
- "flash",
- "zoom"
- ],
- "type": "string"
- }
- },
- "required": [
- "id",
- "anchor",
- "kind",
- "data"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "anchor": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "endWord": {
- "exclusiveMinimum": 0,
- "maximum": 9007199254740991,
- "type": "integer"
- },
- "startWord": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "startWord",
- "endWord"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "occurrence": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "quote": {
- "maxLength": 10000,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "quote"
- ],
- "type": "object"
- }
- ],
- "description": "The words it starts on, as an insert anchor: { startWord, endWord } or { quote, occurrence? }."
- },
- "cover_words": {
- "description": "How many spoken words it stays on screen, counted from the first word of its anchor. Omitted means the anchored words only.",
- "exclusiveMinimum": 0,
- "maximum": 10000,
- "type": "integer"
- },
- "data": {
- "additionalProperties": false,
- "properties": {
- "author": {
- "maxLength": 32,
- "minLength": 1,
- "type": "string"
- },
- "photo": {
- "additionalProperties": false,
- "properties": {
- "asset_id": {
- "description": "A ready asset from list_assets, of the kind the slot takes.",
- "pattern": "^ast_[a-f0-9]{32}$",
- "type": "string"
- }
- },
- "required": [
- "asset_id"
- ],
- "type": "object"
- },
- "size": {
- "enum": [
- "small",
- "medium",
- "large"
- ],
- "type": "string"
- },
- "text": {
- "maxLength": 120,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "text"
- ],
- "type": "object"
- },
- "id": {
- "description": "Unique across inserts, overlays, layout_windows and templates.",
- "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$",
- "type": "string"
- },
- "kind": {
- "const": "quote",
- "type": "string"
- },
- "placement": {
- "description": "over (drawn over the presenter) or full (fills the frame); omitted means the kind's first placement, and a kind takes only the placements its catalog line names.",
- "enum": [
- "over",
- "full"
- ],
- "type": "string"
- },
- "transition": {
- "description": "Full placement only, as an insert's transition.",
- "enum": [
- "cut",
- "wipe",
- "flash",
- "zoom"
- ],
- "type": "string"
- }
- },
- "required": [
- "id",
- "anchor",
- "kind",
- "data"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "anchor": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "endWord": {
- "exclusiveMinimum": 0,
- "maximum": 9007199254740991,
- "type": "integer"
- },
- "startWord": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "startWord",
- "endWord"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "occurrence": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "quote": {
- "maxLength": 10000,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "quote"
- ],
- "type": "object"
- }
- ],
- "description": "The words it starts on, as an insert anchor: { startWord, endWord } or { quote, occurrence? }."
- },
- "cover_words": {
- "description": "How many spoken words it stays on screen, counted from the first word of its anchor. Omitted means the anchored words only.",
- "exclusiveMinimum": 0,
- "maximum": 10000,
- "type": "integer"
- },
- "data": {
- "additionalProperties": false,
- "properties": {
- "label": {
- "maxLength": 32,
- "minLength": 1,
- "type": "string"
- },
- "prefix": {
- "maxLength": 6,
- "minLength": 1,
- "type": "string"
- },
- "size": {
- "enum": [
- "small",
- "medium",
- "large"
- ],
- "type": "string"
- },
- "suffix": {
- "maxLength": 6,
- "minLength": 1,
- "type": "string"
- },
- "value": {
- "maximum": 999999999,
- "minimum": 0,
- "multipleOf": 0.01,
- "type": "number"
- }
- },
- "required": [
- "value"
- ],
- "type": "object"
- },
- "id": {
- "description": "Unique across inserts, overlays, layout_windows and templates.",
- "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$",
- "type": "string"
- },
- "kind": {
- "const": "stat",
- "type": "string"
- },
- "placement": {
- "description": "over (drawn over the presenter) or full (fills the frame); omitted means the kind's first placement, and a kind takes only the placements its catalog line names.",
- "enum": [
- "over",
- "full"
- ],
- "type": "string"
- },
- "transition": {
- "description": "Full placement only, as an insert's transition.",
- "enum": [
- "cut",
- "wipe",
- "flash",
- "zoom"
- ],
- "type": "string"
- }
- },
- "required": [
- "id",
- "anchor",
- "kind",
- "data"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "anchor": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "endWord": {
- "exclusiveMinimum": 0,
- "maximum": 9007199254740991,
- "type": "integer"
- },
- "startWord": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "startWord",
- "endWord"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "occurrence": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "quote": {
- "maxLength": 10000,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "quote"
- ],
- "type": "object"
- }
- ],
- "description": "The words it starts on, as an insert anchor: { startWord, endWord } or { quote, occurrence? }."
- },
- "cover_words": {
- "description": "How many spoken words it stays on screen, counted from the first word of its anchor. Omitted means the anchored words only.",
- "exclusiveMinimum": 0,
- "maximum": 10000,
- "type": "integer"
- },
- "data": {
- "additionalProperties": false,
- "properties": {
- "size": {
- "enum": [
- "small",
- "medium",
- "large"
- ],
- "type": "string"
- },
- "style": {
- "enum": [
- "arrow",
- "ring"
- ],
- "type": "string"
- },
- "target": {
- "additionalProperties": false,
- "properties": {
- "x": {
- "maximum": 100,
- "minimum": 0,
- "type": "number"
- },
- "y": {
- "maximum": 100,
- "minimum": 0,
- "type": "number"
- }
- },
- "required": [
- "x",
- "y"
- ],
- "type": "object"
- },
- "text": {
- "maxLength": 24,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "target",
- "style"
- ],
- "type": "object"
- },
- "id": {
- "description": "Unique across inserts, overlays, layout_windows and templates.",
- "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$",
- "type": "string"
- },
- "kind": {
- "const": "callout",
- "type": "string"
- },
- "placement": {
- "description": "over (drawn over the presenter) or full (fills the frame); omitted means the kind's first placement, and a kind takes only the placements its catalog line names.",
- "enum": [
- "over",
- "full"
- ],
- "type": "string"
- },
- "transition": {
- "description": "Full placement only, as an insert's transition.",
- "enum": [
- "cut",
- "wipe",
- "flash",
- "zoom"
- ],
- "type": "string"
- }
- },
- "required": [
- "id",
- "anchor",
- "kind",
- "data"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "anchor": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "endWord": {
- "exclusiveMinimum": 0,
- "maximum": 9007199254740991,
- "type": "integer"
- },
- "startWord": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "startWord",
- "endWord"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "occurrence": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "quote": {
- "maxLength": 10000,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "quote"
- ],
- "type": "object"
- }
- ],
- "description": "The words it starts on, as an insert anchor: { startWord, endWord } or { quote, occurrence? }."
- },
- "cover_words": {
- "description": "How many spoken words it stays on screen, counted from the first word of its anchor. Omitted means the anchored words only.",
- "exclusiveMinimum": 0,
- "maximum": 10000,
- "type": "integer"
- },
- "data": {
- "additionalProperties": false,
- "properties": {
- "clicks": {
- "items": {
- "additionalProperties": false,
- "properties": {
- "item": {
- "maximum": 3,
- "minimum": 0,
- "type": "integer"
- },
- "quote": {
- "maxLength": 200,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "item"
- ],
- "type": "object"
- },
- "maxItems": 6,
- "type": "array"
- },
- "items": {
- "items": {
- "additionalProperties": false,
- "properties": {
- "icon": {
- "enum": [
- "phone",
- "briefcase",
- "user",
- "clock",
- "chat",
- "star"
- ],
- "type": "string"
- },
- "label": {
- "maxLength": 24,
- "minLength": 1,
- "type": "string"
- },
- "on": {
- "type": "boolean"
- }
- },
- "required": [
- "label",
- "on"
- ],
- "type": "object"
- },
- "maxItems": 4,
- "minItems": 2,
- "type": "array"
- },
- "size": {
- "enum": [
- "small",
- "medium",
- "large"
- ],
- "type": "string"
- },
- "style": {
- "enum": [
- "switch",
- "check"
- ],
- "type": "string"
- }
- },
- "required": [
- "items"
- ],
- "type": "object"
- },
- "id": {
- "description": "Unique across inserts, overlays, layout_windows and templates.",
- "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$",
- "type": "string"
- },
- "kind": {
- "const": "checklist",
- "type": "string"
- },
- "placement": {
- "description": "over (drawn over the presenter) or full (fills the frame); omitted means the kind's first placement, and a kind takes only the placements its catalog line names.",
- "enum": [
- "over",
- "full"
- ],
- "type": "string"
- },
- "transition": {
- "description": "Full placement only, as an insert's transition.",
- "enum": [
- "cut",
- "wipe",
- "flash",
- "zoom"
- ],
- "type": "string"
- }
- },
- "required": [
- "id",
- "anchor",
- "kind",
- "data"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "anchor": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "endWord": {
- "exclusiveMinimum": 0,
- "maximum": 9007199254740991,
- "type": "integer"
- },
- "startWord": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "startWord",
- "endWord"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "occurrence": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "quote": {
- "maxLength": 10000,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "quote"
- ],
- "type": "object"
- }
- ],
- "description": "The words it starts on, as an insert anchor: { startWord, endWord } or { quote, occurrence? }."
- },
- "cover_words": {
- "description": "How many spoken words it stays on screen, counted from the first word of its anchor. Omitted means the anchored words only.",
- "exclusiveMinimum": 0,
- "maximum": 10000,
- "type": "integer"
- },
- "data": {
- "additionalProperties": false,
- "properties": {
- "answer_at": {
- "maxLength": 200,
- "minLength": 1,
- "type": "string"
- },
- "avatar": {
- "additionalProperties": false,
- "properties": {
- "asset_id": {
- "description": "A ready asset from list_assets, of the kind the slot takes.",
- "pattern": "^ast_[a-f0-9]{32}$",
- "type": "string"
- }
- },
- "required": [
- "asset_id"
- ],
- "type": "object"
- },
- "banner": {
- "maxLength": 32,
- "minLength": 1,
- "type": "string"
- },
- "banner_note": {
- "maxLength": 48,
- "minLength": 1,
- "type": "string"
- },
- "caller": {
- "maxLength": 24,
- "minLength": 1,
- "type": "string"
- },
- "mask_number": {
- "type": "boolean"
- },
- "side": {
- "enum": [
- "left",
- "right"
- ],
- "type": "string"
- },
- "size": {
- "enum": [
- "small",
- "medium",
- "large"
- ],
- "type": "string"
- },
- "subtitle": {
- "maxLength": 32,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "caller",
- "answer_at"
- ],
- "type": "object"
- },
- "id": {
- "description": "Unique across inserts, overlays, layout_windows and templates.",
- "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$",
- "type": "string"
- },
- "kind": {
- "const": "phone_call",
- "type": "string"
- },
- "placement": {
- "description": "over (drawn over the presenter) or full (fills the frame); omitted means the kind's first placement, and a kind takes only the placements its catalog line names.",
- "enum": [
- "over",
- "full"
- ],
- "type": "string"
- },
- "transition": {
- "description": "Full placement only, as an insert's transition.",
- "enum": [
- "cut",
- "wipe",
- "flash",
- "zoom"
- ],
- "type": "string"
- }
- },
- "required": [
- "id",
- "anchor",
- "kind",
- "data"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "anchor": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "endWord": {
- "exclusiveMinimum": 0,
- "maximum": 9007199254740991,
- "type": "integer"
- },
- "startWord": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "startWord",
- "endWord"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "occurrence": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "quote": {
- "maxLength": 10000,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "quote"
- ],
- "type": "object"
- }
- ],
- "description": "The words it starts on, as an insert anchor: { startWord, endWord } or { quote, occurrence? }."
- },
- "cover_words": {
- "description": "How many spoken words it stays on screen, counted from the first word of its anchor. Omitted means the anchored words only.",
- "exclusiveMinimum": 0,
- "maximum": 10000,
- "type": "integer"
- },
- "data": {
- "additionalProperties": false,
- "properties": {
- "after": {
- "additionalProperties": false,
- "properties": {
- "asset_id": {
- "description": "A ready asset from list_assets, of the kind the slot takes.",
- "pattern": "^ast_[a-f0-9]{32}$",
- "type": "string"
- }
- },
- "required": [
- "asset_id"
- ],
- "type": "object"
- },
- "before": {
- "additionalProperties": false,
- "properties": {
- "asset_id": {
- "description": "A ready asset from list_assets, of the kind the slot takes.",
- "pattern": "^ast_[a-f0-9]{32}$",
- "type": "string"
- }
- },
- "required": [
- "asset_id"
- ],
- "type": "object"
- },
- "labels": {
- "additionalProperties": false,
- "properties": {
- "after": {
- "maxLength": 20,
- "minLength": 1,
- "type": "string"
- },
- "before": {
- "maxLength": 20,
- "minLength": 1,
- "type": "string"
- }
- },
- "type": "object"
- },
- "reveal_at": {
- "maxLength": 200,
- "minLength": 1,
- "type": "string"
- },
- "size": {
- "enum": [
- "small",
- "medium",
- "large"
- ],
- "type": "string"
- }
- },
- "required": [
- "before",
- "after",
- "reveal_at"
- ],
- "type": "object"
- },
- "id": {
- "description": "Unique across inserts, overlays, layout_windows and templates.",
- "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$",
- "type": "string"
- },
- "kind": {
- "const": "compare",
- "type": "string"
- },
- "placement": {
- "description": "over (drawn over the presenter) or full (fills the frame); omitted means the kind's first placement, and a kind takes only the placements its catalog line names.",
- "enum": [
- "over",
- "full"
- ],
- "type": "string"
- },
- "transition": {
- "description": "Full placement only, as an insert's transition.",
- "enum": [
- "cut",
- "wipe",
- "flash",
- "zoom"
- ],
- "type": "string"
- }
- },
- "required": [
- "id",
- "anchor",
- "kind",
- "data"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "anchor": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "endWord": {
- "exclusiveMinimum": 0,
- "maximum": 9007199254740991,
- "type": "integer"
- },
- "startWord": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "startWord",
- "endWord"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "occurrence": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "quote": {
- "maxLength": 10000,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "quote"
- ],
- "type": "object"
- }
- ],
- "description": "The words it starts on, as an insert anchor: { startWord, endWord } or { quote, occurrence? }."
- },
- "cover_words": {
- "description": "How many spoken words it stays on screen, counted from the first word of its anchor. Omitted means the anchored words only.",
- "exclusiveMinimum": 0,
- "maximum": 10000,
- "type": "integer"
- },
- "data": {
- "additionalProperties": false,
- "properties": {
- "app": {
- "maxLength": 20,
- "minLength": 1,
- "type": "string"
- },
- "body": {
- "maxLength": 80,
- "minLength": 1,
- "type": "string"
- },
- "icon": {
- "enum": [
- "phone",
- "briefcase",
- "user",
- "clock",
- "chat",
- "star"
- ],
- "type": "string"
- },
- "size": {
- "enum": [
- "small",
- "medium",
- "large"
- ],
- "type": "string"
- },
- "title": {
- "maxLength": 32,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "app",
- "title",
- "body"
- ],
- "type": "object"
- },
- "id": {
- "description": "Unique across inserts, overlays, layout_windows and templates.",
- "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$",
- "type": "string"
- },
- "kind": {
- "const": "notification",
- "type": "string"
- },
- "placement": {
- "description": "over (drawn over the presenter) or full (fills the frame); omitted means the kind's first placement, and a kind takes only the placements its catalog line names.",
- "enum": [
- "over",
- "full"
- ],
- "type": "string"
- },
- "transition": {
- "description": "Full placement only, as an insert's transition.",
- "enum": [
- "cut",
- "wipe",
- "flash",
- "zoom"
- ],
- "type": "string"
- }
- },
- "required": [
- "id",
- "anchor",
- "kind",
- "data"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "anchor": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "endWord": {
- "exclusiveMinimum": 0,
- "maximum": 9007199254740991,
- "type": "integer"
- },
- "startWord": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "startWord",
- "endWord"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "occurrence": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "quote": {
- "maxLength": 10000,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "quote"
- ],
- "type": "object"
- }
- ],
- "description": "The words it starts on, as an insert anchor: { startWord, endWord } or { quote, occurrence? }."
- },
- "cover_words": {
- "description": "How many spoken words it stays on screen, counted from the first word of its anchor. Omitted means the anchored words only.",
- "exclusiveMinimum": 0,
- "maximum": 10000,
- "type": "integer"
- },
- "data": {
- "additionalProperties": false,
- "properties": {
- "advance_at": {
- "items": {
- "maxLength": 200,
- "minLength": 1,
- "type": "string"
- },
- "maxItems": 5,
- "minItems": 2,
- "type": "array"
- },
- "size": {
- "enum": [
- "small",
- "medium",
- "large"
- ],
- "type": "string"
- },
- "steps": {
- "items": {
- "maxLength": 20,
- "minLength": 1,
- "type": "string"
- },
- "maxItems": 5,
- "minItems": 2,
- "type": "array"
- }
- },
- "required": [
- "steps"
- ],
- "type": "object"
- },
- "id": {
- "description": "Unique across inserts, overlays, layout_windows and templates.",
- "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$",
- "type": "string"
- },
- "kind": {
- "const": "progress",
- "type": "string"
- },
- "placement": {
- "description": "over (drawn over the presenter) or full (fills the frame); omitted means the kind's first placement, and a kind takes only the placements its catalog line names.",
- "enum": [
- "over",
- "full"
- ],
- "type": "string"
- },
- "transition": {
- "description": "Full placement only, as an insert's transition.",
- "enum": [
- "cut",
- "wipe",
- "flash",
- "zoom"
- ],
- "type": "string"
- }
- },
- "required": [
- "id",
- "anchor",
- "kind",
- "data"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "anchor": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "endWord": {
- "exclusiveMinimum": 0,
- "maximum": 9007199254740991,
- "type": "integer"
- },
- "startWord": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "startWord",
- "endWord"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "occurrence": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "quote": {
- "maxLength": 10000,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "quote"
- ],
- "type": "object"
- }
- ],
- "description": "The words it starts on, as an insert anchor: { startWord, endWord } or { quote, occurrence? }."
- },
- "cover_words": {
- "description": "How many spoken words it stays on screen, counted from the first word of its anchor. Omitted means the anchored words only.",
- "exclusiveMinimum": 0,
- "maximum": 10000,
- "type": "integer"
- },
- "data": {
- "additionalProperties": false,
- "properties": {
- "label": {
- "maxLength": 32,
- "minLength": 1,
- "type": "string"
- },
- "size": {
- "enum": [
- "small",
- "medium",
- "large"
- ],
- "type": "string"
- },
- "stars": {
- "maximum": 5,
- "minimum": 1,
- "multipleOf": 0.5,
- "type": "number"
- }
- },
- "required": [
- "stars"
- ],
- "type": "object"
- },
- "id": {
- "description": "Unique across inserts, overlays, layout_windows and templates.",
- "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$",
- "type": "string"
- },
- "kind": {
- "const": "rating",
- "type": "string"
- },
- "placement": {
- "description": "over (drawn over the presenter) or full (fills the frame); omitted means the kind's first placement, and a kind takes only the placements its catalog line names.",
- "enum": [
- "over",
- "full"
- ],
- "type": "string"
- },
- "transition": {
- "description": "Full placement only, as an insert's transition.",
- "enum": [
- "cut",
- "wipe",
- "flash",
- "zoom"
- ],
- "type": "string"
- }
- },
- "required": [
- "id",
- "anchor",
- "kind",
- "data"
- ],
- "type": "object"
- }
- ]
- },
- "maxItems": 12,
- "minItems": 1,
- "type": "array"
- },
- "tts_model": {
- "description": "Speech model: eleven_v3 | eleven_flash_v2_5 | eleven_turbo_v2_5 | eleven_v4 | gemini-3.8-flash-tts. Omitted means the model of the chosen voice (list_voices shows it): gemini-3.8-flash-tts for its own voices, eleven_v4 for every preset, catalog voice and raw voice_id. An explicit tts_model wins, except eleven_v3: it is no longer spoken, and a run naming it speaks eleven_v4 with a warning. eleven_v4 and gemini-3.8-flash-tts read stress marks (a capital vowel inside a Russian word, \"потОм\", becomes one; see script); eleven_flash_v2_5 and eleven_turbo_v2_5 are cheaper alternatives for languages other than Russian. gemini-3.8-flash-tts speaks only its own voices (list_voices with model=gemini-3.8-flash-tts; without voice, kore for a female actor and charon otherwise) and returns no word timings: a preset or catalog voice, voice_id, captions=true, segments and inserts are refused with it before any charge. Audio tags in square brackets are a convention of the other speech models and are not measured on it. Script limits by speech model: eleven_v3: 5000 characters; eleven_flash_v2_5: 10000 characters; eleven_turbo_v2_5: 10000 characters; eleven_v4: 5000 characters; gemini-3.8-flash-tts: 5000 characters. Count includes spaces, audio tags and stress marks; emoji may count as two characters. Break tags are cut from the text sent to eleven_v4 and gemini-3.8-flash-tts and are not counted there. There is no word-count limit. Duration and price are estimates until measured.",
- "enum": [
- "eleven_v3",
- "eleven_flash_v2_5",
- "eleven_turbo_v2_5",
- "eleven_v4",
- "gemini-3.8-flash-tts"
- ],
- "type": "string"
- },
- "visible_ai_label": {
- "description": "Visible AI label for newly marked presenter videos, including long form; defaults to true in the server admission policy. False hides only the visible label and does not disable invisible marking or signed provenance. Historical outputs are unchanged.",
- "type": "boolean"
- },
- "voice": {
- "description": "Voice name from list_voices. Curated presets: owner_ru_clone | sarah | george | eric | daria_ru_female (owner_ru_clone is the Russian cloned voice). The API refuses a name list_voices does not return, before any charge. Omitted means the default voice for the actor's gender: the gender of actor_id, actor_gender with image, or george for the default actor and for image without actor_gender. gemini-3.8-flash-tts speaks only its own voices (kind model_voice in list_voices, such as kore): naming one selects that model, and a voice is refused with a tts_model that does not speak it, before any charge. Mutually exclusive with voice_id.",
- "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$",
- "type": "string"
- },
- "voice_id": {
- "description": "Raw vendor voice id (16–32 letters and digits) for a voice outside the catalog. Checked lazily: an unknown id fails the run, not the request. Refused with tts_model=gemini-3.8-flash-tts. Mutually exclusive with voice.",
- "pattern": "^[A-Za-z0-9]{16,32}$",
- "type": "string"
- },
- "voice_pace": {
- "description": "Narration speed; 1 is the voice's own. gemini-3.8-flash-tts gets a style hint instead; eleven_v4 has no speed, so pick a voice by list_voices words_per_second; both named in warnings[].",
- "maximum": 1.2,
- "minimum": 0.7,
- "type": "number"
- }
- },
- "type": "object"
- },
- "skill": {
- "const": "make_ugc",
- "type": "string"
- }
- },
- "required": [
- "skill",
- "input"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "input": {
- "oneOf": [
- {
- "additionalProperties": false,
- "properties": {
- "captions": {
- "default": true,
- "type": "boolean"
- },
- "character_details": {
- "maxLength": 400,
- "minLength": 1,
- "type": "string"
- },
- "character_reference": {
- "format": "starts_with",
- "maxLength": 2048,
- "pattern": "^https:\\/\\/.*",
- "type": "string"
- },
- "duration_seconds": {
- "maximum": 90,
- "minimum": 30,
- "type": "number"
- },
- "input_mode": {
- "const": "script",
- "type": "string"
- },
- "scene_images": {
- "items": {
- "additionalProperties": false,
- "properties": {
- "anchor": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "endWord": {
- "exclusiveMinimum": 0,
- "maximum": 9007199254740991,
- "type": "integer"
- },
- "startWord": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "startWord",
- "endWord"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "occurrence": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "quote": {
- "maxLength": 500,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "quote"
- ],
- "type": "object"
- }
- ]
- },
- "image_url": {
- "format": "starts_with",
- "maxLength": 2048,
- "pattern": "^https:\\/\\/.*",
- "type": "string"
- }
- },
- "required": [
- "image_url",
- "anchor"
- ],
- "type": "object"
- },
- "maxItems": 30,
- "type": "array"
- },
- "script": {
- "maxLength": 10000,
- "minLength": 1,
- "type": "string"
- },
- "style_reference": {
- "format": "starts_with",
- "maxLength": 2048,
- "pattern": "^https:\\/\\/.*",
- "type": "string"
- },
- "voice": {
- "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$",
- "type": "string"
- },
- "voice_id": {
- "not": {}
- }
- },
- "required": [
- "duration_seconds",
- "input_mode",
- "script"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "brief": {
- "maxLength": 5000,
- "minLength": 1,
- "type": "string"
- },
- "captions": {
- "default": true,
- "type": "boolean"
- },
- "character_details": {
- "maxLength": 400,
- "minLength": 1,
- "type": "string"
- },
- "character_reference": {
- "format": "starts_with",
- "maxLength": 2048,
- "pattern": "^https:\\/\\/.*",
- "type": "string"
- },
- "duration_seconds": {
- "maximum": 90,
- "minimum": 30,
- "type": "number"
- },
- "input_mode": {
- "const": "brief",
- "type": "string"
- },
- "scene_images": {
- "items": {
- "additionalProperties": false,
- "properties": {
- "anchor": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "endWord": {
- "exclusiveMinimum": 0,
- "maximum": 9007199254740991,
- "type": "integer"
- },
- "startWord": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "startWord",
- "endWord"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "occurrence": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "quote": {
- "maxLength": 500,
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "quote"
- ],
- "type": "object"
- }
- ]
- },
- "image_url": {
- "format": "starts_with",
- "maxLength": 2048,
- "pattern": "^https:\\/\\/.*",
- "type": "string"
- }
- },
- "required": [
- "image_url",
- "anchor"
- ],
- "type": "object"
- },
- "maxItems": 30,
- "type": "array"
- },
- "style_reference": {
- "format": "starts_with",
- "maxLength": 2048,
- "pattern": "^https:\\/\\/.*",
- "type": "string"
- },
- "voice": {
- "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$",
- "type": "string"
- },
- "voice_id": {
- "not": {}
- }
- },
- "required": [
- "duration_seconds",
- "input_mode",
- "brief"
- ],
- "type": "object"
- }
- ]
- },
- "skill": {
- "const": "make_faceless",
- "type": "string"
- }
- },
- "required": [
- "skill",
- "input"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "additionalProperties": false,
+ "properties": {
+ "input": {
+ "additionalProperties": false,
+ "properties": {
+ "actor_gender": {
+ "description": "Gender of the face in image: female | male. Only with image: picks the default voice of that gender (female: sarah, male: george; on gemini-3.8-flash-tts: kore and charon). Refused with actor_id (its gender is known) and without image. An explicit voice or voice_id wins and the response warns that actor_gender changed nothing.",
+ "enum": [
+ "female",
+ "male"
+ ],
+ "type": "string"
+ },
+ "actor_id": {
+ "description": "Saved Clipwright actor ID from list_actors. Choose actor_id, image, or person; do not combine them. Without voice or voice_id the voice follows the actor's gender. Do not combine with actor_gender.",
+ "pattern": "^actor_[a-z0-9][a-z0-9_-]{0,63}$",
+ "type": "string"
+ },
+ "aspect_ratio": {
+ "description": "Output format: 9:16 | 1:1 | 16:9. Omitted means 9:16 without an image; with an image, the supported format nearest the image's shape, even a landscape one — pass it explicitly whenever you pass image. A mismatch above 15% between the request and the source is refused (aspect_conflict) before any charge.",
+ "enum": [
+ "9:16",
+ "1:1",
+ "16:9"
+ ],
+ "type": "string"
+ },
+ "background": {
+ "enum": [
+ "white",
+ "blur",
+ "contain"
+ ],
+ "type": "string"
+ },
+ "broll_policy": {
+ "description": "Saved policy for B-roll: anyone allows people including the actor; no_actor excludes the actor; no_people excludes all people, including hands. Segmented media generation is closed. This setting is stored only and has no effect on actor-only videos. Run override wins over the account actor default; otherwise no_people.",
+ "enum": [
+ "anyone",
+ "no_actor",
+ "no_people"
+ ],
+ "type": "string"
+ },
+ "call": {
+ "additionalProperties": false,
+ "description": "A phone call after a quote: the presenter listens, then freezes while the call plays as a phone line, with a ring first, and an in-call phone beside them shows it (a phone_call template covering the call is used instead). Needs script, a 9:16 frame and words after it. The frozen presenter and the call add production seconds, not presenter seconds, and a live-avatar still shown on the call has its own price in list_prices. Long-form qualification on the server.",
+ "properties": {
+ "after": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "endWord": {
+ "exclusiveMinimum": 0,
+ "maximum": 9007199254740991,
+ "type": "integer"
+ },
+ "startWord": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "startWord",
+ "endWord"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "occurrence": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "quote": {
+ "maxLength": 10000,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "quote"
+ ],
+ "type": "object"
+ }
+ ],
+ "description": "The words the call follows: the presenter stops after the quote's last word and resumes on the next one."
+ },
+ "lines": {
+ "description": "The call's turns in order, from both speakers; at most 1500 characters and about 45 s in all.",
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "speaker": {
+ "enum": [
+ "agent",
+ "caller"
+ ],
+ "type": "string"
+ },
+ "text": {
+ "maxLength": 400,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "speaker",
+ "text"
+ ],
+ "type": "object"
+ },
+ "maxItems": 12,
+ "minItems": 2,
+ "type": "array"
+ },
+ "phone": {
+ "additionalProperties": false,
+ "description": "The in-call phone drawn over the call when no phone_call template covers it; omitted fields are +1 (305) 555-0147 with its digits after the area code masked, \"Hold This Call?\" and \"You'll be notified to pick up.\".",
+ "properties": {
+ "banner": {
+ "maxLength": 32,
+ "minLength": 1,
+ "type": "string"
+ },
+ "banner_note": {
+ "maxLength": 48,
+ "minLength": 1,
+ "type": "string"
+ },
+ "caller": {
+ "maxLength": 24,
+ "minLength": 1,
+ "type": "string"
+ },
+ "mask_number": {
+ "type": "boolean"
+ }
+ },
+ "type": "object"
+ },
+ "stage": {
+ "additionalProperties": false,
+ "description": "Where the in-call phone settles and how it rises, as a reference measured them (plan_reference_remake writes it); omitted is the reference call scene's own place and rise.",
+ "properties": {
+ "enter": {
+ "additionalProperties": false,
+ "properties": {
+ "anchor": {
+ "additionalProperties": false,
+ "description": "When the rise starts: seconds from the call's freeze, negative before it.",
+ "properties": {
+ "id": {
+ "const": "freeze_start#1",
+ "type": "string"
+ },
+ "offset_s": {
+ "maximum": 0,
+ "minimum": -10,
+ "type": "number"
+ }
+ },
+ "required": [
+ "id",
+ "offset_s"
+ ],
+ "type": "object"
+ },
+ "displacement": {
+ "additionalItems": false,
+ "description": "Settled minus first position, in shares of width and height.",
+ "items": [
+ {
+ "maximum": 1,
+ "minimum": -1,
+ "type": "number"
+ },
+ {
+ "maximum": 1,
+ "minimum": -1,
+ "type": "number"
+ }
+ ],
+ "maxItems": 2,
+ "minItems": 2,
+ "type": "array"
+ },
+ "duration_s": {
+ "maximum": 5,
+ "minimum": 0.1,
+ "type": "number"
+ },
+ "from": {
+ "enum": [
+ "bottom",
+ "lower_left",
+ "lower_right"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "from",
+ "displacement",
+ "duration_s",
+ "anchor"
+ ],
+ "type": "object"
+ },
+ "layer": {
+ "enum": [
+ "behind_presenter"
+ ],
+ "type": "string"
+ },
+ "rect": {
+ "additionalProperties": false,
+ "description": "Where the phone settles, in shares of the frame.",
+ "properties": {
+ "height": {
+ "maximum": 1,
+ "minimum": 0,
+ "type": "number"
+ },
+ "left": {
+ "maximum": 1,
+ "minimum": 0,
+ "type": "number"
+ },
+ "top": {
+ "maximum": 1,
+ "minimum": 0,
+ "type": "number"
+ },
+ "width": {
+ "maximum": 1,
+ "minimum": 0,
+ "type": "number"
+ }
+ },
+ "required": [
+ "left",
+ "top",
+ "width",
+ "height"
+ ],
+ "type": "object"
+ },
+ "rect_face": {
+ "additionalProperties": false,
+ "description": "The same place relative to the presenter's face: origin the face centre, unit the face height.",
+ "properties": {
+ "height": {
+ "exclusiveMinimum": 0,
+ "maximum": 20,
+ "type": "number"
+ },
+ "left": {
+ "maximum": 20,
+ "minimum": -20,
+ "type": "number"
+ },
+ "top": {
+ "maximum": 20,
+ "minimum": -20,
+ "type": "number"
+ },
+ "width": {
+ "exclusiveMinimum": 0,
+ "maximum": 20,
+ "type": "number"
+ }
+ },
+ "required": [
+ "left",
+ "top",
+ "width",
+ "height"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "rect"
+ ],
+ "type": "object"
+ },
+ "voices": {
+ "additionalProperties": false,
+ "description": "Voice names from list_voices; omitted means en_female_cassidy for the agent and en_male_mark for the caller.",
+ "properties": {
+ "agent": {
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$",
+ "type": "string"
+ },
+ "caller": {
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$",
+ "type": "string"
+ }
+ },
+ "type": "object"
+ }
+ },
+ "required": [
+ "after",
+ "lines"
+ ],
+ "type": "object"
+ },
+ "caption_emphasis": {
+ "description": "Key words or short phrases to emphasise, each quoted from script and matched as an insert quote is (case and punctuation ignored). An item is the quote, or { quote, look }: look punch shows a small lead-in line from the same sentence over the quote as a large glowing keyword, look pill shows the quote alone in a rounded pill, look color shows it in the accent colour at the same size. Without a look, punch draws punch, hormozi and accent draw color, and other presets draw the quote larger in their highlight colour. Every occurrence is emphasised. Requires captions=true and script; a quote absent from script is refused before any charge.",
+ "items": {
+ "anyOf": [
+ {
+ "maxLength": 40,
+ "minLength": 1,
+ "type": "string"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "look": {
+ "enum": [
+ "punch",
+ "pill",
+ "color"
+ ],
+ "type": "string"
+ },
+ "punch_in": {
+ "description": "Long form only: zoom into the presenter while the quote is spoken. Drawn only where captions are drawn and the presenter is on screen; otherwise warnings[] names it.",
+ "type": "boolean"
+ },
+ "quote": {
+ "maxLength": 40,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "quote"
+ ],
+ "type": "object"
+ }
+ ]
+ },
+ "maxItems": 20,
+ "minItems": 1,
+ "type": "array"
+ },
+ "caption_mode": {
+ "description": "full (default when omitted): every spoken word is captioned. highlights: captions appear only around caption_emphasis quotes (lead-in, quote, short tail) and nowhere else; requires caption_emphasis. In both modes captions are hidden while a full-frame insert is on screen or a template meets their band.",
+ "enum": [
+ "full",
+ "highlights"
+ ],
+ "type": "string"
+ },
+ "caption_position": {
+ "description": "Where captions sit: top, middle, lower or bottom (80% of the height). Omitted means the caption_style's own place. Requires captions=true.",
+ "enum": [
+ "top",
+ "middle",
+ "lower",
+ "bottom"
+ ],
+ "type": "string"
+ },
+ "caption_style": {
+ "default": "hormozi",
+ "description": "Caption look when captions=true. hormozi: the default: heavy white uppercase with a thick black outline, up to three words per cue, one keyword per cue in yellow (emphasised, else the longest non-stop-word). accent: condensed bold white uppercase, no outline, up to three words per cue, one keyword per cue in orange (emphasised, else the longest non-stop-word). tiktok: bold rounded uppercase, one or two words at a time; the spoken word turns yellow and grows. youtube: clean bold sans-serif, five words on a dark rounded box near the bottom; words fade in, the spoken word in red. instagram: comic uppercase with a pink outline, two words at a time; the spoken word pops in orange. minimalist: plain sans-serif, five words on a half-transparent dark band, gentle fade. neon: cyan uppercase with a magenta outline, two words at a time; the spoken word pops in white. genz: large comic uppercase, one word at a time, slamming in with a pink highlight. campfire: rounded comic uppercase, three words; spoken words light up gold and stay lit. midnight: spooky uppercase, two words, slow fade; the spoken word in red. plottwist: heavy sans-serif, three words; the spoken word turns sky blue and grows. headline: tall condensed uppercase on a solid black band, three words; the spoken word scales up in yellow. promo: heavy sans-serif on a blue pill, three words; the spoken word pops in yellow. lecture: readable sans-serif, six words on a dark rounded box; the spoken word in green. highlighter: heavy sans-serif, four words; spoken words turn lime and stay lit. studio: sans-serif, seven words typed in on a blurred dark box; the spoken word in amber. broadcast: outlined sans-serif, eight words low in the frame; the spoken word in pale yellow. arcade: blocky yellow uppercase, two words; the spoken word bounces in white. clutch: brush uppercase, one word at a time, slamming in green. bubblegum: rounded display letters with a pink outline, two words; the spoken word bounces in yellow. crayon: marker handwriting with a navy outline, two words; the spoken word pops in orange. lyrics: handwritten script, five words; spoken words light up pink and stay lit. bassdrop: outlined display uppercase, one word at a time, scaling in orange. punch: mid-frame setup and punch: a small white lead-in line over one or two large blue glowing keywords; other words small and white. Alias: minimal draws minimalist. A font that cannot draw the script's letters is replaced by a plain sans-serif. Previews: https://clipwright.io/captions",
+ "enum": [
+ "hormozi",
+ "accent",
+ "tiktok",
+ "youtube",
+ "instagram",
+ "minimalist",
+ "neon",
+ "genz",
+ "campfire",
+ "midnight",
+ "plottwist",
+ "headline",
+ "promo",
+ "lecture",
+ "highlighter",
+ "studio",
+ "broadcast",
+ "arcade",
+ "clutch",
+ "bubblegum",
+ "crayon",
+ "lyrics",
+ "bassdrop",
+ "punch",
+ "minimal"
+ ],
+ "type": "string"
+ },
+ "captions": {
+ "default": false,
+ "description": "Burn word-timed captions into the video, over the presenter and over inserts. Not available with segments.",
+ "type": "boolean"
+ },
+ "edit_sounds": {
+ "description": "A low sound on every cut (insert, full-frame template, layout window, framing), its peak on the cut. Needs inserts, layout_windows or framing; template_sounds.edit picks it (list_template_sounds). Price unchanged.",
+ "type": "boolean"
+ },
+ "framing": {
+ "description": "Text-anchored presenter sizes: each cuts to close or medium on its words and back to the take where they end. Items may not overlap one another, an insert or a layout window. A framing drawn wholly under full-frame templates is named in warnings[]. Where a punch_in emphasis meets a framing, the framing is drawn. Requires script and long-form qualification on the server; the price does not change.",
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "anchor": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "endWord": {
+ "exclusiveMinimum": 0,
+ "maximum": 9007199254740991,
+ "type": "integer"
+ },
+ "startWord": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "startWord",
+ "endWord"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "occurrence": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "quote": {
+ "maxLength": 10000,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "quote"
+ ],
+ "type": "object"
+ }
+ ],
+ "description": "The words it starts on, as an insert anchor: { startWord, endWord } or { quote, occurrence? }."
+ },
+ "cover_words": {
+ "description": "How many spoken words the size holds, counted from the first word of its anchor. Omitted means the anchored words only.",
+ "exclusiveMinimum": 0,
+ "maximum": 10000,
+ "type": "integer"
+ },
+ "id": {
+ "description": "Unique across inserts, overlays, layout_windows, templates and framing.",
+ "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$",
+ "type": "string"
+ },
+ "size": {
+ "default": "close",
+ "description": "close: the presenter 1.18 times larger about the face; medium: the take as rendered.",
+ "enum": [
+ "close",
+ "medium"
+ ],
+ "type": "string"
+ },
+ "transition": {
+ "default": "cut",
+ "description": "cut: a hard cut to the size; flash: a warm light leak over the cut.",
+ "enum": [
+ "cut",
+ "flash"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "anchor"
+ ],
+ "type": "object"
+ },
+ "maxItems": 20,
+ "minItems": 1,
+ "type": "array"
+ },
+ "image": {
+ "description": "Public https url of the actor's photo (PNG, JPEG or WebP, up to 10 MB). A file on disk goes through upload_image (POST /v1/uploads) first — pass the url it returns. A source we cannot use — private or loopback host, http, unreachable, redirecting, over 10 MB, or not one of those image types — is refused (unusable_source) before any charge. We do not detect the face's gender: pass actor_gender or voice, or the default male voice is used with a warning.",
+ "format": "starts_with",
+ "maxLength": 2048,
+ "pattern": "^https:\\/\\/.*",
+ "type": "string"
+ },
+ "inserts": {
+ "description": "Text-anchored image or video inserts over full narration, each covering cover_words spoken words from its anchor; requires long-form qualification on the server, 1080p and explicit broll_policy=anyone. Captions draw over inserts.",
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "anchor": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "endWord": {
+ "exclusiveMinimum": 0,
+ "maximum": 9007199254740991,
+ "type": "integer"
+ },
+ "startWord": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "startWord",
+ "endWord"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "occurrence": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "quote": {
+ "maxLength": 10000,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "quote"
+ ],
+ "type": "object"
+ }
+ ]
+ },
+ "asset_id": {
+ "description": "A ready PNG or JPEG image or MP4 video from your own assets (list_assets), instead of media_url. Pass exactly one of the two; media_type must match the asset's kind.",
+ "pattern": "^ast_[a-f0-9]{32}$",
+ "type": "string"
+ },
+ "cover_words": {
+ "description": "How many spoken words this insert covers, counted from the first word of its anchor. Omitted means the anchored words only. The insert ends where the first uncovered word begins, so inserts whose coverage meets are adjacent frame for frame and leave no actor shot between them.",
+ "exclusiveMinimum": 0,
+ "maximum": 10000,
+ "type": "integer"
+ },
+ "id": {
+ "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$",
+ "type": "string"
+ },
+ "image_motion": {
+ "additionalProperties": false,
+ "description": "Optional picture zoom. A picture always fills the frame, cut to its shape when the shapes differ (warnings[] names the share cut). amount is the zoom beyond filling: in grows from 1 to 1+amount, out shrinks from 1+amount to 1. No motion by default.",
+ "properties": {
+ "amount": {
+ "exclusiveMaximum": 1,
+ "minimum": 0,
+ "type": "number"
+ },
+ "direction": {
+ "enum": [
+ "in",
+ "out"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "direction",
+ "amount"
+ ],
+ "type": "object"
+ },
+ "media_type": {
+ "description": "image (PNG or JPEG) or video (MP4, H.264 or HEVC, 8-bit SDR). A video plays muted from its first frame and is cut where its words end; one shorter than its words holds its last frame, and warnings[] names it.",
+ "enum": [
+ "image",
+ "video"
+ ],
+ "type": "string"
+ },
+ "media_url": {
+ "description": "Public https URL of the media. Pass exactly one of media_url or asset_id.",
+ "format": "starts_with",
+ "maxLength": 2048,
+ "pattern": "^https:\\/\\/.*",
+ "type": "string"
+ },
+ "transition": {
+ "description": "How the insert comes in and goes out: cut (default), wipe (slides across the presenter), flash (a white flash on the cut) or zoom (eases in from a closer framing). It never moves the insert's start or end.",
+ "enum": [
+ "cut",
+ "wipe",
+ "flash",
+ "zoom"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "media_type",
+ "anchor"
+ ],
+ "type": "object"
+ },
+ "maxItems": 49,
+ "minItems": 1,
+ "type": "array"
+ },
+ "layout_windows": {
+ "description": "Text-anchored reframings of the presenter: split (9:16 only) or card. Windows may not overlap one another or an insert. Same requirements as inserts. A covered or blurred presenter is still delivered vendor work and is billed as face time.",
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "anchor": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "endWord": {
+ "exclusiveMinimum": 0,
+ "maximum": 9007199254740991,
+ "type": "integer"
+ },
+ "startWord": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "startWord",
+ "endWord"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "occurrence": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "quote": {
+ "maxLength": 10000,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "quote"
+ ],
+ "type": "object"
+ }
+ ],
+ "description": "The words it starts on, as an insert anchor: { startWord, endWord } or { quote, occurrence? }."
+ },
+ "asset_id": {
+ "description": "A ready PNG or JPEG image or MP4 video from your own assets (list_assets), instead of media_url. Pass exactly one of the two; media_type must match the asset's kind.",
+ "pattern": "^ast_[a-f0-9]{32}$",
+ "type": "string"
+ },
+ "blur_presenter": {
+ "description": "Card only: blur the presenter behind the card.",
+ "type": "boolean"
+ },
+ "cover_words": {
+ "description": "How many spoken words it stays on screen, counted from the first word of its anchor. Omitted means the anchored words only.",
+ "exclusiveMinimum": 0,
+ "maximum": 10000,
+ "type": "integer"
+ },
+ "enter": {
+ "description": "How it appears: cut (default), fade, slide (in from the nearest edge) or tilt_in. It leaves with a cut.",
+ "enum": [
+ "cut",
+ "fade",
+ "slide",
+ "tilt_in"
+ ],
+ "type": "string"
+ },
+ "id": {
+ "description": "Unique across inserts, overlays and layout_windows.",
+ "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$",
+ "type": "string"
+ },
+ "layout": {
+ "description": "split: presenter in the top half, media in the bottom half, captions on the seam (9:16 only). card: the media in a centred card over the presenter.",
+ "enum": [
+ "split",
+ "card"
+ ],
+ "type": "string"
+ },
+ "media_type": {
+ "description": "image (PNG or JPEG) or video (MP4, H.264 or HEVC, 8-bit SDR). A video plays muted from its first frame and is cut where its words end; one shorter than its words holds its last frame, and warnings[] names it.",
+ "enum": [
+ "image",
+ "video"
+ ],
+ "type": "string"
+ },
+ "media_url": {
+ "description": "Public https URL of the media. Pass exactly one of media_url or asset_id.",
+ "format": "starts_with",
+ "maxLength": 2048,
+ "pattern": "^https:\\/\\/.*",
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "media_type",
+ "anchor",
+ "layout"
+ ],
+ "type": "object"
+ },
+ "maxItems": 5,
+ "minItems": 1,
+ "type": "array"
+ },
+ "look": {
+ "default": "natural",
+ "enum": [
+ "natural",
+ "commercial",
+ "raw_iphone"
+ ],
+ "type": "string"
+ },
+ "name": {
+ "maxLength": 100,
+ "type": "string"
+ },
+ "overlays": {
+ "description": "Text-anchored images or videos over the visible presenter, in a corner or a band at the top or bottom. At most 2 on screen at once, and two on screen together need positions that do not share a corner. Captions move to the middle or bottom third when an overlay meets them, never up over the face, and hide while neither is free. An overlay is not drawn while a full-frame insert is on screen. Same requirements as inserts: script, long-form qualification on the server, 1080p and explicit broll_policy=anyone. The presenter stays on screen, so the price does not change.",
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "anchor": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "endWord": {
+ "exclusiveMinimum": 0,
+ "maximum": 9007199254740991,
+ "type": "integer"
+ },
+ "startWord": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "startWord",
+ "endWord"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "occurrence": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "quote": {
+ "maxLength": 10000,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "quote"
+ ],
+ "type": "object"
+ }
+ ],
+ "description": "The words it starts on, as an insert anchor: { startWord, endWord } or { quote, occurrence? }."
+ },
+ "asset_id": {
+ "description": "A ready PNG or JPEG image or MP4 video from your own assets (list_assets), instead of media_url. Pass exactly one of the two; media_type must match the asset's kind.",
+ "pattern": "^ast_[a-f0-9]{32}$",
+ "type": "string"
+ },
+ "cover_words": {
+ "description": "How many spoken words it stays on screen, counted from the first word of its anchor. Omitted means the anchored words only.",
+ "exclusiveMinimum": 0,
+ "maximum": 10000,
+ "type": "integer"
+ },
+ "enter": {
+ "description": "How it appears: cut (default), fade, slide (in from the nearest edge) or tilt_in. It leaves with a cut.",
+ "enum": [
+ "cut",
+ "fade",
+ "slide",
+ "tilt_in"
+ ],
+ "type": "string"
+ },
+ "id": {
+ "description": "Unique across inserts, overlays and layout_windows.",
+ "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$",
+ "type": "string"
+ },
+ "media_type": {
+ "description": "image (PNG or JPEG) or video (MP4, H.264 or HEVC, 8-bit SDR). A video plays muted from its first frame and is cut where its words end; one shorter than its words holds its last frame, and warnings[] names it.",
+ "enum": [
+ "image",
+ "video"
+ ],
+ "type": "string"
+ },
+ "media_url": {
+ "description": "Public https URL of the media. Pass exactly one of media_url or asset_id.",
+ "format": "starts_with",
+ "maxLength": 2048,
+ "pattern": "^https:\\/\\/.*",
+ "type": "string"
+ },
+ "position": {
+ "description": "A corner (top_left, top_right, bottom_left, bottom_right), or a band across the top or bottom.",
+ "enum": [
+ "top_left",
+ "top_right",
+ "bottom_left",
+ "bottom_right",
+ "top",
+ "bottom"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "media_type",
+ "anchor",
+ "position"
+ ],
+ "type": "object"
+ },
+ "maxItems": 10,
+ "minItems": 1,
+ "type": "array"
+ },
+ "pause_trim": {
+ "additionalProperties": false,
+ "description": "Shorten narration pauses longer than these seconds, cutting silence only.",
+ "properties": {
+ "comma_s": {
+ "maximum": 2,
+ "minimum": 0.05,
+ "type": "number"
+ },
+ "mid_phrase_s": {
+ "maximum": 2,
+ "minimum": 0.05,
+ "type": "number"
+ },
+ "sentence_end_s": {
+ "maximum": 2,
+ "minimum": 0.05,
+ "type": "number"
+ }
+ },
+ "type": "object"
+ },
+ "person": {
+ "maxLength": 500,
+ "minLength": 1,
+ "type": "string"
+ },
+ "presenter_framing": {
+ "description": "close (default) or wide: presenter lower, room above. Needs the actor's wide view (list_actors), 9:16 only; else close plus warnings[].",
+ "enum": [
+ "close",
+ "wide"
+ ],
+ "type": "string"
+ },
+ "presenter_mic": {
+ "description": "true: presenter holds a tiny mic. Needs the actor's mic view in that framing (list_actors; library ones are wide); else no mic plus warnings[].",
+ "type": "boolean"
+ },
+ "resolution": {
+ "description": "Output resolution: 720p | 1080p | 4k (short side 720 / 1080 / 2160 px). Omitted means 1080p.",
+ "enum": [
+ "720p",
+ "1080p",
+ "4k"
+ ],
+ "type": "string"
+ },
+ "script": {
+ "description": "The words the actor says; required unless segments supplies the spoken text. Segments and text-anchored inserts require long-form qualification on the server. Script limits by speech model: eleven_v3: 5000 characters; eleven_flash_v2_5: 10000 characters; eleven_turbo_v2_5: 10000 characters; eleven_v4: 5000 characters; gemini-3.8-flash-tts: 5000 characters. Count includes spaces, audio tags and stress marks; emoji may count as two characters. Break tags are cut from the text sent to eleven_v4 and gemini-3.8-flash-tts and are not counted there. There is no word-count limit. Duration and price are estimates until measured. Russian stress: write the stressed vowel as a capital inside a lowercase word (\"потОм\", \"зАмок\") and eleven_v4 and gemini-3.8-flash-tts receive it as the stress mark U+0301 (\"пото́м\"); a mark typed directly is kept. A capital at the start of a word stays a capital, and a word with a second capital or a capital consonant inside (all caps, \"ВУЗы\") is left as it is. A single capital vowel inside a word is always read as stress, so write \"Яндекс Еда\", not \"ЯндексЕда\". Tell users writing in Russian that they can mark stress this way. eleven_flash_v2_5 and eleven_turbo_v2_5 cost less but misread stress marks: capitals reach them unchanged.",
+ "maxLength": 10000,
+ "minLength": 1,
+ "type": "string"
+ },
+ "segments": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "duration_seconds": {
+ "description": "Required for an image segment; its display duration in seconds. Not accepted for actor or video segments.",
+ "exclusiveMinimum": 0,
+ "type": "number"
+ },
+ "image_motion": {
+ "additionalProperties": false,
+ "properties": {
+ "amount": {
+ "exclusiveMaximum": 1,
+ "minimum": 0,
+ "type": "number"
+ },
+ "direction": {
+ "enum": [
+ "in",
+ "out"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "direction",
+ "amount"
+ ],
+ "type": "object"
+ },
+ "kind": {
+ "enum": [
+ "actor",
+ "media"
+ ],
+ "type": "string"
+ },
+ "media_type": {
+ "description": "Explicit media source type; omission means video, regardless of URL suffix. Availability follows the segments field.",
+ "enum": [
+ "image",
+ "video"
+ ],
+ "type": "string"
+ },
+ "media_url": {
+ "format": "uri",
+ "maxLength": 2048,
+ "type": "string"
+ },
+ "script": {
+ "maxLength": 10000,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "kind"
+ ],
+ "type": "object"
+ },
+ "maxItems": 5,
+ "minItems": 1,
+ "type": "array"
+ },
+ "template_sounds": {
+ "anyOf": [
+ {
+ "const": false,
+ "type": "boolean"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "answer": {
+ "enum": [
+ "answer_confirm",
+ "answer_open",
+ "answer_pop",
+ "answer_select",
+ "pickup"
+ ],
+ "type": "string"
+ },
+ "click": {
+ "enum": [
+ "click_mouse",
+ "click_soft",
+ "click_crisp",
+ "click_light"
+ ],
+ "type": "string"
+ },
+ "edit": {
+ "enum": [
+ "swell_hit",
+ "whoosh_deep",
+ "whoosh_low",
+ "boom_low",
+ "sub_drop",
+ "riser_boom",
+ "riser_hit"
+ ],
+ "type": "string"
+ },
+ "flash": {
+ "enum": [
+ "shutter",
+ "glitch",
+ "swish"
+ ],
+ "type": "string"
+ },
+ "hangup": {
+ "enum": [
+ "phone"
+ ],
+ "type": "string"
+ },
+ "money": {
+ "enum": [
+ "cash_register",
+ "coins"
+ ],
+ "type": "string"
+ },
+ "notify": {
+ "enum": [
+ "chime",
+ "glass_ping",
+ "glass_soft",
+ "bong",
+ "question_ping"
+ ],
+ "type": "string"
+ },
+ "pop": {
+ "enum": [
+ "plop"
+ ],
+ "type": "string"
+ },
+ "ring": {
+ "enum": [
+ "ring_classic",
+ "ring_marimba",
+ "ring_digital",
+ "ring_double"
+ ],
+ "type": "string"
+ },
+ "step": {
+ "enum": [
+ "drop",
+ "drop_high",
+ "tick",
+ "pluck",
+ "pluck_bright"
+ ],
+ "type": "string"
+ },
+ "toggle": {
+ "enum": [
+ "switch_flip",
+ "toggle_snap",
+ "switch_heavy",
+ "switch_light"
+ ],
+ "type": "string"
+ },
+ "whoosh": {
+ "enum": [
+ "whoosh",
+ "whip",
+ "paper_swipe",
+ "sweep",
+ "slide_quick"
+ ],
+ "type": "string"
+ }
+ },
+ "type": "object"
+ }
+ ],
+ "description": "Template sounds: false for none, or { beat: name } over the defaults; list_template_sounds names them."
+ },
+ "template_theme": {
+ "additionalProperties": false,
+ "description": "The look of every template in the run: a preset and an optional accent; only with templates.",
+ "properties": {
+ "accent": {
+ "description": "#RRGGBB in place of the preset's accent: the pills' fill and the accent text. Refused below 3:1 against the colours it meets.",
+ "pattern": "^#[0-9A-Fa-f]{6}$",
+ "type": "string"
+ },
+ "preset": {
+ "description": "clean_light (light cards on our blue gradient), bold_dark (dark cards, a yellow accent), neon (black, cyan to blue), paper (warm cream, terracotta) or mono (black and white); omitted is clean_light.",
+ "enum": [
+ "clean_light",
+ "bold_dark",
+ "neon",
+ "paper",
+ "mono"
+ ],
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "templates": {
+ "description": "Graphic templates, each { id, kind, anchor, cover_words?, placement?, transition?, data }. On any script run. Templates never change the price: every run is billed by its parts as list_prices states them, and a presenter a template covers is still presenter time. Ids are unique across inserts, overlays, layout_windows and templates. Text is one line of Latin or the script's own letters, digits and common punctuation, with no emoji; a wide CJK glyph counts 2 toward a limit, and long text shrinks to fit the kind's width. size small|medium|large scales a kind; absent is medium. A media field takes { asset_id } of a ready asset of the kind it names. An inner quote names words inside the template's own words, after the one before it: its beat lands on their first word, and must not fall under an insert or full-frame template; a click or step without one is spread evenly. A beat spoken before its template has entered moves just after the enter, with a warning. A template that meets the caption band hides captions while it shows; one elsewhere, such as a small one at the top, leaves them. A full-frame template also hides the presenter, overlays and over-presenter templates while it shows, never meets a wipe or zoom insert, and the covered presenter is billed. At most 2 overlays and over-presenter templates show at once, on footprints that do not overlap. template_theme sets the look of them all. Kinds: tag (over): a short gradient pill over the presenter or an insert; without position it sits in the caption spot and hides captions while it shows; data text ≤ 32, position? top|center|bottom, size? small|medium|large. lower_third (over): a name and role bar low in the frame; captions are hidden while it shows; data name ≤ 28, role? ≤ 36, side left|right, size? small|medium|large. end_card (over): a site pill with an optional call to action in the caption spot; captions are hidden while it shows; data site ≤ 32, cta? ≤ 48, size? small|medium|large. title_card (full): a full-frame hook card: the title (up to two lines) on a white card beside an optional logo image, and an optional chip under it; data title ≤ 48, chip? ≤ 32, logo? {asset_id} image, size? small|medium|large. quote (full): a full-frame quote: marks, the text in up to four lines, then the author with an optional round photo, cut to a circle; data text ≤ 120, author? ≤ 32, photo? {asset_id} image (cut to fill), size? small|medium|large. stat (full|over): a number counting up from 0 to value (up to 2 decimals), with prefix and suffix around it and a label under it; full fills the frame, over sits at chest level on a card; data value number, prefix? ≤ 6, suffix? ≤ 6, label? ≤ 32, size? small|medium|large. callout (over): an arrow or ring that lands on a point of the frame and pulses, target {x,y} in % of the frame from its top left, with an optional label pill below or above it; it may point at the face, its label keeps off the face where it can; also over an insert; data target {x,y}, style arrow|ring, text? ≤ 24, size? small|medium|large. checklist (over): 2–4 rows, each an optional icon, a label and a switch or check box set on or off; a cursor clicks rows in turn (item is the row's index from 0), each click flipping it; below the face; data items 2–4 of {label ≤ 24, on true|false, icon? phone|briefcase|user|clock|chat|star}, clicks? 0–6 of {item number, quote? inner quote}, style? switch|check, size? small|medium|large. phone_call (over): an incoming call on a neutral phone at the side (right unless side left): the caller, a subtitle and a round avatar ring, then the call is answered on answer_at and its timer runs (or a hold banner shows); beside the face in wide frames, under it in tall ones; data caller ≤ 24, subtitle? ≤ 32, avatar? {asset_id} image (cut to fill), answer_at inner quote, side? left|right, size? small|medium|large, banner? ≤ 32, banner_note? ≤ 48, mask_number? true|false. compare (full): a full-frame card showing the before image, then the after image sweeps in on a diagonal on reveal_at and both stay side by side, each with an optional label pill; both images are cut to fill a 3:5 card; data before {asset_id} image (cut to fill), after {asset_id} image (cut to fill), labels? {before? ≤ 20, after? ≤ 20}, reveal_at inner quote, size? small|medium|large. notification (over): a phone notification at the top, above the face: an icon (else the app's initial), the app, a title and a body line; it drops in, holds at least 1.2 s, then leaves before its span ends; data app ≤ 20, title ≤ 32, body ≤ 80, icon? phone|briefcase|user|clock|chat|star, size? small|medium|large. progress (over): 2–5 steps in a column on a card, each completing with a check in turn, on its advance_at quote (one per step, in order) or spread evenly; below the face; data steps 2–5 of ≤ 20, advance_at? 2–5 of inner quote, size? small|medium|large. rating (over): five stars on a card filling in turn up to stars (1–5 in halves, a half star half filled), an optional label under them; at chest level; data stars number, label? ≤ 32, size? small|medium|large.",
+ "items": {
+ "oneOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "anchor": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "endWord": {
+ "exclusiveMinimum": 0,
+ "maximum": 9007199254740991,
+ "type": "integer"
+ },
+ "startWord": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "startWord",
+ "endWord"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "occurrence": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "quote": {
+ "maxLength": 10000,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "quote"
+ ],
+ "type": "object"
+ }
+ ],
+ "description": "The words it starts on, as an insert anchor: { startWord, endWord } or { quote, occurrence? }."
+ },
+ "cover_words": {
+ "description": "How many spoken words it stays on screen, counted from the first word of its anchor. Omitted means the anchored words only.",
+ "exclusiveMinimum": 0,
+ "maximum": 10000,
+ "type": "integer"
+ },
+ "data": {
+ "additionalProperties": false,
+ "properties": {
+ "position": {
+ "enum": [
+ "top",
+ "center",
+ "bottom"
+ ],
+ "type": "string"
+ },
+ "size": {
+ "enum": [
+ "small",
+ "medium",
+ "large"
+ ],
+ "type": "string"
+ },
+ "text": {
+ "maxLength": 32,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "text"
+ ],
+ "type": "object"
+ },
+ "id": {
+ "description": "Unique across inserts, overlays, layout_windows and templates.",
+ "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$",
+ "type": "string"
+ },
+ "kind": {
+ "const": "tag",
+ "type": "string"
+ },
+ "placement": {
+ "description": "over (drawn over the presenter) or full (fills the frame); omitted means the kind's first placement, and a kind takes only the placements its catalog line names.",
+ "enum": [
+ "over",
+ "full"
+ ],
+ "type": "string"
+ },
+ "transition": {
+ "description": "Full placement only, as an insert's transition.",
+ "enum": [
+ "cut",
+ "wipe",
+ "flash",
+ "zoom"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "anchor",
+ "kind",
+ "data"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "anchor": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "endWord": {
+ "exclusiveMinimum": 0,
+ "maximum": 9007199254740991,
+ "type": "integer"
+ },
+ "startWord": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "startWord",
+ "endWord"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "occurrence": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "quote": {
+ "maxLength": 10000,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "quote"
+ ],
+ "type": "object"
+ }
+ ],
+ "description": "The words it starts on, as an insert anchor: { startWord, endWord } or { quote, occurrence? }."
+ },
+ "cover_words": {
+ "description": "How many spoken words it stays on screen, counted from the first word of its anchor. Omitted means the anchored words only.",
+ "exclusiveMinimum": 0,
+ "maximum": 10000,
+ "type": "integer"
+ },
+ "data": {
+ "additionalProperties": false,
+ "properties": {
+ "name": {
+ "maxLength": 28,
+ "minLength": 1,
+ "type": "string"
+ },
+ "role": {
+ "maxLength": 36,
+ "minLength": 1,
+ "type": "string"
+ },
+ "side": {
+ "enum": [
+ "left",
+ "right"
+ ],
+ "type": "string"
+ },
+ "size": {
+ "enum": [
+ "small",
+ "medium",
+ "large"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "side"
+ ],
+ "type": "object"
+ },
+ "id": {
+ "description": "Unique across inserts, overlays, layout_windows and templates.",
+ "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$",
+ "type": "string"
+ },
+ "kind": {
+ "const": "lower_third",
+ "type": "string"
+ },
+ "placement": {
+ "description": "over (drawn over the presenter) or full (fills the frame); omitted means the kind's first placement, and a kind takes only the placements its catalog line names.",
+ "enum": [
+ "over",
+ "full"
+ ],
+ "type": "string"
+ },
+ "transition": {
+ "description": "Full placement only, as an insert's transition.",
+ "enum": [
+ "cut",
+ "wipe",
+ "flash",
+ "zoom"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "anchor",
+ "kind",
+ "data"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "anchor": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "endWord": {
+ "exclusiveMinimum": 0,
+ "maximum": 9007199254740991,
+ "type": "integer"
+ },
+ "startWord": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "startWord",
+ "endWord"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "occurrence": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "quote": {
+ "maxLength": 10000,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "quote"
+ ],
+ "type": "object"
+ }
+ ],
+ "description": "The words it starts on, as an insert anchor: { startWord, endWord } or { quote, occurrence? }."
+ },
+ "cover_words": {
+ "description": "How many spoken words it stays on screen, counted from the first word of its anchor. Omitted means the anchored words only.",
+ "exclusiveMinimum": 0,
+ "maximum": 10000,
+ "type": "integer"
+ },
+ "data": {
+ "additionalProperties": false,
+ "properties": {
+ "cta": {
+ "maxLength": 48,
+ "minLength": 1,
+ "type": "string"
+ },
+ "site": {
+ "maxLength": 32,
+ "minLength": 1,
+ "type": "string"
+ },
+ "size": {
+ "enum": [
+ "small",
+ "medium",
+ "large"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "site"
+ ],
+ "type": "object"
+ },
+ "id": {
+ "description": "Unique across inserts, overlays, layout_windows and templates.",
+ "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$",
+ "type": "string"
+ },
+ "kind": {
+ "const": "end_card",
+ "type": "string"
+ },
+ "placement": {
+ "description": "over (drawn over the presenter) or full (fills the frame); omitted means the kind's first placement, and a kind takes only the placements its catalog line names.",
+ "enum": [
+ "over",
+ "full"
+ ],
+ "type": "string"
+ },
+ "transition": {
+ "description": "Full placement only, as an insert's transition.",
+ "enum": [
+ "cut",
+ "wipe",
+ "flash",
+ "zoom"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "anchor",
+ "kind",
+ "data"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "anchor": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "endWord": {
+ "exclusiveMinimum": 0,
+ "maximum": 9007199254740991,
+ "type": "integer"
+ },
+ "startWord": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "startWord",
+ "endWord"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "occurrence": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "quote": {
+ "maxLength": 10000,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "quote"
+ ],
+ "type": "object"
+ }
+ ],
+ "description": "The words it starts on, as an insert anchor: { startWord, endWord } or { quote, occurrence? }."
+ },
+ "cover_words": {
+ "description": "How many spoken words it stays on screen, counted from the first word of its anchor. Omitted means the anchored words only.",
+ "exclusiveMinimum": 0,
+ "maximum": 10000,
+ "type": "integer"
+ },
+ "data": {
+ "additionalProperties": false,
+ "properties": {
+ "chip": {
+ "maxLength": 32,
+ "minLength": 1,
+ "type": "string"
+ },
+ "logo": {
+ "additionalProperties": false,
+ "properties": {
+ "asset_id": {
+ "description": "A ready asset from list_assets, of the kind the slot takes.",
+ "pattern": "^ast_[a-f0-9]{32}$",
+ "type": "string"
+ }
+ },
+ "required": [
+ "asset_id"
+ ],
+ "type": "object"
+ },
+ "size": {
+ "enum": [
+ "small",
+ "medium",
+ "large"
+ ],
+ "type": "string"
+ },
+ "title": {
+ "maxLength": 48,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "title"
+ ],
+ "type": "object"
+ },
+ "id": {
+ "description": "Unique across inserts, overlays, layout_windows and templates.",
+ "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$",
+ "type": "string"
+ },
+ "kind": {
+ "const": "title_card",
+ "type": "string"
+ },
+ "placement": {
+ "description": "over (drawn over the presenter) or full (fills the frame); omitted means the kind's first placement, and a kind takes only the placements its catalog line names.",
+ "enum": [
+ "over",
+ "full"
+ ],
+ "type": "string"
+ },
+ "transition": {
+ "description": "Full placement only, as an insert's transition.",
+ "enum": [
+ "cut",
+ "wipe",
+ "flash",
+ "zoom"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "anchor",
+ "kind",
+ "data"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "anchor": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "endWord": {
+ "exclusiveMinimum": 0,
+ "maximum": 9007199254740991,
+ "type": "integer"
+ },
+ "startWord": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "startWord",
+ "endWord"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "occurrence": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "quote": {
+ "maxLength": 10000,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "quote"
+ ],
+ "type": "object"
+ }
+ ],
+ "description": "The words it starts on, as an insert anchor: { startWord, endWord } or { quote, occurrence? }."
+ },
+ "cover_words": {
+ "description": "How many spoken words it stays on screen, counted from the first word of its anchor. Omitted means the anchored words only.",
+ "exclusiveMinimum": 0,
+ "maximum": 10000,
+ "type": "integer"
+ },
+ "data": {
+ "additionalProperties": false,
+ "properties": {
+ "author": {
+ "maxLength": 32,
+ "minLength": 1,
+ "type": "string"
+ },
+ "photo": {
+ "additionalProperties": false,
+ "properties": {
+ "asset_id": {
+ "description": "A ready asset from list_assets, of the kind the slot takes.",
+ "pattern": "^ast_[a-f0-9]{32}$",
+ "type": "string"
+ }
+ },
+ "required": [
+ "asset_id"
+ ],
+ "type": "object"
+ },
+ "size": {
+ "enum": [
+ "small",
+ "medium",
+ "large"
+ ],
+ "type": "string"
+ },
+ "text": {
+ "maxLength": 120,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "text"
+ ],
+ "type": "object"
+ },
+ "id": {
+ "description": "Unique across inserts, overlays, layout_windows and templates.",
+ "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$",
+ "type": "string"
+ },
+ "kind": {
+ "const": "quote",
+ "type": "string"
+ },
+ "placement": {
+ "description": "over (drawn over the presenter) or full (fills the frame); omitted means the kind's first placement, and a kind takes only the placements its catalog line names.",
+ "enum": [
+ "over",
+ "full"
+ ],
+ "type": "string"
+ },
+ "transition": {
+ "description": "Full placement only, as an insert's transition.",
+ "enum": [
+ "cut",
+ "wipe",
+ "flash",
+ "zoom"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "anchor",
+ "kind",
+ "data"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "anchor": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "endWord": {
+ "exclusiveMinimum": 0,
+ "maximum": 9007199254740991,
+ "type": "integer"
+ },
+ "startWord": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "startWord",
+ "endWord"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "occurrence": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "quote": {
+ "maxLength": 10000,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "quote"
+ ],
+ "type": "object"
+ }
+ ],
+ "description": "The words it starts on, as an insert anchor: { startWord, endWord } or { quote, occurrence? }."
+ },
+ "cover_words": {
+ "description": "How many spoken words it stays on screen, counted from the first word of its anchor. Omitted means the anchored words only.",
+ "exclusiveMinimum": 0,
+ "maximum": 10000,
+ "type": "integer"
+ },
+ "data": {
+ "additionalProperties": false,
+ "properties": {
+ "label": {
+ "maxLength": 32,
+ "minLength": 1,
+ "type": "string"
+ },
+ "prefix": {
+ "maxLength": 6,
+ "minLength": 1,
+ "type": "string"
+ },
+ "size": {
+ "enum": [
+ "small",
+ "medium",
+ "large"
+ ],
+ "type": "string"
+ },
+ "suffix": {
+ "maxLength": 6,
+ "minLength": 1,
+ "type": "string"
+ },
+ "value": {
+ "maximum": 999999999,
+ "minimum": 0,
+ "multipleOf": 0.01,
+ "type": "number"
+ }
+ },
+ "required": [
+ "value"
+ ],
+ "type": "object"
+ },
+ "id": {
+ "description": "Unique across inserts, overlays, layout_windows and templates.",
+ "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$",
+ "type": "string"
+ },
+ "kind": {
+ "const": "stat",
+ "type": "string"
+ },
+ "placement": {
+ "description": "over (drawn over the presenter) or full (fills the frame); omitted means the kind's first placement, and a kind takes only the placements its catalog line names.",
+ "enum": [
+ "over",
+ "full"
+ ],
+ "type": "string"
+ },
+ "transition": {
+ "description": "Full placement only, as an insert's transition.",
+ "enum": [
+ "cut",
+ "wipe",
+ "flash",
+ "zoom"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "anchor",
+ "kind",
+ "data"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "anchor": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "endWord": {
+ "exclusiveMinimum": 0,
+ "maximum": 9007199254740991,
+ "type": "integer"
+ },
+ "startWord": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "startWord",
+ "endWord"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "occurrence": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "quote": {
+ "maxLength": 10000,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "quote"
+ ],
+ "type": "object"
+ }
+ ],
+ "description": "The words it starts on, as an insert anchor: { startWord, endWord } or { quote, occurrence? }."
+ },
+ "cover_words": {
+ "description": "How many spoken words it stays on screen, counted from the first word of its anchor. Omitted means the anchored words only.",
+ "exclusiveMinimum": 0,
+ "maximum": 10000,
+ "type": "integer"
+ },
+ "data": {
+ "additionalProperties": false,
+ "properties": {
+ "size": {
+ "enum": [
+ "small",
+ "medium",
+ "large"
+ ],
+ "type": "string"
+ },
+ "style": {
+ "enum": [
+ "arrow",
+ "ring"
+ ],
+ "type": "string"
+ },
+ "target": {
+ "additionalProperties": false,
+ "properties": {
+ "x": {
+ "maximum": 100,
+ "minimum": 0,
+ "type": "number"
+ },
+ "y": {
+ "maximum": 100,
+ "minimum": 0,
+ "type": "number"
+ }
+ },
+ "required": [
+ "x",
+ "y"
+ ],
+ "type": "object"
+ },
+ "text": {
+ "maxLength": 24,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "target",
+ "style"
+ ],
+ "type": "object"
+ },
+ "id": {
+ "description": "Unique across inserts, overlays, layout_windows and templates.",
+ "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$",
+ "type": "string"
+ },
+ "kind": {
+ "const": "callout",
+ "type": "string"
+ },
+ "placement": {
+ "description": "over (drawn over the presenter) or full (fills the frame); omitted means the kind's first placement, and a kind takes only the placements its catalog line names.",
+ "enum": [
+ "over",
+ "full"
+ ],
+ "type": "string"
+ },
+ "transition": {
+ "description": "Full placement only, as an insert's transition.",
+ "enum": [
+ "cut",
+ "wipe",
+ "flash",
+ "zoom"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "anchor",
+ "kind",
+ "data"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "anchor": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "endWord": {
+ "exclusiveMinimum": 0,
+ "maximum": 9007199254740991,
+ "type": "integer"
+ },
+ "startWord": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "startWord",
+ "endWord"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "occurrence": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "quote": {
+ "maxLength": 10000,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "quote"
+ ],
+ "type": "object"
+ }
+ ],
+ "description": "The words it starts on, as an insert anchor: { startWord, endWord } or { quote, occurrence? }."
+ },
+ "cover_words": {
+ "description": "How many spoken words it stays on screen, counted from the first word of its anchor. Omitted means the anchored words only.",
+ "exclusiveMinimum": 0,
+ "maximum": 10000,
+ "type": "integer"
+ },
+ "data": {
+ "additionalProperties": false,
+ "properties": {
+ "clicks": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "item": {
+ "maximum": 3,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "quote": {
+ "maxLength": 200,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "item"
+ ],
+ "type": "object"
+ },
+ "maxItems": 6,
+ "type": "array"
+ },
+ "items": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "icon": {
+ "enum": [
+ "phone",
+ "briefcase",
+ "user",
+ "clock",
+ "chat",
+ "star"
+ ],
+ "type": "string"
+ },
+ "label": {
+ "maxLength": 24,
+ "minLength": 1,
+ "type": "string"
+ },
+ "on": {
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "label",
+ "on"
+ ],
+ "type": "object"
+ },
+ "maxItems": 4,
+ "minItems": 2,
+ "type": "array"
+ },
+ "size": {
+ "enum": [
+ "small",
+ "medium",
+ "large"
+ ],
+ "type": "string"
+ },
+ "style": {
+ "enum": [
+ "switch",
+ "check"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "items"
+ ],
+ "type": "object"
+ },
+ "id": {
+ "description": "Unique across inserts, overlays, layout_windows and templates.",
+ "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$",
+ "type": "string"
+ },
+ "kind": {
+ "const": "checklist",
+ "type": "string"
+ },
+ "placement": {
+ "description": "over (drawn over the presenter) or full (fills the frame); omitted means the kind's first placement, and a kind takes only the placements its catalog line names.",
+ "enum": [
+ "over",
+ "full"
+ ],
+ "type": "string"
+ },
+ "transition": {
+ "description": "Full placement only, as an insert's transition.",
+ "enum": [
+ "cut",
+ "wipe",
+ "flash",
+ "zoom"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "anchor",
+ "kind",
+ "data"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "anchor": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "endWord": {
+ "exclusiveMinimum": 0,
+ "maximum": 9007199254740991,
+ "type": "integer"
+ },
+ "startWord": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "startWord",
+ "endWord"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "occurrence": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "quote": {
+ "maxLength": 10000,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "quote"
+ ],
+ "type": "object"
+ }
+ ],
+ "description": "The words it starts on, as an insert anchor: { startWord, endWord } or { quote, occurrence? }."
+ },
+ "cover_words": {
+ "description": "How many spoken words it stays on screen, counted from the first word of its anchor. Omitted means the anchored words only.",
+ "exclusiveMinimum": 0,
+ "maximum": 10000,
+ "type": "integer"
+ },
+ "data": {
+ "additionalProperties": false,
+ "properties": {
+ "answer_at": {
+ "maxLength": 200,
+ "minLength": 1,
+ "type": "string"
+ },
+ "avatar": {
+ "additionalProperties": false,
+ "properties": {
+ "asset_id": {
+ "description": "A ready asset from list_assets, of the kind the slot takes.",
+ "pattern": "^ast_[a-f0-9]{32}$",
+ "type": "string"
+ }
+ },
+ "required": [
+ "asset_id"
+ ],
+ "type": "object"
+ },
+ "banner": {
+ "maxLength": 32,
+ "minLength": 1,
+ "type": "string"
+ },
+ "banner_note": {
+ "maxLength": 48,
+ "minLength": 1,
+ "type": "string"
+ },
+ "caller": {
+ "maxLength": 24,
+ "minLength": 1,
+ "type": "string"
+ },
+ "mask_number": {
+ "type": "boolean"
+ },
+ "side": {
+ "enum": [
+ "left",
+ "right"
+ ],
+ "type": "string"
+ },
+ "size": {
+ "enum": [
+ "small",
+ "medium",
+ "large"
+ ],
+ "type": "string"
+ },
+ "subtitle": {
+ "maxLength": 32,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "caller",
+ "answer_at"
+ ],
+ "type": "object"
+ },
+ "id": {
+ "description": "Unique across inserts, overlays, layout_windows and templates.",
+ "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$",
+ "type": "string"
+ },
+ "kind": {
+ "const": "phone_call",
+ "type": "string"
+ },
+ "placement": {
+ "description": "over (drawn over the presenter) or full (fills the frame); omitted means the kind's first placement, and a kind takes only the placements its catalog line names.",
+ "enum": [
+ "over",
+ "full"
+ ],
+ "type": "string"
+ },
+ "transition": {
+ "description": "Full placement only, as an insert's transition.",
+ "enum": [
+ "cut",
+ "wipe",
+ "flash",
+ "zoom"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "anchor",
+ "kind",
+ "data"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "anchor": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "endWord": {
+ "exclusiveMinimum": 0,
+ "maximum": 9007199254740991,
+ "type": "integer"
+ },
+ "startWord": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "startWord",
+ "endWord"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "occurrence": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "quote": {
+ "maxLength": 10000,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "quote"
+ ],
+ "type": "object"
+ }
+ ],
+ "description": "The words it starts on, as an insert anchor: { startWord, endWord } or { quote, occurrence? }."
+ },
+ "cover_words": {
+ "description": "How many spoken words it stays on screen, counted from the first word of its anchor. Omitted means the anchored words only.",
+ "exclusiveMinimum": 0,
+ "maximum": 10000,
+ "type": "integer"
+ },
+ "data": {
+ "additionalProperties": false,
+ "properties": {
+ "after": {
+ "additionalProperties": false,
+ "properties": {
+ "asset_id": {
+ "description": "A ready asset from list_assets, of the kind the slot takes.",
+ "pattern": "^ast_[a-f0-9]{32}$",
+ "type": "string"
+ }
+ },
+ "required": [
+ "asset_id"
+ ],
+ "type": "object"
+ },
+ "before": {
+ "additionalProperties": false,
+ "properties": {
+ "asset_id": {
+ "description": "A ready asset from list_assets, of the kind the slot takes.",
+ "pattern": "^ast_[a-f0-9]{32}$",
+ "type": "string"
+ }
+ },
+ "required": [
+ "asset_id"
+ ],
+ "type": "object"
+ },
+ "labels": {
+ "additionalProperties": false,
+ "properties": {
+ "after": {
+ "maxLength": 20,
+ "minLength": 1,
+ "type": "string"
+ },
+ "before": {
+ "maxLength": 20,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "reveal_at": {
+ "maxLength": 200,
+ "minLength": 1,
+ "type": "string"
+ },
+ "size": {
+ "enum": [
+ "small",
+ "medium",
+ "large"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "before",
+ "after",
+ "reveal_at"
+ ],
+ "type": "object"
+ },
+ "id": {
+ "description": "Unique across inserts, overlays, layout_windows and templates.",
+ "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$",
+ "type": "string"
+ },
+ "kind": {
+ "const": "compare",
+ "type": "string"
+ },
+ "placement": {
+ "description": "over (drawn over the presenter) or full (fills the frame); omitted means the kind's first placement, and a kind takes only the placements its catalog line names.",
+ "enum": [
+ "over",
+ "full"
+ ],
+ "type": "string"
+ },
+ "transition": {
+ "description": "Full placement only, as an insert's transition.",
+ "enum": [
+ "cut",
+ "wipe",
+ "flash",
+ "zoom"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "anchor",
+ "kind",
+ "data"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "anchor": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "endWord": {
+ "exclusiveMinimum": 0,
+ "maximum": 9007199254740991,
+ "type": "integer"
+ },
+ "startWord": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "startWord",
+ "endWord"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "occurrence": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "quote": {
+ "maxLength": 10000,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "quote"
+ ],
+ "type": "object"
+ }
+ ],
+ "description": "The words it starts on, as an insert anchor: { startWord, endWord } or { quote, occurrence? }."
+ },
+ "cover_words": {
+ "description": "How many spoken words it stays on screen, counted from the first word of its anchor. Omitted means the anchored words only.",
+ "exclusiveMinimum": 0,
+ "maximum": 10000,
+ "type": "integer"
+ },
+ "data": {
+ "additionalProperties": false,
+ "properties": {
+ "app": {
+ "maxLength": 20,
+ "minLength": 1,
+ "type": "string"
+ },
+ "body": {
+ "maxLength": 80,
+ "minLength": 1,
+ "type": "string"
+ },
+ "icon": {
+ "enum": [
+ "phone",
+ "briefcase",
+ "user",
+ "clock",
+ "chat",
+ "star"
+ ],
+ "type": "string"
+ },
+ "size": {
+ "enum": [
+ "small",
+ "medium",
+ "large"
+ ],
+ "type": "string"
+ },
+ "title": {
+ "maxLength": 32,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "app",
+ "title",
+ "body"
+ ],
+ "type": "object"
+ },
+ "id": {
+ "description": "Unique across inserts, overlays, layout_windows and templates.",
+ "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$",
+ "type": "string"
+ },
+ "kind": {
+ "const": "notification",
+ "type": "string"
+ },
+ "placement": {
+ "description": "over (drawn over the presenter) or full (fills the frame); omitted means the kind's first placement, and a kind takes only the placements its catalog line names.",
+ "enum": [
+ "over",
+ "full"
+ ],
+ "type": "string"
+ },
+ "transition": {
+ "description": "Full placement only, as an insert's transition.",
+ "enum": [
+ "cut",
+ "wipe",
+ "flash",
+ "zoom"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "anchor",
+ "kind",
+ "data"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "anchor": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "endWord": {
+ "exclusiveMinimum": 0,
+ "maximum": 9007199254740991,
+ "type": "integer"
+ },
+ "startWord": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "startWord",
+ "endWord"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "occurrence": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "quote": {
+ "maxLength": 10000,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "quote"
+ ],
+ "type": "object"
+ }
+ ],
+ "description": "The words it starts on, as an insert anchor: { startWord, endWord } or { quote, occurrence? }."
+ },
+ "cover_words": {
+ "description": "How many spoken words it stays on screen, counted from the first word of its anchor. Omitted means the anchored words only.",
+ "exclusiveMinimum": 0,
+ "maximum": 10000,
+ "type": "integer"
+ },
+ "data": {
+ "additionalProperties": false,
+ "properties": {
+ "advance_at": {
+ "items": {
+ "maxLength": 200,
+ "minLength": 1,
+ "type": "string"
+ },
+ "maxItems": 5,
+ "minItems": 2,
+ "type": "array"
+ },
+ "size": {
+ "enum": [
+ "small",
+ "medium",
+ "large"
+ ],
+ "type": "string"
+ },
+ "steps": {
+ "items": {
+ "maxLength": 20,
+ "minLength": 1,
+ "type": "string"
+ },
+ "maxItems": 5,
+ "minItems": 2,
+ "type": "array"
+ }
+ },
+ "required": [
+ "steps"
+ ],
+ "type": "object"
+ },
+ "id": {
+ "description": "Unique across inserts, overlays, layout_windows and templates.",
+ "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$",
+ "type": "string"
+ },
+ "kind": {
+ "const": "progress",
+ "type": "string"
+ },
+ "placement": {
+ "description": "over (drawn over the presenter) or full (fills the frame); omitted means the kind's first placement, and a kind takes only the placements its catalog line names.",
+ "enum": [
+ "over",
+ "full"
+ ],
+ "type": "string"
+ },
+ "transition": {
+ "description": "Full placement only, as an insert's transition.",
+ "enum": [
+ "cut",
+ "wipe",
+ "flash",
+ "zoom"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "anchor",
+ "kind",
+ "data"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "anchor": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "endWord": {
+ "exclusiveMinimum": 0,
+ "maximum": 9007199254740991,
+ "type": "integer"
+ },
+ "startWord": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "startWord",
+ "endWord"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "occurrence": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "quote": {
+ "maxLength": 10000,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "quote"
+ ],
+ "type": "object"
+ }
+ ],
+ "description": "The words it starts on, as an insert anchor: { startWord, endWord } or { quote, occurrence? }."
+ },
+ "cover_words": {
+ "description": "How many spoken words it stays on screen, counted from the first word of its anchor. Omitted means the anchored words only.",
+ "exclusiveMinimum": 0,
+ "maximum": 10000,
+ "type": "integer"
+ },
+ "data": {
+ "additionalProperties": false,
+ "properties": {
+ "label": {
+ "maxLength": 32,
+ "minLength": 1,
+ "type": "string"
+ },
+ "size": {
+ "enum": [
+ "small",
+ "medium",
+ "large"
+ ],
+ "type": "string"
+ },
+ "stars": {
+ "maximum": 5,
+ "minimum": 1,
+ "multipleOf": 0.5,
+ "type": "number"
+ }
+ },
+ "required": [
+ "stars"
+ ],
+ "type": "object"
+ },
+ "id": {
+ "description": "Unique across inserts, overlays, layout_windows and templates.",
+ "pattern": "^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$",
+ "type": "string"
+ },
+ "kind": {
+ "const": "rating",
+ "type": "string"
+ },
+ "placement": {
+ "description": "over (drawn over the presenter) or full (fills the frame); omitted means the kind's first placement, and a kind takes only the placements its catalog line names.",
+ "enum": [
+ "over",
+ "full"
+ ],
+ "type": "string"
+ },
+ "transition": {
+ "description": "Full placement only, as an insert's transition.",
+ "enum": [
+ "cut",
+ "wipe",
+ "flash",
+ "zoom"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "anchor",
+ "kind",
+ "data"
+ ],
+ "type": "object"
+ }
+ ]
+ },
+ "maxItems": 12,
+ "minItems": 1,
+ "type": "array"
+ },
+ "tts_model": {
+ "description": "Speech model: eleven_v3 | eleven_flash_v2_5 | eleven_turbo_v2_5 | eleven_v4 | gemini-3.8-flash-tts. Omitted means the model of the chosen voice (list_voices shows it): gemini-3.8-flash-tts for its own voices, eleven_v4 for every preset, catalog voice and raw voice_id. An explicit tts_model wins, except eleven_v3: it is no longer spoken, and a run naming it speaks eleven_v4 with a warning. eleven_v4 and gemini-3.8-flash-tts read stress marks (a capital vowel inside a Russian word, \"потОм\", becomes one; see script); eleven_flash_v2_5 and eleven_turbo_v2_5 are cheaper alternatives for languages other than Russian. gemini-3.8-flash-tts speaks only its own voices (list_voices with model=gemini-3.8-flash-tts; without voice, kore for a female actor and charon otherwise) and returns no word timings: a preset or catalog voice, voice_id, captions=true, segments and inserts are refused with it before any charge. Audio tags in square brackets are a convention of the other speech models and are not measured on it. Script limits by speech model: eleven_v3: 5000 characters; eleven_flash_v2_5: 10000 characters; eleven_turbo_v2_5: 10000 characters; eleven_v4: 5000 characters; gemini-3.8-flash-tts: 5000 characters. Count includes spaces, audio tags and stress marks; emoji may count as two characters. Break tags are cut from the text sent to eleven_v4 and gemini-3.8-flash-tts and are not counted there. There is no word-count limit. Duration and price are estimates until measured.",
+ "enum": [
+ "eleven_v3",
+ "eleven_flash_v2_5",
+ "eleven_turbo_v2_5",
+ "eleven_v4",
+ "gemini-3.8-flash-tts"
+ ],
+ "type": "string"
+ },
+ "visible_ai_label": {
+ "description": "Visible AI label for newly marked presenter videos, including long form; defaults to true in the server admission policy. False hides only the visible label and does not disable invisible marking or signed provenance. Historical outputs are unchanged.",
+ "type": "boolean"
+ },
+ "voice": {
+ "description": "Voice name from list_voices. Curated presets: sarah | george | eric | daria_ru_female. The API refuses a name list_voices does not return, before any charge. Omitted means the default voice for the actor's gender: the gender of actor_id, actor_gender with image, or george for the default actor and for image without actor_gender. gemini-3.8-flash-tts speaks only its own voices (kind model_voice in list_voices, such as kore): naming one selects that model, and a voice is refused with a tts_model that does not speak it, before any charge. Mutually exclusive with voice_id.",
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$",
+ "type": "string"
+ },
+ "voice_id": {
+ "description": "Raw vendor voice id (16–32 letters and digits) for a voice outside the catalog. Checked lazily: an unknown id fails the run, not the request. Refused with tts_model=gemini-3.8-flash-tts. Mutually exclusive with voice.",
+ "pattern": "^[A-Za-z0-9]{16,32}$",
+ "type": "string"
+ },
+ "voice_pace": {
+ "description": "Narration speed; 1 is the voice's own. gemini-3.8-flash-tts gets a style hint instead; eleven_v4 has no speed, so pick a voice by list_voices words_per_second; both named in warnings[].",
+ "maximum": 1.2,
+ "minimum": 0.7,
+ "type": "number"
+ }
+ },
+ "type": "object"
+ },
+ "skill": {
+ "const": "make_ugc",
+ "type": "string"
+ }
+ },
+ "required": [
+ "skill",
+ "input"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "input": {
+ "oneOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "captions": {
+ "default": true,
+ "type": "boolean"
+ },
+ "character_details": {
+ "maxLength": 400,
+ "minLength": 1,
+ "type": "string"
+ },
+ "character_reference": {
+ "format": "starts_with",
+ "maxLength": 2048,
+ "pattern": "^https:\\/\\/.*",
+ "type": "string"
+ },
+ "duration_seconds": {
+ "maximum": 90,
+ "minimum": 30,
+ "type": "number"
+ },
+ "input_mode": {
+ "const": "script",
+ "type": "string"
+ },
+ "scene_images": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "anchor": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "endWord": {
+ "exclusiveMinimum": 0,
+ "maximum": 9007199254740991,
+ "type": "integer"
+ },
+ "startWord": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "startWord",
+ "endWord"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "occurrence": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "quote": {
+ "maxLength": 500,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "quote"
+ ],
+ "type": "object"
+ }
+ ]
+ },
+ "image_url": {
+ "format": "starts_with",
+ "maxLength": 2048,
+ "pattern": "^https:\\/\\/.*",
+ "type": "string"
+ }
+ },
+ "required": [
+ "image_url",
+ "anchor"
+ ],
+ "type": "object"
+ },
+ "maxItems": 30,
+ "type": "array"
+ },
+ "script": {
+ "maxLength": 10000,
+ "minLength": 1,
+ "type": "string"
+ },
+ "style_reference": {
+ "format": "starts_with",
+ "maxLength": 2048,
+ "pattern": "^https:\\/\\/.*",
+ "type": "string"
+ },
+ "voice": {
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$",
+ "type": "string"
+ },
+ "voice_id": {
+ "not": {}
+ }
+ },
+ "required": [
+ "duration_seconds",
+ "input_mode",
+ "script"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "brief": {
+ "maxLength": 5000,
+ "minLength": 1,
+ "type": "string"
+ },
+ "captions": {
+ "default": true,
+ "type": "boolean"
+ },
+ "character_details": {
+ "maxLength": 400,
+ "minLength": 1,
+ "type": "string"
+ },
+ "character_reference": {
+ "format": "starts_with",
+ "maxLength": 2048,
+ "pattern": "^https:\\/\\/.*",
+ "type": "string"
+ },
+ "duration_seconds": {
+ "maximum": 90,
+ "minimum": 30,
+ "type": "number"
+ },
+ "input_mode": {
+ "const": "brief",
+ "type": "string"
+ },
+ "scene_images": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "anchor": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "endWord": {
+ "exclusiveMinimum": 0,
+ "maximum": 9007199254740991,
+ "type": "integer"
+ },
+ "startWord": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "startWord",
+ "endWord"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "occurrence": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "quote": {
+ "maxLength": 500,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "quote"
+ ],
+ "type": "object"
+ }
+ ]
+ },
+ "image_url": {
+ "format": "starts_with",
+ "maxLength": 2048,
+ "pattern": "^https:\\/\\/.*",
+ "type": "string"
+ }
+ },
+ "required": [
+ "image_url",
+ "anchor"
+ ],
+ "type": "object"
+ },
+ "maxItems": 30,
+ "type": "array"
+ },
+ "style_reference": {
+ "format": "starts_with",
+ "maxLength": 2048,
+ "pattern": "^https:\\/\\/.*",
+ "type": "string"
+ },
+ "voice": {
+ "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$",
+ "type": "string"
+ },
+ "voice_id": {
+ "not": {}
+ }
+ },
+ "required": [
+ "duration_seconds",
+ "input_mode",
+ "brief"
+ ],
+ "type": "object"
+ }
+ ]
+ },
+ "skill": {
+ "const": "make_faceless",
+ "type": "string"
+ }
+ },
+ "required": [
+ "skill",
+ "input"
+ ],
+ "type": "object"
+ }
+]
