# Video

> Skill `video` on Faro. 4 sub-skills.

Your agent can't run media tooling or render video itself; this edits existing clips and generates new ones from a prompt.

**Category:** Audio & Video  
**Tags:** video, transcode, concat, overlay, subtitles, text, watermark, logo, convert, audio, mp4, webm, gif, mp3  
**Use when:** You need a video, whether to find real stock footage, generate a new clip, or edit one you have.  
**Not for:** Pure audio work, transcription, reading text out of a video, or live streaming.  
**Returns:** file (video/mp4) — Returns a downloadable file, not base64. A stock-footage search may instead return candidate clips for the caller to choose from.

## How to run
Skills run through one gateway with your Faro token. Hand it an `intent` in plain language; Faro routes to the right sub-skill, runs it, and bills per call. Raw tools are internal plumbing and are not directly callable.

```
POST https://skill.askfaro.com/skills/video/run
Authorization: Bearer faro_<your_key>
Content-Type: application/json

{"intent":{"prompt":"Find free video clips of mountains"}}
```

Or from the CLI:

```bash
pip install askfaro-cli && askfaro auth login
askfaro run video "Find free video clips of mountains"
```

Full run reference: https://askfaro.com/llms/run.md — Agent recipe: https://askfaro.com/llms/skill.md

## Example requests

- Find free video clips of mountains
- Generate a low-cost 6-second 720p clip of waves crashing on a beach
- Convert this MP4 to WebM for use in a web player

## Sub-skills

### Find stock footage

Finds a real video clip matching a description.

**Cost:** 0.1 credits / search

**Use when:** You want authentic footage of a real, findable subject rather than a generated clip.

**Details:** https://askfaro.com/llms/skills/video/find.md

---

### Generate

Creates a new short video with audio from a text description.

**Cost:** ~500 credits / video (up to 6000) — A short economical clip is the usual case; a longer, higher-fidelity, or 4K render costs more.

**Use when:** The clip does not exist yet and must be made (bespoke, branded, a specific scene).

**Details:** https://askfaro.com/llms/skills/video/generate.md

---

### Edit

Trim, convert, resize, overlay a logo or text, or burn in subtitles. No AI.

**Cost:** ~30 credits / second of output (up to 300)

**Use when:** You want a mechanical change to a single video or its audio.

**Details:** https://askfaro.com/llms/skills/video/edit.md

---

### Compose

Joins several clips into one by concatenating them in order, optionally with an overlay.

**Cost:** ~60 credits / second of output (up to 600)

**Use when:** You want to stitch multiple clips into a single video.

**Details:** https://askfaro.com/llms/skills/video/compose.md

---

---
On the web: https://askfaro.com/search/video