[Integrations](https://spiral.ai/integrations) › [Cursor](https://spiral.ai/integrations/cursor) › [Vizard AI Clip v1](https://spiral.ai/integrations/cursor/vizard-ai-clip-v1)

# How to Use Vizard AI Clip v1 in Cursor

Vizard AI Clip v1 turns long recordings into short clips for review and social posts. Compared with Vizard AI Clip v2, it produces more candidates, making it useful when you want a wider selection to curate.

|  |  |
| --- | --- |
| Model | Vizard AI Clip v1 |
| Available through | Vizard |
| Category | Video |
| Price | $0.0325 per minute of source video, whole minutes, at least 1 minute ($0.0407 per minute with the v2 clip model). |
| Returns | video, json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Vizard AI Clip v1 in Cursor

- Use Vizard AI Clip v1 on the recorded release walkthrough linked in this project's README. Find passages explaining the migration changes, using the changelog to identify the topics, and list the candidates for review.
- Use Vizard AI Clip v1 on our recorded architecture talk. Find the explanation of why we chose a queue, then compare the selected excerpts with the architecture notes in this repository.
- Use Vizard AI Clip v1 on the onboarding recording referenced in our docs. Find passages explaining local development troubleshooting and flag any advice that conflicts with the current README.
- Use Vizard AI Clip v1 on our recorded feature demo. Use the release notes to identify the new search feature, then prepare candidate excerpts and a checklist of claims to verify.
- Use Vizard AI Clip v1 on the recorded developer Q&A linked in our documentation. Find answers about pagination and compare their terminology with the project's API reference.

## How to set up Vizard AI Clip v1 in Cursor

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the hosted server**: Use Add to Cursor on the console's Agents & MCP page, or add this to `.cursor/mcp.json` (one project) or `~/.cursor/mcp.json` (every project):

```json
{
  "mcpServers": {
    "spiral": { "url": "https://api.spiral.ai/mcp" }
  }
}
```

2. **Sign in**: Open Cursor Settings › MCP, click Connect next to spiral, sign in to Spiral and click Authorize. No API key. Spiral then shows as connected, with its tools listed.

### Use the Spiral skill

1. **Send Cursor this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Vizard AI Clip v1**: One request; the result comes back by polling or a webhook.

```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
      ]
    }
  }'
```

Then paste one of the prompts above: Cursor finds Vizard AI Clip v1 on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/cursor

## Vizard AI Clip v1 tools and prices

- [Vizard · Long Video to Short Clips](https://spiral.ai/tools/vizard/clip_v1) (Vizard): $0.0325 per minute of source video, whole minutes, at least 1 minute ($0.0407 per minute with the v2 clip model).

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| ext |  | — | 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 |  | — | Use the `keywords` parameter to include content related to specific topics in your clips. |
| templateId |  | — | The `templateId` parameter allows you to apply a custom template to the generated clips. https://docs.vizard.ai/docs/advanced#/apply-a-template |
| emojiSwitch |  | 0 | Use the `emojiSwitch` parameter to control whether auto emoji in subtitles is enabled or not. |
| ratioOfClip |  | 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 |  | — | 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. |

## What can you do with Vizard AI Clip v1 in Cursor?

Turn recorded project walkthroughs and technical talks into candidate excerpts for documentation and release posts. A coding agent can use project files to identify relevant topics and help review the selections.

### Podcast excerpts

Use Vizard AI Clip v1 to find discussion excerpts from a recorded video podcast. Review the candidates for an opening that makes sense without the full episode.

### Webinar questions and answers

Use Vizard AI Clip v1 to select answers about a specific topic from a recorded webinar. Keep enough context for viewers to understand the question.

### Tutorial excerpts

Use Vizard AI Clip v1 to find a spoken explanation of one task in a longer tutorial. Check that the excerpt includes the steps needed to follow it.

### Conference talk highlights

Use Vizard AI Clip v1 to pull candidate excerpts from a recorded presentation. Focus the request on a concrete lesson, example, or argument.

### Coaching lessons

Use Vizard AI Clip v1 to extract practical advice from a recorded coaching session. Select excerpts that explain both the recommendation and its reason.

### Customer interview excerpts

Use Vizard AI Clip v1 to find passages where a customer describes a problem or outcome. Review each excerpt against the original conversation before sharing.

## Overview

- [Vizard](https://spiral.ai/providers/vizard)
- [All Cursor guides](https://spiral.ai/integrations/cursor)

## Vizard AI Clip v1 in other agents

- [Amp](https://spiral.ai/integrations/amp/vizard-ai-clip-v1)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/vizard-ai-clip-v1)
- [Claude](https://spiral.ai/integrations/claude-desktop/vizard-ai-clip-v1)
- [Claude Code](https://spiral.ai/integrations/claude-code/vizard-ai-clip-v1)
- [Cline](https://spiral.ai/integrations/cline/vizard-ai-clip-v1)
- [Codex](https://spiral.ai/integrations/codex/vizard-ai-clip-v1)
- [Devin](https://spiral.ai/integrations/devin/vizard-ai-clip-v1)
- [dots](https://spiral.ai/integrations/dots/vizard-ai-clip-v1)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/vizard-ai-clip-v1)
- [Gemini](https://spiral.ai/integrations/gemini/vizard-ai-clip-v1)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/vizard-ai-clip-v1)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/vizard-ai-clip-v1)
- [goose](https://spiral.ai/integrations/goose/vizard-ai-clip-v1)
- [Grok](https://spiral.ai/integrations/grok/vizard-ai-clip-v1)
- [Grok Build](https://spiral.ai/integrations/grok-build/vizard-ai-clip-v1)
- [Hermes](https://spiral.ai/integrations/hermes/vizard-ai-clip-v1)
- [Instinct](https://spiral.ai/integrations/instinct/vizard-ai-clip-v1)
- [Manus](https://spiral.ai/integrations/manus/vizard-ai-clip-v1)
- [Muse](https://spiral.ai/integrations/muse/vizard-ai-clip-v1)
- [Muse Code](https://spiral.ai/integrations/muse-code/vizard-ai-clip-v1)
- [n8n](https://spiral.ai/integrations/n8n/vizard-ai-clip-v1)
- [Notion](https://spiral.ai/integrations/notion/vizard-ai-clip-v1)
- [OpenClaw](https://spiral.ai/integrations/openclaw/vizard-ai-clip-v1)
- [opencode](https://spiral.ai/integrations/opencode/vizard-ai-clip-v1)
- [Perplexity](https://spiral.ai/integrations/perplexity/vizard-ai-clip-v1)
- [Raycast](https://spiral.ai/integrations/raycast/vizard-ai-clip-v1)
- [VS Code](https://spiral.ai/integrations/vscode/vizard-ai-clip-v1)
- [Windsurf](https://spiral.ai/integrations/windsurf/vizard-ai-clip-v1)
- [Zapier](https://spiral.ai/integrations/zapier/vizard-ai-clip-v1)

## More Cursor guides

- [Vidu Template to Video](https://spiral.ai/integrations/cursor/vidu-template-to-video)
- [Wan 2.2 5B Image to Video](https://spiral.ai/integrations/cursor/wan-2-2-5b-image-to-video)
- [Vidu Start-End to Video](https://spiral.ai/integrations/cursor/vidu-start-end-to-video)
- [Wan 2.2 5B Text to Video](https://spiral.ai/integrations/cursor/wan-2-2-5b-text-to-video)
- [Vidu Reference to Video](https://spiral.ai/integrations/cursor/vidu-reference-to-video)
- [Wan 2.2 A14B Image to Video](https://spiral.ai/integrations/cursor/wan-2-2-a14b-image-to-video)

## Questions about Vizard AI Clip v1 in Cursor

**Can Cursor use Vizard AI Clip v1?**

Yes. Add Spiral to Cursor as an MCP server, and Cursor can find and run Vizard AI Clip v1 like any built-in tool.

**How much does Vizard AI Clip v1 cost in Cursor?**

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

**Do I need a Vizard account to use Vizard AI Clip v1 in Cursor?**

No. Spiral runs Vizard AI Clip v1 on its own Vizard account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Vizard AI Clip v1 in Cursor?**

About two minutes: add the hosted server, then sign in.

**Does Cursor wait while Vizard AI Clip v1 runs?**

Vizard AI Clip v1 runs in the background. Cursor starts the run, checks on it and gives you the video, json when it's ready.

**What recordings are a good starting point for Vizard AI Clip?**

Start with recordings that contain clear spoken dialogue. Background music and poor audio can affect transcription, so check the captions before publishing.

**How long can the source video be?**

Vizard's API documentation specifies a minimum of one minute and a maximum of 600 minutes. The documented file size limit is 10GB.

**Can Vizard AI Clip make longer excerpts?**

Yes. Vizard documents clips of one to three minutes for commentary, tutorials, and thought leadership, where a short excerpt may omit useful context.

**Why did my topic request return no clips?**

Vizard restricts selection to content that matches your topic instruction. If nothing matches closely enough, it can return no clips; try a broader topic that you know the recording covers.

**Does Vizard AI Clip support languages besides English?**

Vizard documents transcription support for languages including Filipino, Finnish, French, and German. Check captions against the recording, especially when the audio is unclear.

