Spiral gives your agent every tool with one account. Browse the tools →

Gemini CLI · Video

How to Use Vizard AI Clip v1 in Gemini CLI

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.

Prompts to try with Vizard AI Clip v1 in Gemini CLI

Copy an example into Gemini CLI, or ask in your own words.

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.

Vizard AI Clip v1Gemini CLI
Try asking
  • 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 Gemini CLI

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

Use Spiral's MCP server

  1. Add the server

    Or add it to ~/.gemini/settings.json yourself:

    gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start gemini and run:

    /mcp auth spiral
  3. Check it

    In Gemini CLI, run /mcp. From your shell:

    gemini mcp list

Use the Spiral skill

  1. Send Gemini CLI 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.

    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.

    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: Gemini CLI finds Vizard AI Clip v1 on Spiral, shows the price and runs it.

Vizard AI Clip v1 providers and prices

Spiral runs Vizard AI Clip v1 through Vizard. Open a card for today's price, with every fee included.

VizardVideo

Settings you can ask for

Vizard AI Clip v1 works from your video URL. Ask Gemini CLI for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Video typea whole number

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

Template IDa whole number

The templateId parameter allows you to apply a custom template to the generated clips. https://docs.vizard.ai/docs/advanced#/apply-a-template

Emoji switcha whole number0

Use the emojiSwitch parameter to control whether auto emoji in subtitles is enabled or not.

Ratio of clipa whole number1

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)

Max clip numbera whole number

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.

Headline switcha whole number1

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

Subtitle switcha whole number1

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.

Auto broll switcha whole number0

Use the autoBrollSwitch parameter to control whether auto B-roll function is enabled or not.

Highlight switcha whole number0

Use the highlightSwitch parameter to control whether auto highlight keywords function is enabled or not.

Remove silence switcha whole number0

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

Every API field of Vizard · Long Video to Short Clips is on its tool page: open its card above.

What can you do with Vizard AI Clip v1 in Gemini CLI?

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.

Questions about Vizard AI Clip v1 in Gemini CLI

Can Gemini CLI use Vizard AI Clip v1?

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

How much does Vizard AI Clip v1 cost in Gemini CLI?

$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 Gemini CLI plan is separate.

Do I need a Vizard account to use Vizard AI Clip v1 in Gemini CLI?

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 Gemini CLI?

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

Does Gemini CLI wait while Vizard AI Clip v1 runs?

Vizard AI Clip v1 runs in the background. Gemini CLI 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.

Get started

Start using Vizard AI Clip v1 in Gemini CLI

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Gemini CLI:

Set up Gemini CLI

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options