> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.empiriolabs.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.empiriolabs.ai/_mcp/server.

# Sonilo Video Analysis

> Reads a video and writes a timed creative brief, with a prompt per scene for music and sound design, ready to drive a later generation.

![Sonilo Video Analysis](https://media.empiriolabs.ai/model-logos/sonilo-video-analysis.png)

[Sonilo](/providers/sonilo) · Video Generation

`POST /v1/chat/completions`

Reads a video and writes a timed creative brief, with a prompt per scene for music and sound design, ready to drive a later generation.

## At a glance

| Field               | Value                             |
| ------------------- | --------------------------------- |
| Model id            | `sonilo-video-analysis`           |
| Model release date  | -                                 |
| Input modalities    | Text, Video                       |
| Output modalities   | Text                              |
| Context window      | -                                 |
| Weight precision    | -                                 |
| Features            | video, multimodal, scene_analysis |
| Native inference    | No                                |
| New                 | Yes                               |
| Supported endpoints | `POST /v1/chat/completions`       |
| Alternate model ids | `sonilo/sonilo-video-analysis`    |

## Pricing

| Charge         | Spec       | Rate     |
| -------------- | ---------- | -------- |
| Video analysis | per second | \$0.0004 |

## Example request

```bash
curl https://api.empiriolabs.ai/v1/videos/generations \
  -H 'Authorization: Bearer $EMPIRIOLABS_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"model": "sonilo-video-analysis", "prompt": "sunrise over the ocean", "duration": 6}'
```

## Parameters

| Parameter      | Type   | Required | Default  | Description                                                                                                                            |
| -------------- | ------ | -------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| `mode`         | enum   | no       | `"both"` | Which brief to write: a music direction, a sound design direction, or both. All three cost the same. · Allowed: `both`, `music`, `sfx` |
| `prompt`       | string | no       | -        | Creative direction for the brief. Steers the music plan; the sound design plan follows the footage.                                    |
| `variants_num` | number | no       | `1`      | How many alternative creative briefs to write. Each variant is billed separately. · Range: 1 – 5                                       |
| `video_url`    | string | no       | -        | Source video to analyse, as a publicly reachable URL. Up to 300MB and 8 minutes.                                                       |

## Notes

**Output**

Returns a written creative brief as JSON, not generated media: a time-aligned segment plan with a prompt per segment, plus one overall prompt per requested variant. Use it to direct a later music or sound effects generation.

**Controls**

Supports source video, creative direction, a mode selecting the music brief, the sound design brief, or both, and 1 to 5 variants.

**Limits**

* Source video up to 300MB and 8 minutes
* In both mode the sound design prompt is authored once regardless of the variant count

**Billing**

* Charged per second of source video at the catalog rate, with a 10 second minimum
* Each variant is billed separately
* A request rejected before generation is not billed.

---

*Machine-readable schema:* `GET https://api.empiriolabs.ai/v1/models/sonilo-video-analysis`.