# Subject Reference

## Subject Reference Guide

The **Subject Reference** (SR) tab lets you animate a specific person or object using your own reference images. Upload your subject once, then direct it in video.

<figure><img src="https://3680982064-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuiK0IF5fmLR21RxDf6I9%2Fuploads%2FEekribPE5yraGXITeKoJ%2Fexported_image%20(13).png?alt=media&#x26;token=640f817e-8d29-48d7-9606-dff69b1fdbd1" alt=""><figcaption><p>Subject Reference Tab</p></figcaption></figure>

***

### 1. Mode Selector

At the top, pick your generation mode:

* **T2V** (Text → Video)
* **I2V** (Image → Video)
* **SR** (Subject Reference)
* **EXT** (Extend Clip)
* **F-L** (First Frame → Last Frame)

> **Tip:** Select **SR** to bring your reference images to life.

***

### 2. Add Reference Image

1. Click **Select or Upload Image** or drag-and-drop into the box.
2. Upload 1–5 images of your subject (different angles help!).
3. Your images appear as thumbnails—Boba.Video uses them to learn your subject’s appearance.

***

### 3. Settings Panel

Leave defaults or tweak as needed:

| Setting              | Description                                                                                                                             |
| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| **Model**            | Choose your SR-capable video engine (Hailuo Base only)                                                                                  |
| **Number of Videos** | Generate 1–5 clips of your subject in one batch. (Default = 1)                                                                          |
| **Generate Sound**   | Toggle on to auto-add sound effects (5 extra credits)                                                                                   |
| **Aspect Ratio**     | <p>Select framing:<br>• <strong>16:9</strong> (widescreen)<br>• <strong>9:16</strong> (vertical)<br>• <strong>1:1</strong> (square)</p> |

***

### 4. Prompt Box

Tell Boba.Video what your subject should do:

1. **Type your direction** (e.g. “Smile, then turn to the left and wave”).
2. **Optimized Tag** appears if prompt optimization is active.
3. **Credit Counter** shows the cost for this animation.
4. **Send (↑) Button** starts the SR generation.
5. **Clear (🗑️) Icon** resets your instructions.

***

### 5. Monitoring Your Job

After sending, check the **Generation Feed**:

* **Progress Bar & Percentage**
* **Mode Tag & Model Name**
* **Timestamp**

Hover for a quick preview or click to view full-screen.

***

### 6. Post-Processing Controls

Hover over your completed clip to access:

* **Add to Library**: Save the animated clip to Assets
* **Download**: Export the video to your device
* **Upscale**: Increase resolution (2K → 4K) with credits
* **Smooth Motion**: Apply frame interpolation for fluid movement
* **Delete**: Remove the generation (with confirmation)

***

With **Subject Reference**, you can create personalized animations of any person or object—just upload your reference images and direct the action!
