klipvia.miztton.com

{
  "type": "object",
  "properties": {
    "itemId": {
      "type": "string",
      "description": "Item id from get_timeline."
    },
    "name": {
      "type": "string",
      "description": "Display name."
    },
    "startSeconds": {
      "type": "number",
      "description": "Start on the timeline."
    },
    "durationSeconds": {
      "type": "number",
      "description": "Length on the timeline."
    },
    "inSeconds": {
      "type": "number",
      "description": "In-point inside the source."
    },
    "fit": {
      "type": "string",
      "enum": [
        "contain",
        "cover",
        "fill",
        "none"
      ],
      "description": "Footage: letterbox, crop, stretch, or native size."
    },
    "anchor": {
      "type": "string",
      "enum": [
        "center",
        "top",
        "bottom",
        "left",
        "right",
        "top-left",
        "top-right",
        "bottom-left",
        "bottom-right"
      ],
      "description": "Where an overlay (or fit:none footage) sits."
    },
    "offsetX": {
      "type": "integer",
      "description": "Pixels from the anchor, horizontally."
    },
    "offsetY": {
      "type": "integer",
      "description": "Pixels from the anchor, vertically."
    },
    "speed": {
      "type": "number",
      "description": "Footage, nested blocks and animation clips only: how fast the source runs against the timeline. 1 is normal, 2 plays twice as fast, 0.5 is slow motion. The item keeps its length on the timeline and shows more or less of the source; sound is re-timed with its pitch kept. A caption or a title has no speed — its timing comes from its transcript or its own length."
    },
    "dissolveInSeconds": {
      "type": "number",
      "description": "Fade the picture up over this long at the start. Half of a cross dissolve."
    },
    "dissolveOutSeconds": {
      "type": "number",
      "description": "Fade the picture down over this long at the end."
    },
    "scale": {
      "type": "number",
      "description": "Footage, nested blocks and animation clips only, and only with fit:none: how big the layer is drawn against its natural size. 1 is unchanged, 0.3 is a picture-in-picture corner. An animation clip is re-rendered at that size, so it stays sharp; footage is resampled. An image, shape or title has no scale — give it a size instead."
    },
    "rotation": {
      "type": "number",
      "description": "Degrees clockwise, about the middle of the layer. -180 to 180."
    },
    "flipH": {
      "type": "boolean",
      "description": "Mirror left to right."
    },
    "flipV": {
      "type": "boolean",
      "description": "Mirror top to bottom."
    },
    "crop": {
      "type": "object",
      "description": "Footage and nested blocks only: how much of each edge to cut off before the fit, as fractions 0-0.95 — {top, right, bottom, left}. Fractions of the source, so the framing survives swapping the shot for another resolution. null clears it."
    },
    "colour": {
      "type": "object",
      "description": "Colour correction: {brightness, contrast, saturation} where 1 is unchanged, and {temperature} from -1 (cool) to 1 (warm). null clears it."
    },
    "blend": {
      "type": "string",
      "enum": [
        "normal",
        "multiply",
        "screen",
        "overlay",
        "darken",
        "lighten",
        "softlight",
        "hardlight",
        "difference",
        "exclusion"
      ],
      "description": "How the layer mixes with what is under it."
    },
    "radius": {
      "type": "integer",
      "description": "Round the layer's corners, in frame pixels. 0 is square."
    },
    "shadow": {
      "type": "object",
      "description": "A drop shadow under the layer: {blur, x, y, color, opacity}. blur 0 turns it off; null clears it. This is what makes a picture-in-picture read as a card over the footage."
    },
    "opacity": {
      "type": "number",
      "description": "0-1."
    },
    "volume": {
      "type": "number",
      "description": "0-4; 1 is unchanged."
    },
    "muted": {
      "type": "boolean",
      "description": "Silence the item."
    },
    "fadeInSeconds": {
      "type": "number",
      "description": "Audio fade in."
    },
    "fadeOutSeconds": {
      "type": "number",
      "description": "Audio fade out."
    },
    "captionStyle": {
      "type": "object",
      "description": "Caption items: fontSize, color, boxColor, position (top|center|bottom), marginPx, maxWidthPct, uppercase, shadow, fontFamily, weight, transition (cut|fade|pop), karaoke (off|word|fill), accent."
    },
    "note": {
      "type": "string",
      "description": "Free text kept on the item and shown in get_timeline. Empty string clears it."
    },
    "text": {
      "type": "string",
      "description": "Text items: the words."
    },
    "subtext": {
      "type": "string",
      "description": "Text items: the second line, where the preset has one."
    },
    "preset": {
      "type": "string",
      "description": "Text items: switch preset (see list_text_presets)."
    },
    "imageStyle": {
      "type": "object",
      "description": "Image items: width, height (pixels at timeline size; omit for natural size), radius (corner px), shadow (boolean). Use fit for contain/cover/fill/none."
    },
    "textStyle": {
      "type": "object",
      "description": "Text items: fontFamily, fontSize, color, accent, boxColor, weight (400-900), uppercase, align (left|center|right). Shapes: width, height, radius, stroke (the one line weight), color (fill), accent (line), direction (right|left|up|down), dashed; a marker's number is the item's text."
    },
    "timelineId": {
      "type": "string",
      "description": "Work in this timeline (id from list_timelines) instead of the open one. It need not be open; the view stays where it is."
    }
  },
  "required": [
    "itemId"
  ]
}