VizardVideo to clipsAvailable now

clip_v1

Name: clip_v1
Brand: Vizard

clip_v1 is a video to clips tool from Vizard that runs in the background and returns video and structured JSON. One API key runs it alongside every other tool.

Try itPriced by usage

Pricing

$0.032526 per minute of source video, rounded down, minimum 1 minute. clipModel clip_v2 costs $0.040658 per minute. The final charge comes from usage.

Limits

Runs: In the background
Returns: video, json
Longest queue wait: 3600s
Run deadline: 1800s
Largest inline input: 1024 KB
Largest input file: 10240 MB
Largest output: 4768 MB
Outputs per run: 200

Input

Field	Kind	Default	Description
`lang` required	text	—	The `lang` parameter tells Vizard what spoken language is used in your submitted video. For supported language codes, please refer to https://vizard.readme.io/docs/supported-languages#/
`videoUrl` required	URL or file	—	URL of your video source.
`videoType` required	number (whole)	—	The source of a video. Value can be: - `1`: Remote video file - `2`: YouTube - `3`: Google Drive - `4`: Vimeo - `5`: StreamYard - `6`: TikTok - `7`: Twitter(X) - `9`: Twitch - `10`: Loom - `11`: Facebook - `12`: LinkedIn - `13`: Dropbox - `14`: Instagram
`preferLength` required	list	—	The parameter preferLength controls how long each output video will be. Value can be: - `0`: Automatically chosen - `1`: Less than 30 seconds - `2`: 30 to 60 seconds - `3`: 60 to 90 seconds - `4`: 90 seconds to 3 minutes
`ext`	text	—	Video file extension. Supported video file extensions are: mp4, 3gp, avi, and mov. This parameter is required only when `videoType` is set to 1.
`keywords`	text	—	Use the `keywords` parameter to include content related to specific topics in your clips.
`templateId`	number (whole)	—	The `templateId` parameter allows you to apply a custom template to the generated clips. https://docs.vizard.ai/docs/advanced#/apply-a-template
`emojiSwitch`	number (whole)	0	Use the `emojiSwitch` parameter to control whether auto emoji in subtitles is enabled or not.
`ratioOfClip`	number (whole)	1	The ratioOfClip parameter controls the output video shape for all generated clips. Value can be: - `1`(default): 9:16 (Vertical) - `2`: 1:1 (Square) - `3`: 4:5 (Portrait) - `4`: 16:9 (Horizontal)
`maxClipNumber`	number (whole)	—	Parameter maxClipNumber sets the maximum number of clips to return from a long video (range: 1 to 100). This does not control the exact number of clips—only the upper limit. If this parameter is not included in your request, all clips will be returned.
`headlineSwitch`	number (whole)	1	Use the `headlineSwitch` parameter to control whether an AI-generated headline (also called a hook) is added to your clip. Value can be: - `1`(default): show headline - `0`: no headline
`subtitleSwitch`	number (whole)	1	Use the `subtitleSwitch` parameter to control whether subtitles are displayed in the final clips. By default, this is set to 1, meaning subtitles are turned on. When set to 0, subtitles will be set to hidden.
`autoBrollSwitch`	number (whole)	0	Use the `autoBrollSwitch` parameter to control whether auto B-roll function is enabled or not.
`highlightSwitch`	number (whole)	0	Use the `highlightSwitch` parameter to control whether auto highlight keywords function is enabled or not.
`removeSilenceSwitch`	number (whole)	0	The `removeSilenceSwitch` parameter controls whether silent gaps and filler words (like “um”, “uh”) are removed from your final clips. Value can be: - `0`(default): disable remove silence - `1`: enable remove silence

Same request in code

curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "vizard",
    "model": "clip_v1",
    "input": {
      "lang": "<lang>",
      "videoUrl": "<videoUrl>",
      "videoType": 1,
      "preferLength": [
        "<preferLength>"
      ]
    }
  }'