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

# Wan 3.0 Prime

> Alibaba Wan · `wan-3.0-prime` · video

## Identifier

Use the model identifier `wan-3.0-prime` in the `model` field when calling [`/asset/start`](/api-reference/assets/start).

## Capabilities

| Property            | Value                                                                                                                                                                              |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Reference inputs    | 0–20                                                                                                                                                                               |
| Aspect ratios       | `16:9`, `4:3`, `1:1`, `3:4`, `9:16` (default `9:16`)                                                                                                                               |
| Resolutions         | `480p`, `720p`, `1080p` (default `1080p`)                                                                                                                                          |
| Durations (seconds) | `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `10`, `11`, `12`, `13`, `14`, `15`, `16`, `17`, `18`, `19`, `20`, `21`, `22`, `23`, `24`, `25`, `26`, `27`, `28`, `29`, `30` (default `5`) |
| Audio               | yes                                                                                                                                                                                |
| Max prompt length   | 20000 chars                                                                                                                                                                        |
| Tags                | `new`                                                                                                                                                                              |

## Inputs

Pass reference media in the `references` array (0–20 items). Optional. Each item accepts exactly one of:

* `url` — a direct, publicly accessible file URL
* `asset_id` — the ID of an existing asset in your Hoox space (e.g. a previous generation)
* `avatar_id` — the ID of an avatar defined in your Hoox space

## Custom settings

These keys go inside the `model_settings` object of the request body.

| Key                  | Type    | Default | Affects cost | Description                                                                                                                                                                                                                                         |
| -------------------- | ------- | ------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `generateAudio`      | boolean | `true`  | no           | Generate the native soundtrack (dialogue, ambience, effects) along with the video.                                                                                                                                                                  |
| `forceReferenceMode` | boolean | `false` | no           | Use the attached media as subject/style references instead of the video's first frame. Reference mode turns on by itself from 3 references, or as soon as a video or an audio is attached; set this to get it with fewer — one reference is enough. |

## Pricing

Default parameters (5s at `1080p`): **\~14 credits / generation**.

For exact pricing with your own parameters, call [`/asset/pricing`](/api-reference/assets/pricing) with the `model` and any parameters that affect cost.

## Example request

```json theme={null}
{
  "type": "video",
  "model": "wan-3.0-prime",
  "prompt": "Describe what you want to generate",
  "aspect_ratio": "9:16",
  "resolution": "1080p",
  "duration": 5
}
```

See [`/asset/start`](/api-reference/assets/start) for the full request/response reference, error codes, and code samples in cURL / Python / JavaScript.