> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unifically.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Video

> Generate a short AI video for a segment of a Suno clip, with optional first and last frames. See parameters, pricing, response fields, and API examples.

Generate a 5 to 10 second AI video set to a segment of your song. Each request returns two videos. Pricing is per second of video and depends on the quality tier.

## Model

```
suno-ai/video-gen
```

## Parameters

| Parameter         | Type    | Required | Description                                                                                               |
| ----------------- | ------- | -------- | --------------------------------------------------------------------------------------------------------- |
| `clip_id`         | string  | Yes      | Clip whose audio drives the video                                                                         |
| `prompt`          | string  | Yes      | Description of the video                                                                                  |
| `quality`         | string  | No       | `basic` (default) or `advanced`                                                                           |
| `duration`        | integer | No       | Video length in seconds, `5` to `10`. Default: `10`                                                       |
| `clip_start_time` | number  | No       | Where in the song the segment starts, in seconds. Default: `0`. The segment ends `duration` seconds later |
| `aspect_ratio`    | string  | No       | Aspect ratio such as `1:1`. Default: `1:1`                                                                |
| `start_image_url` | string  | No       | First-frame image URL                                                                                     |
| `end_image_url`   | string  | No       | Last-frame image URL                                                                                      |
| `start_image_id`  | string  | No       | First frame from a [Cover Art](/models/audio/suno/cover-art) result                                       |
| `end_image_id`    | string  | No       | Last frame from a [Cover Art](/models/audio/suno/cover-art) result                                        |

Frames are optional. Give a start frame, an end frame, both, or neither. For each frame use either the URL or the ID form, not both. Prompts and frames go through content moderation; rejected requests fail with the moderation reasons in the task error.

## Example

```bash theme={null}
curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "suno-ai/video-gen",
    "input": {
      "clip_id": "1901ec96-72c6-4c26-8e56-91028ca6070d",
      "prompt": "slow dolly through a rain-soaked neon street",
      "quality": "basic",
      "duration": 10,
      "clip_start_time": 42,
      "start_image_url": "https://example.com/first-frame.jpg"
    }
  }'
```

## Response

```json theme={null}
{
  "code": 200,
  "success": true,
  "data": {
    "task_id": "abc123def456",
    "status": "processing"
  }
}
```

## Result

```json theme={null}
{
  "task_id": "abc123def456",
  "status": "completed",
  "videos": [
    { "id": "73235b76-…", "url": "https://…/video-1.mp4", "thumbnail_url": "https://…/video-1.jpeg" },
    { "id": "683befe3-…", "url": "https://…/video-2.mp4", "thumbnail_url": "https://…/video-2.jpeg" }
  ]
}
```

<Note>
  **Volume discounts** are available for almost all models. Reach out at [contact@unifically.com](mailto:contact@unifically.com) to discuss custom pricing.
</Note>