@shotstack/schemas 1.4.1 → 1.4.3

package/dist/api.bundled.json

@@ -1026,10 +1026,9 @@
               },
               {
                 "type": "string",
-                "description": "The start position using a [smart clip property](/docs/guide/architecting-an-application/smart-clips/). Set to `auto` to automatically play the clip after the previous clip finishes.",
-                "enum": [
-                  "auto"
-                ]
+                "description": "The start position using a [smart clip property](/docs/guide/architecting-an-application/smart-clips/). Set to `auto` to automatically play the clip after the previous clip finishes. Use `alias://clip-name` to inherit the start time from the referenced clip.",
+                "pattern": "^(auto|alias://[A-Za-z0-9_-]+)$",
+                "example": "auto"
               }
             ]
           },
@@ -1043,11 +1042,9 @@
               },
               {
                 "type": "string",
-                "description": "The duration the Clip should play for using a [smart clip property](/docs/guide/architecting-an-application/smart-clips/). Set to `auto` to play the Clip for the duration of the asset. Set to `end` to display or play the clip to the end of the timeline.",
-                "enum": [
-                  "auto",
-                  "end"
-                ]
+                "description": "The duration the Clip should play for using a [smart clip property](/docs/guide/architecting-an-application/smart-clips/). Set to `auto` to play the Clip for the duration of the asset. Set to `end` to display or play the clip to the end of the timeline. Use `alias://clip-name` to inherit the length from the referenced clip.",
+                "pattern": "^(auto|end|alias://[A-Za-z0-9_-]+)$",
+                "example": "auto"
               }
             ]
           },
@@ -1062,9 +1059,22 @@
             "type": "string"
           },
           "scale": {
-            "description": "Scale the asset to a fraction of the viewport size - i.e. setting the scale to 0.5 will scale asset to half the size of the viewport. This is useful for picture-in-picture video and scaling images such as logos and watermarks.",
-            "type": "number",
-            "example": 0
+            "description": "Scale the asset to a fraction of the viewport size - i.e. setting the scale to 0.5 will scale asset to half the size of the viewport. This is useful for picture-in-picture video and scaling images such as logos and watermarks. Use a number or an array of [Tween](./#tocs_tween) objects to create a custom animation.",
+            "oneOf": [
+              {
+                "type": "number",
+                "description": "Scale the asset to a fraction of the viewport size. For example, 0.5 will scale the asset to half the size of the viewport.",
+                "format": "float",
+                "example": 0.5
+              },
+              {
+                "type": "array",
+                "description": "An array of [Tween](./#tocs_tween) objects used to create a custom animation. Animate the scale of an asset over time.",
+                "items": {
+                  "$ref": "#/components/schemas/Tween"
+                }
+              }
+            ]
           },
           "width": {
             "description": "Set the width of the clip bounding box in pixels. This constrains the width of the clip, overriding the default behavior where clips fill the viewport width.",
@@ -1798,7 +1808,7 @@
             "type": "string"
           },
           "src": {
-            "description": "The URL to an SRT or VTT subtitles file. The URL must be publicly accessible or include credentials.",
+            "description": "The URL to an SRT or VTT subtitles file, or an alias reference to auto-generate captions from an audio or video clip. For file URLs, the URL must be publicly accessible or include credentials. For auto-captioning, use the format `alias://clip-name` where clip-name is the alias of an audio, video, or text-to-speech clip. The system will automatically transcribe the audio and detect the language.",
             "type": "string",
             "example": "https://s3-ap-northeast-1.amazonaws.com/my-bucket/captions.srt"
           },
@@ -1815,7 +1825,7 @@
             "$ref": "#/components/schemas/CaptionMargin"
           },
           "trim": {
-            "description": "The start trim point of the captions, in seconds (defaults to 0). Remove the trim length from teh start of the captions and allow it to be synced with video or audio. The captions will play until the file ends or the Clip length is reached.",
+            "description": "The start trim point of the captions, in seconds (defaults to 0). Remove the trim length from the start of the captions and allow it to be synced with video or audio. The captions will play until the file ends or the Clip length is reached.",
             "type": "number",
             "example": 2
           },
@@ -3733,11 +3743,12 @@
         "type": "object"
       },
       "ChromaKey": {
-        "description": "Chroma key, commonly known as green screen, is a technique that replaces a specific color in a video with a different background image or video, enabling seamless integration of diverse environments.",
+        "description": "Chroma key is a technique that replaces a specific color in a video with a different background image or video, enabling seamless integration of diverse environments. Commonly used for green screen and blue screen effects.",
         "properties": {
           "color": {
-            "description": "The chroma key color as a hex value. For a green screen, use a green hex value.",
+            "description": "The chroma key color as a hex value. Use green (#00b140) for green screens or blue (#0000FF) for blue screens. Any valid hex color can be used as the key color.",
             "type": "string",
+            "pattern": "^#[0-9a-fA-F]{6}$",
             "example": "#00b140"
           },
           "threshold": {
@@ -3755,6 +3766,9 @@
             "example": 100
           }
         },
+        "required": [
+          "color"
+        ],
         "type": "object"
       },
       "Tween": {

package/dist/schema.d.ts

@@ -498,9 +498,9 @@ export interface components {
         Clip: {
             asset: components["schemas"]["Asset"];
             /** @description The start position of the Clip on the timeline. */
-            start: number | "auto";
+            start: number | string;
             /** @description The duration the Clip should play for. */
-            length: number | ("auto" | "end");
+            length: number | string;
             /**
              * @description Set how the asset should be scaled to fit the viewport using one of the following options:
              *       <ul>
@@ -512,11 +512,8 @@ export interface components {
              * @enum {string}
              */
             fit?: "cover" | "contain" | "crop" | "none";
-            /**
-             * @description Scale the asset to a fraction of the viewport size - i.e. setting the scale to 0.5 will scale asset to half the size of the viewport. This is useful for picture-in-picture video and scaling images such as logos and watermarks.
-             * @example 0
-             */
-            scale?: number;
+            /** @description Scale the asset to a fraction of the viewport size - i.e. setting the scale to 0.5 will scale asset to half the size of the viewport. This is useful for picture-in-picture video and scaling images such as logos and watermarks. Use a number or an array of [Tween](./#tocs_tween) objects to create a custom animation. */
+            scale?: number | components["schemas"]["Tween"][];
             /**
              * @description Set the width of the clip bounding box in pixels. This constrains the width of the clip, overriding the default behavior where clips fill the viewport width.
              * @example 800
@@ -945,7 +942,7 @@ export interface components {
              */
             type: "caption";
             /**
-             * @description The URL to an SRT or VTT subtitles file. The URL must be publicly accessible or include credentials.
+             * @description The URL to an SRT or VTT subtitles file, or an alias reference to auto-generate captions from an audio or video clip. For file URLs, the URL must be publicly accessible or include credentials. For auto-captioning, use the format `alias://clip-name` where clip-name is the alias of an audio, video, or text-to-speech clip. The system will automatically transcribe the audio and detect the language.
              * @example https://s3-ap-northeast-1.amazonaws.com/my-bucket/captions.srt
              */
             src: string;
@@ -956,7 +953,7 @@ export interface components {
             /** @description Margin properties. */
             margin?: components["schemas"]["CaptionMargin"];
             /**
-             * @description The start trim point of the captions, in seconds (defaults to 0). Remove the trim length from teh start of the captions and allow it to be synced with video or audio. The captions will play until the file ends or the Clip length is reached.
+             * @description The start trim point of the captions, in seconds (defaults to 0). Remove the trim length from the start of the captions and allow it to be synced with video or audio. The captions will play until the file ends or the Clip length is reached.
              * @example 2
              */
             trim?: number;
@@ -2347,13 +2344,13 @@ export interface components {
              */
             right?: number;
         };
-        /** @description Chroma key, commonly known as green screen, is a technique that replaces a specific color in a video with a different background image or video, enabling seamless integration of diverse environments. */
+        /** @description Chroma key is a technique that replaces a specific color in a video with a different background image or video, enabling seamless integration of diverse environments. Commonly used for green screen and blue screen effects. */
         ChromaKey: {
             /**
-             * @description The chroma key color as a hex value. For a green screen, use a green hex value.
+             * @description The chroma key color as a hex value. Use green (#00b140) for green screens or blue (#0000FF) for blue screens. Any valid hex color can be used as the key color.
              * @example #00b140
              */
-            color?: string;
+            color: string;
             /**
              * @description Pixels within this distance from the key color are eliminated by setting their alpha values to zero.
              * @example 150