Vizard · Long Video to Short Clips
clip_v1Edit 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.
Pricing
$0.0325 per minute of source video, whole minutes, at least 1 minute ($0.0407 per minute with the v2 clip model).
Limits
- Runs
- In the background
- Returns
- video, json
- 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 | Default | Description |
|---|---|---|---|
lang required | text | — | The |
videoUrl required | URL or file | — | URL of your video source. |
videoType required | number (whole) | — | The source of a video. Value can be: - |
preferLength required | list | — | The parameter preferLength controls how long each output video will be. Value can be: - |
ext | text | — | Video file extension. Supported video file extensions are: mp4, 3gp, avi, and mov. This parameter is required only when |
keywords | text | — | Use the |
templateId | number (whole) | — | The |
emojiSwitch | number (whole) | 0 | Use the |
ratioOfClip | number (whole) | 1 | The ratioOfClip parameter controls the output video shape for all generated clips. Value can be: - |
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 |
subtitleSwitch | number (whole) | 1 | Use the |
autoBrollSwitch | number (whole) | 0 | Use the |
highlightSwitch | number (whole) | 0 | Use the |
removeSilenceSwitch | number (whole) | 0 | The |
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": [
1
]
}
}'Frequently asked questions
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.