@shotstack/schemas 1.23.3 → 1.24.0-beta.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -201,6 +201,124 @@
201
201
  "type"
202
202
  ]
203
203
  },
204
+ "BlurFilter": {
205
+ "description": "Blurs the clip. Set `value` to blur both axes equally, or set `x` and `y` to blur each axis separately.",
206
+ "type": "object",
207
+ "additionalProperties": false,
208
+ "properties": {
209
+ "type": {
210
+ "description": "The filter type - set to `blur`.",
211
+ "type": "string",
212
+ "enum": [
213
+ "blur"
214
+ ]
215
+ },
216
+ "value": {
217
+ "description": "Sets the blur radius in pixels, measured on the clip before it is scaled to fit the viewport. Use a number or an array of [Tween](./#tocs_tween) objects to change it over time.",
218
+ "oneOf": [
219
+ {
220
+ "type": "number",
221
+ "description": "The blur radius in pixels from 0 to 100. 0 applies no blur (default) and 10 matches the `blur` filter preset.",
222
+ "minimum": 0,
223
+ "maximum": 100,
224
+ "examples": [
225
+ 10
226
+ ]
227
+ },
228
+ {
229
+ "type": "array",
230
+ "description": "An array of [Tween](./#tocs_tween) objects that change the blur radius over time.",
231
+ "items": {
232
+ "$ref": "#/$defs/Tween"
233
+ }
234
+ }
235
+ ]
236
+ },
237
+ "x": {
238
+ "description": "Sets the horizontal blur radius in pixels, overriding `value` on that axis. When omitted, `value` is used. Use a number or an array of [Tween](./#tocs_tween) objects to change it over time.",
239
+ "oneOf": [
240
+ {
241
+ "type": "number",
242
+ "description": "The horizontal blur radius in pixels from 0 to 100.",
243
+ "minimum": 0,
244
+ "maximum": 100,
245
+ "examples": [
246
+ 20
247
+ ]
248
+ },
249
+ {
250
+ "type": "array",
251
+ "description": "An array of [Tween](./#tocs_tween) objects that change the horizontal blur radius over time.",
252
+ "items": {
253
+ "$ref": "#/$defs/Tween"
254
+ }
255
+ }
256
+ ]
257
+ },
258
+ "y": {
259
+ "description": "Sets the vertical blur radius in pixels, overriding `value` on that axis. When omitted, `value` is used. Use a number or an array of [Tween](./#tocs_tween) objects to change it over time.",
260
+ "oneOf": [
261
+ {
262
+ "type": "number",
263
+ "description": "The vertical blur radius in pixels from 0 to 100.",
264
+ "minimum": 0,
265
+ "maximum": 100,
266
+ "examples": [
267
+ 5
268
+ ]
269
+ },
270
+ {
271
+ "type": "array",
272
+ "description": "An array of [Tween](./#tocs_tween) objects that change the vertical blur radius over time.",
273
+ "items": {
274
+ "$ref": "#/$defs/Tween"
275
+ }
276
+ }
277
+ ]
278
+ }
279
+ },
280
+ "required": [
281
+ "type"
282
+ ]
283
+ },
284
+ "BrightnessFilter": {
285
+ "description": "Lightens or darkens the clip.",
286
+ "type": "object",
287
+ "additionalProperties": false,
288
+ "properties": {
289
+ "type": {
290
+ "description": "The filter type - set to `brightness`.",
291
+ "type": "string",
292
+ "enum": [
293
+ "brightness"
294
+ ]
295
+ },
296
+ "value": {
297
+ "description": "Sets the brightness shift of the clip. Use a number or an array of [Tween](./#tocs_tween) objects to change it over time.",
298
+ "oneOf": [
299
+ {
300
+ "type": "number",
301
+ "description": "The brightness shift from -1 to 1. Positive values lighten the clip, negative values darken it and 0 leaves it unchanged (default).",
302
+ "minimum": -1,
303
+ "maximum": 1,
304
+ "examples": [
305
+ 0.2
306
+ ]
307
+ },
308
+ {
309
+ "type": "array",
310
+ "description": "An array of [Tween](./#tocs_tween) objects that change the brightness shift over time.",
311
+ "items": {
312
+ "$ref": "#/$defs/Tween"
313
+ }
314
+ }
315
+ ]
316
+ }
317
+ },
318
+ "required": [
319
+ "type"
320
+ ]
321
+ },
204
322
  "CaptionAsset": {
205
323
  "deprecated": true,
206
324
  "description": "**Notice: The CaptionAsset is deprecated, use the [RichCaptionAsset](#tocs_richcaptionasset) instead.**\n\nThe CaptionAsset is used to add captions (subtitles) to a video. It uses a supplied SRT or VTT file which will\nbe read and burnt to the video.\n\nCaptions can be applied independently from a video or audio file for greater\nflexibility with styling and layout. For example you can scale, position or crop a video without modifying the\ncaptions.\n\nTo sync captions with a video or audio file use a [Video](#tocs_videoasset) or [Audio](#tocs_audioasset) with\nmatching start and end time.",
@@ -579,6 +697,13 @@
579
697
  "greyscale"
580
698
  ]
581
699
  },
700
+ "filters": {
701
+ "description": "A list of filters to apply to the Clip, in the order they appear. Each filter has a `type` and its own properties. The same type can be used more than once and numeric properties can be animated with [Tween](./#tocs_tween) objects. If `filter` is also set, the filters in this list are applied before it.",
702
+ "type": "array",
703
+ "items": {
704
+ "$ref": "#/$defs/Filter"
705
+ }
706
+ },
582
707
  "opacity": {
583
708
  "description": "Offset an asset on the horizontal axis (left or right). Use a number or an array of [Tween](./#tocs_tween) objects to create a custom animation.",
584
709
  "oneOf": [
@@ -619,6 +744,44 @@
619
744
  ],
620
745
  "type": "object"
621
746
  },
747
+ "ContrastFilter": {
748
+ "description": "Increases or decreases the difference between the light and dark areas of the clip.",
749
+ "type": "object",
750
+ "additionalProperties": false,
751
+ "properties": {
752
+ "type": {
753
+ "description": "The filter type - set to `contrast`.",
754
+ "type": "string",
755
+ "enum": [
756
+ "contrast"
757
+ ]
758
+ },
759
+ "value": {
760
+ "description": "Sets the contrast of the clip. Use a number or an array of [Tween](./#tocs_tween) objects to change it over time.",
761
+ "oneOf": [
762
+ {
763
+ "type": "number",
764
+ "description": "The contrast multiplier from 0 to 4. 1 leaves the clip unchanged (default), higher values increase the contrast and 0 produces flat grey.",
765
+ "minimum": 0,
766
+ "maximum": 4,
767
+ "examples": [
768
+ 1.5
769
+ ]
770
+ },
771
+ {
772
+ "type": "array",
773
+ "description": "An array of [Tween](./#tocs_tween) objects that change the contrast over time.",
774
+ "items": {
775
+ "$ref": "#/$defs/Tween"
776
+ }
777
+ }
778
+ ]
779
+ }
780
+ },
781
+ "required": [
782
+ "type"
783
+ ]
784
+ },
622
785
  "Crop": {
623
786
  "description": "Crop the sides of an asset by a relative amount. The size of the crop is specified using a scale between 0 and 1, relative to the screen width - i.e a left crop of 0.5 will crop half of the asset from the left, a top crop of 0.25 will crop the top by quarter of the asset.",
624
787
  "properties": {
@@ -857,6 +1020,42 @@
857
1020
  }
858
1021
  ]
859
1022
  },
1023
+ "Filter": {
1024
+ "type": "object",
1025
+ "description": "A filter that adjusts the look of a Clip. Choose from one of the available filter types below. Keyframe values outside a field's range are limited to that range.",
1026
+ "oneOf": [
1027
+ {
1028
+ "$ref": "#/$defs/BrightnessFilter"
1029
+ },
1030
+ {
1031
+ "$ref": "#/$defs/ContrastFilter"
1032
+ },
1033
+ {
1034
+ "$ref": "#/$defs/SaturationFilter"
1035
+ },
1036
+ {
1037
+ "$ref": "#/$defs/HueFilter"
1038
+ },
1039
+ {
1040
+ "$ref": "#/$defs/GradeFilter"
1041
+ },
1042
+ {
1043
+ "$ref": "#/$defs/BlurFilter"
1044
+ },
1045
+ {
1046
+ "$ref": "#/$defs/SharpenFilter"
1047
+ },
1048
+ {
1049
+ "$ref": "#/$defs/PixelateFilter"
1050
+ },
1051
+ {
1052
+ "$ref": "#/$defs/RgbSplitFilter"
1053
+ },
1054
+ {
1055
+ "$ref": "#/$defs/NegativeFilter"
1056
+ }
1057
+ ]
1058
+ },
860
1059
  "FlipTransformation": {
861
1060
  "description": "Flip a clip vertically or horizontally. Acts as a mirror effect of the clip along the selected plane.",
862
1061
  "type": "object",
@@ -987,6 +1186,149 @@
987
1186
  },
988
1187
  "type": "object"
989
1188
  },
1189
+ "GradeFilter": {
1190
+ "description": "Applies several grading adjustments at once: exposure, temperature, tint, highlights, shadows and vibrance. Every property is optional and an omitted property leaves the clip unchanged.",
1191
+ "type": "object",
1192
+ "additionalProperties": false,
1193
+ "properties": {
1194
+ "type": {
1195
+ "description": "The filter type - set to `grade`.",
1196
+ "type": "string",
1197
+ "enum": [
1198
+ "grade"
1199
+ ]
1200
+ },
1201
+ "exposure": {
1202
+ "description": "Sets the exposure of the clip in stops. Use a number or an array of [Tween](./#tocs_tween) objects to change it over time.",
1203
+ "oneOf": [
1204
+ {
1205
+ "type": "number",
1206
+ "description": "The exposure change from -4 to 4 stops. Each stop doubles or halves the brightness. 0 leaves the clip unchanged (default).",
1207
+ "minimum": -4,
1208
+ "maximum": 4,
1209
+ "examples": [
1210
+ 0.5
1211
+ ]
1212
+ },
1213
+ {
1214
+ "type": "array",
1215
+ "description": "An array of [Tween](./#tocs_tween) objects that change the exposure over time.",
1216
+ "items": {
1217
+ "$ref": "#/$defs/Tween"
1218
+ }
1219
+ }
1220
+ ]
1221
+ },
1222
+ "temperature": {
1223
+ "description": "Sets the white balance of the clip. Use a number or an array of [Tween](./#tocs_tween) objects to change it over time.",
1224
+ "oneOf": [
1225
+ {
1226
+ "type": "number",
1227
+ "description": "The temperature shift from -1 to 1. Positive values warm the clip, negative values cool it and 0 leaves it unchanged (default).",
1228
+ "minimum": -1,
1229
+ "maximum": 1,
1230
+ "examples": [
1231
+ 0.3
1232
+ ]
1233
+ },
1234
+ {
1235
+ "type": "array",
1236
+ "description": "An array of [Tween](./#tocs_tween) objects that change the temperature over time.",
1237
+ "items": {
1238
+ "$ref": "#/$defs/Tween"
1239
+ }
1240
+ }
1241
+ ]
1242
+ },
1243
+ "tint": {
1244
+ "description": "Sets the tint of the clip between green and magenta. Use a number or an array of [Tween](./#tocs_tween) objects to change it over time.",
1245
+ "oneOf": [
1246
+ {
1247
+ "type": "number",
1248
+ "description": "The tint shift from -1 to 1. Positive values shift the clip toward magenta, negative values toward green and 0 leaves it unchanged (default).",
1249
+ "minimum": -1,
1250
+ "maximum": 1,
1251
+ "examples": [
1252
+ 0.2
1253
+ ]
1254
+ },
1255
+ {
1256
+ "type": "array",
1257
+ "description": "An array of [Tween](./#tocs_tween) objects that change the tint over time.",
1258
+ "items": {
1259
+ "$ref": "#/$defs/Tween"
1260
+ }
1261
+ }
1262
+ ]
1263
+ },
1264
+ "highlights": {
1265
+ "description": "Adjusts the brightest areas of the clip. Use a number or an array of [Tween](./#tocs_tween) objects to change it over time.",
1266
+ "oneOf": [
1267
+ {
1268
+ "type": "number",
1269
+ "description": "The highlights adjustment from -1 to 1. Positive values brighten the bright areas, negative values darken them and 0 leaves the clip unchanged (default).",
1270
+ "minimum": -1,
1271
+ "maximum": 1,
1272
+ "examples": [
1273
+ -0.3
1274
+ ]
1275
+ },
1276
+ {
1277
+ "type": "array",
1278
+ "description": "An array of [Tween](./#tocs_tween) objects that change the highlights adjustment over time.",
1279
+ "items": {
1280
+ "$ref": "#/$defs/Tween"
1281
+ }
1282
+ }
1283
+ ]
1284
+ },
1285
+ "shadows": {
1286
+ "description": "Adjusts the darkest areas of the clip. Use a number or an array of [Tween](./#tocs_tween) objects to change it over time.",
1287
+ "oneOf": [
1288
+ {
1289
+ "type": "number",
1290
+ "description": "The shadows adjustment from -1 to 1. Positive values lift the dark areas, negative values deepen them and 0 leaves the clip unchanged (default).",
1291
+ "minimum": -1,
1292
+ "maximum": 1,
1293
+ "examples": [
1294
+ 0.3
1295
+ ]
1296
+ },
1297
+ {
1298
+ "type": "array",
1299
+ "description": "An array of [Tween](./#tocs_tween) objects that change the shadows adjustment over time.",
1300
+ "items": {
1301
+ "$ref": "#/$defs/Tween"
1302
+ }
1303
+ }
1304
+ ]
1305
+ },
1306
+ "vibrance": {
1307
+ "description": "Adjusts the saturation of the clip, with a stronger effect on muted colors than on colors that are already vivid. Use a number or an array of [Tween](./#tocs_tween) objects to change it over time.",
1308
+ "oneOf": [
1309
+ {
1310
+ "type": "number",
1311
+ "description": "The vibrance adjustment from -1 to 1. Positive values strengthen color, mostly in muted tones, negative values mute color and 0 leaves the clip unchanged (default).",
1312
+ "minimum": -1,
1313
+ "maximum": 1,
1314
+ "examples": [
1315
+ 0.3
1316
+ ]
1317
+ },
1318
+ {
1319
+ "type": "array",
1320
+ "description": "An array of [Tween](./#tocs_tween) objects that change the vibrance over time.",
1321
+ "items": {
1322
+ "$ref": "#/$defs/Tween"
1323
+ }
1324
+ }
1325
+ ]
1326
+ }
1327
+ },
1328
+ "required": [
1329
+ "type"
1330
+ ]
1331
+ },
990
1332
  "Html5Asset": {
991
1333
  "description": "The Html5Asset renders full HTML5/CSS3/JS.",
992
1334
  "type": "object",
@@ -1097,6 +1439,42 @@
1097
1439
  "html"
1098
1440
  ]
1099
1441
  },
1442
+ "HueFilter": {
1443
+ "description": "Rotates the hues of the clip around the color wheel.",
1444
+ "type": "object",
1445
+ "additionalProperties": false,
1446
+ "properties": {
1447
+ "type": {
1448
+ "description": "The filter type - set to `hue`.",
1449
+ "type": "string",
1450
+ "enum": [
1451
+ "hue"
1452
+ ]
1453
+ },
1454
+ "value": {
1455
+ "description": "Sets the hue rotation of the clip in degrees. Use a number or an array of [Tween](./#tocs_tween) objects to change it over time.",
1456
+ "oneOf": [
1457
+ {
1458
+ "type": "number",
1459
+ "description": "The rotation in degrees. 0 leaves the clip unchanged (default) and 360 is a full turn back to the original hues.",
1460
+ "examples": [
1461
+ 90
1462
+ ]
1463
+ },
1464
+ {
1465
+ "type": "array",
1466
+ "description": "An array of [Tween](./#tocs_tween) objects that change the hue rotation over time.",
1467
+ "items": {
1468
+ "$ref": "#/$defs/Tween"
1469
+ }
1470
+ }
1471
+ ]
1472
+ }
1473
+ },
1474
+ "required": [
1475
+ "type"
1476
+ ]
1477
+ },
1100
1478
  "ImageAsset": {
1101
1479
  "description": "The ImageAsset adds an image to a Clip. The image can be sourced from a URL\n(`src`), generated from a text prompt (`prompt`), or both. At least one of\n`src` or `prompt` must be provided.\n\n- **Source URL:** set `src` to the publicly accessible URL of a jpg or png file.\n- **Generated:** set `prompt` to describe the image. Choose a generator with\n `model` and configure it with model-specific `options`; the engine fills\n `src` in automatically.\n- **Both:** `src` acts as a preview placeholder while `prompt` drives\n generation — the image is regenerated from the prompt at render time.\n Unchanged prompts and options resolve from the generation cache.",
1102
1480
  "type": "object",
@@ -1317,6 +1695,23 @@
1317
1695
  },
1318
1696
  "type": "object"
1319
1697
  },
1698
+ "NegativeFilter": {
1699
+ "description": "Inverts the clip, turning light areas dark and dark areas light. It has no properties other than `type` and cannot be animated.",
1700
+ "type": "object",
1701
+ "additionalProperties": false,
1702
+ "properties": {
1703
+ "type": {
1704
+ "description": "The filter type - set to `negative`.",
1705
+ "type": "string",
1706
+ "enum": [
1707
+ "negative"
1708
+ ]
1709
+ }
1710
+ },
1711
+ "required": [
1712
+ "type"
1713
+ ]
1714
+ },
1320
1715
  "Offset": {
1321
1716
  "description": "Offsets the position of an asset horizontally or vertically by a relative distance.",
1322
1717
  "properties": {
@@ -1501,6 +1896,44 @@
1501
1896
  ],
1502
1897
  "type": "object"
1503
1898
  },
1899
+ "PixelateFilter": {
1900
+ "description": "Turns the clip into blocky pixels.",
1901
+ "type": "object",
1902
+ "additionalProperties": false,
1903
+ "properties": {
1904
+ "type": {
1905
+ "description": "The filter type - set to `pixelate`.",
1906
+ "type": "string",
1907
+ "enum": [
1908
+ "pixelate"
1909
+ ]
1910
+ },
1911
+ "value": {
1912
+ "description": "Sets the strength of the pixelation. Use a number or an array of [Tween](./#tocs_tween) objects to change it over time.",
1913
+ "oneOf": [
1914
+ {
1915
+ "type": "number",
1916
+ "description": "The pixelation strength from 0 to 1. 0 leaves the clip unchanged (default).",
1917
+ "minimum": 0,
1918
+ "maximum": 1,
1919
+ "examples": [
1920
+ 0.5
1921
+ ]
1922
+ },
1923
+ {
1924
+ "type": "array",
1925
+ "description": "An array of [Tween](./#tocs_tween) objects that change the pixelation strength over time.",
1926
+ "items": {
1927
+ "$ref": "#/$defs/Tween"
1928
+ }
1929
+ }
1930
+ ]
1931
+ }
1932
+ },
1933
+ "required": [
1934
+ "type"
1935
+ ]
1936
+ },
1504
1937
  "Poster": {
1505
1938
  "description": "Generate a poster image for the video at a specific point from the timeline. The poster image size will match the size of the output video.",
1506
1939
  "properties": {
@@ -1541,6 +1974,65 @@
1541
1974
  "additionalProperties": false,
1542
1975
  "type": "object"
1543
1976
  },
1977
+ "RgbSplitFilter": {
1978
+ "description": "Offsets the red and blue channels in opposite directions to create a color fringing effect.",
1979
+ "type": "object",
1980
+ "additionalProperties": false,
1981
+ "properties": {
1982
+ "type": {
1983
+ "description": "The filter type - set to `rgbSplit`.",
1984
+ "type": "string",
1985
+ "enum": [
1986
+ "rgbSplit"
1987
+ ]
1988
+ },
1989
+ "x": {
1990
+ "description": "Sets the horizontal offset of the red and blue channels as a fraction of the clip's frame. Use a number or an array of [Tween](./#tocs_tween) objects to change it over time.",
1991
+ "oneOf": [
1992
+ {
1993
+ "type": "number",
1994
+ "description": "The horizontal offset from -1 to 1. Red moves right by this fraction and blue moves left by the same amount. Negative values reverse the direction and 0 applies no offset (default).",
1995
+ "minimum": -1,
1996
+ "maximum": 1,
1997
+ "examples": [
1998
+ 0.02
1999
+ ]
2000
+ },
2001
+ {
2002
+ "type": "array",
2003
+ "description": "An array of [Tween](./#tocs_tween) objects that change the horizontal offset over time.",
2004
+ "items": {
2005
+ "$ref": "#/$defs/Tween"
2006
+ }
2007
+ }
2008
+ ]
2009
+ },
2010
+ "y": {
2011
+ "description": "Sets the vertical offset of the red and blue channels as a fraction of the clip's frame. Use a number or an array of [Tween](./#tocs_tween) objects to change it over time.",
2012
+ "oneOf": [
2013
+ {
2014
+ "type": "number",
2015
+ "description": "The vertical offset from -1 to 1. Red moves up by this fraction and blue moves down by the same amount. Negative values reverse the direction and 0 applies no offset (default).",
2016
+ "minimum": -1,
2017
+ "maximum": 1,
2018
+ "examples": [
2019
+ 0.02
2020
+ ]
2021
+ },
2022
+ {
2023
+ "type": "array",
2024
+ "description": "An array of [Tween](./#tocs_tween) objects that change the vertical offset over time.",
2025
+ "items": {
2026
+ "$ref": "#/$defs/Tween"
2027
+ }
2028
+ }
2029
+ ]
2030
+ }
2031
+ },
2032
+ "required": [
2033
+ "type"
2034
+ ]
2035
+ },
1544
2036
  "RichCaptionActive": {
1545
2037
  "description": "Styling properties for the active/highlighted word.",
1546
2038
  "type": "object",
@@ -2577,6 +3069,44 @@
2577
3069
  ],
2578
3070
  "type": "object"
2579
3071
  },
3072
+ "SaturationFilter": {
3073
+ "description": "Increases or decreases the intensity of the colors in the clip.",
3074
+ "type": "object",
3075
+ "additionalProperties": false,
3076
+ "properties": {
3077
+ "type": {
3078
+ "description": "The filter type - set to `saturation`.",
3079
+ "type": "string",
3080
+ "enum": [
3081
+ "saturation"
3082
+ ]
3083
+ },
3084
+ "value": {
3085
+ "description": "Sets the saturation of the clip. Use a number or an array of [Tween](./#tocs_tween) objects to change it over time.",
3086
+ "oneOf": [
3087
+ {
3088
+ "type": "number",
3089
+ "description": "The saturation multiplier from 0 to 4. 1 leaves the clip unchanged (default), higher values make colors more vivid and 0 produces greyscale.",
3090
+ "minimum": 0,
3091
+ "maximum": 4,
3092
+ "examples": [
3093
+ 1.5
3094
+ ]
3095
+ },
3096
+ {
3097
+ "type": "array",
3098
+ "description": "An array of [Tween](./#tocs_tween) objects that change the saturation over time.",
3099
+ "items": {
3100
+ "$ref": "#/$defs/Tween"
3101
+ }
3102
+ }
3103
+ ]
3104
+ }
3105
+ },
3106
+ "required": [
3107
+ "type"
3108
+ ]
3109
+ },
2580
3110
  "ShapeAsset": {
2581
3111
  "description": "The ShapeAsset is used to add shapes to a video. The shape can be styled with a fill and a stroke.\nYou can manipulate properties such as rotation to create dynamic effects like a diamond shape or stripes.",
2582
3112
  "type": "object",
@@ -2735,6 +3265,65 @@
2735
3265
  "shape"
2736
3266
  ]
2737
3267
  },
3268
+ "SharpenFilter": {
3269
+ "description": "Sharpens the clip.",
3270
+ "type": "object",
3271
+ "additionalProperties": false,
3272
+ "properties": {
3273
+ "type": {
3274
+ "description": "The filter type - set to `sharpen`.",
3275
+ "type": "string",
3276
+ "enum": [
3277
+ "sharpen"
3278
+ ]
3279
+ },
3280
+ "value": {
3281
+ "description": "Sets the amount of sharpening. Use a number or an array of [Tween](./#tocs_tween) objects to change it over time.",
3282
+ "oneOf": [
3283
+ {
3284
+ "type": "number",
3285
+ "description": "The sharpening amount from 0 to 40. 0 applies no sharpening (default).",
3286
+ "minimum": 0,
3287
+ "maximum": 40,
3288
+ "examples": [
3289
+ 5
3290
+ ]
3291
+ },
3292
+ {
3293
+ "type": "array",
3294
+ "description": "An array of [Tween](./#tocs_tween) objects that change the sharpening amount over time.",
3295
+ "items": {
3296
+ "$ref": "#/$defs/Tween"
3297
+ }
3298
+ }
3299
+ ]
3300
+ },
3301
+ "radius": {
3302
+ "description": "Sets the sharpening radius in pixels for a 720p frame. It scales with the frame height. Use a number or an array of [Tween](./#tocs_tween) objects to change it over time.",
3303
+ "oneOf": [
3304
+ {
3305
+ "type": "number",
3306
+ "description": "The sharpening radius from 0 to 10. Defaults to 3.",
3307
+ "minimum": 0,
3308
+ "maximum": 10,
3309
+ "examples": [
3310
+ 3
3311
+ ]
3312
+ },
3313
+ {
3314
+ "type": "array",
3315
+ "description": "An array of [Tween](./#tocs_tween) objects that change the sharpening radius over time.",
3316
+ "items": {
3317
+ "$ref": "#/$defs/Tween"
3318
+ }
3319
+ }
3320
+ ]
3321
+ }
3322
+ },
3323
+ "required": [
3324
+ "type"
3325
+ ]
3326
+ },
2738
3327
  "ShotstackDestination": {
2739
3328
  "description": "Send videos and assets to the [Shotstack hosting and CDN](https://shotstack.io/docs/guide/serving-assets/destinations/shotstack/) service. This destination is enabled by default.",
2740
3329
  "properties": {
@@ -2747,7 +3336,7 @@
2747
3336
  ]
2748
3337
  },
2749
3338
  "exclude": {
2750
- "description": "Set to `true` to [opt-out](https://shotstack.io/docs/guide/serving-assets/self-host/) from the Shotstack hosting and CDN service. All files must be downloaded within 24 hours of rendering.",
3339
+ "description": "Set to `true` to [opt-out](https://shotstack.io/docs/guide/serving-assets/self-host/) from the Shotstack hosting and CDN service. By default files are hosted and stay until you delete them. If you opt out, the file is not hosted and must be downloaded from the render status `url` within 24 hours of rendering.",
2751
3340
  "type": "boolean",
2752
3341
  "examples": [
2753
3342
  false