> ## 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.

# HappyHorse Video Edit

> Edit existing HappyHorse videos with optional reference images for style guidance

Edit an existing video using HappyHorse Video Edit. Supports reference images for style guidance. This is a separate model from the HappyHorse generation models (`alibaba/happyhorse-1.0-video`, `alibaba/happyhorse-1.1-video`).

## Model

```
alibaba/happyhorse-1.0-video-edit
```

## Parameters

| Parameter              | Type      | Required | Default   | Description                                                                                                                                        |
| ---------------------- | --------- | -------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `prompt`               | string    | Yes      | —         | Text prompt describing the intended edit. Supports any language. Max 5,000 non-Chinese characters or 2,500 Chinese characters; excess is truncated |
| `video_url`            | string    | Yes      | —         | URL of the source video to edit                                                                                                                    |
| `reference_image_urls` | string\[] | No       | `null`    | Reference image URLs for style guidance (max 5)                                                                                                    |
| `audio_setting`        | string    | No       | `"auto"`  | Audio handling mode: `"auto"` (model decides) or `"origin"` (keep original audio)                                                                  |
| `resolution`           | string    | No       | `"1080P"` | `"720P"` or `"1080P"`                                                                                                                              |
| `watermark`            | boolean   | No       | `false`   | Add watermark to the output                                                                                                                        |
| `seed`                 | integer   | No       | `null`    | Random seed for reproducible generation (0-2147483647)                                                                                             |

## Example - Basic Video Edit

```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": "alibaba/happyhorse-1.0-video-edit",
    "input": {
      "prompt": "Convert the scene to a watercolor painting style",
      "video_url": "https://example.com/scene.mp4",
      "resolution": "1080P"
    }
  }'
```

## Example - With Reference Images

```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": "alibaba/happyhorse-1.0-video-edit",
    "input": {
      "prompt": "Apply the visual style from the reference image to the entire video",
      "video_url": "https://example.com/clip.mp4",
      "reference_image_urls": ["https://example.com/style.png"],
      "audio_setting": "origin"
    }
  }'
```

## Response

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