# Vizard · Long Video to Short Clips

Edit and transform video with Vizard · Long Video to Short Clips through one Spiral API key. Cuts a long video from a file or a link such as YouTube into short vertical clips, with subtitles, hook headlines and no silences. It runs in the background and returns video and structured JSON. Pay as you go, with no subscription.

- Provider: Vizard
- Category: Video
- Runs: In the background
- Returns: video, json
- Tool id: `vizard` / `clip_v1`
- Page: https://spiral.ai/tools/vizard/clip_v1

## Pricing

$0.0325 per minute of source video, whole minutes, at least 1 minute ($0.0407 per minute with the v2 clip model).

## Limits

- Longest queue wait: 1 hour
- Run deadline: 30 minutes
- Longest run, end to end: 930 minutes
- Largest inline input: 1 MB
- Largest input file: 10 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | 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 |

## Example

```bash
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": [
        1
      ]
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=vizard&model=clip_v1

## Common questions

### Vizard · Long Video to Short Clips

**How much does Vizard · Long Video to Short Clips cost?**

$0.0325 per minute of source video, whole minutes, at least 1 minute ($0.0407 per minute with the v2 clip model). You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use Vizard · Long Video to Short Clips through an API?**

Send `POST /v1/runs` with `"provider": "vizard"`, `"model": "clip_v1"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with Vizard to use Vizard · Long Video to Short Clips?**

No. Spiral runs it on its own Vizard account and charges your Spiral balance.

**Can my AI agent use Vizard · Long Video to Short Clips?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

