# Wan VACE 14B · Depth API

> VACE 14B depth-guided video pagbuo na sumusunod sa istruktura ng source video

Nangangailangan ng `prompt` at source `video_url`, at bumubuo ng bagong video na ginagabayan ng depth structure ng source. Nagdaragdag ng mga reference ang opsyonal na `ref_image_urls` kasama ng first at last frame na larawan, at kinokontrol ng `transparency_mode` kung paano pupunan ang mga transparent na bahagi ng mga frame na iyon. Umaabot sa 241 ang `num_frames` at 240p hanggang 720p ang `resolution`.

- Model id: `wan-vace-14b/depth`
- Made by: Alibaba
- Category: Video to Video
- Output: video
- Price per second of your output video: from $0.04 / second of output video (cheapest run $0.04 (40 API credits))
- Run: `POST https://api.doitong.com/v1/run/wan-vace-14b/depth`
- Quote: `POST https://api.doitong.com/v1/quote/wan-vace-14b/depth`
- Docs page: https://doitong.com/fil/developers/models/wan-vace-14b/depth

## Pricing

Price: **from $0.04 / second of output video** (the lowest tier; the quote prices your exact input). Price per second of your output video: the input files are measured before the run (length, resolution, frame rate). The quote measures the same files and is exactly what the run charges.

Price by tier:

- 240p: $0.04 / second of output video
- 360p: $0.04 / second of output video
- 480p: $0.04 / second of output video
- 580p: $0.06 / second of output video
- auto: $0.08 / second of output video
- 720p: $0.08 / second of output video

The full example input below costs $0.405 = 405 API credits (5.0625 s output video × $0.08 (auto)).

Prices are the upstream price in USD, paid from the API balance in API credits (1000 API credits = 1 USD). `POST https://api.doitong.com/v1/quote/wan-vace-14b/depth` with the same JSON body returns the exact price for that input; the quote is exactly what a run charges. Invalid input is never charged and failed or canceled requests are refunded automatically.

## Input parameters

Send either the canonical name or the native field name (not both). Canonical names are the same across models.

| Parameter | Canonical name | Type | Required | Default | Allowed values / range | Description |
|---|---|---|---|---|---|---|
| `prompt` |  | string | yes |  |  | Mga text instruction na gumagabay sa pagbuo ng video. |
| `negative_prompt` |  | string | no | `letterboxing, borders, black bars, bright colors, overexposed, static, blurred details, subtitles, style, artwork, painting, picture, still, overall gray, worst quality, low quality, JPEG compression residue, ugly, incomplete, extra fingers, poorly drawn hands, poorly drawn faces, deformed, disfigured, malformed limbs, fused fingers, still picture, cluttered background, three legs, many people in the background, walking backwards` |  | Negative prompt na inilalapat sa pagbuo ng video. |
| `match_input_num_frames` |  | boolean | no | `false` |  | Pinagmulan ng bilang ng frame ng nabuong video: ginagamit ng false ang `num_frames`, habang kinokopya ng true ang bilang ng frame ng input video. |
| `num_frames` |  | integer | no | `81` | 17 – 241 | Bilang ng output frame, na may inclusive range na 81–241. |
| `match_input_frames_per_second` |  | boolean | no | `false` |  | Pinagmulan ng frame rate ng nabuong video: ginagamit ng false ang `frames_per_second`, habang kinokopya ng true ang frame rate ng input video. |
| `frames_per_second` |  | integer \| null | no | `16` | 5 – 30 | Frame rate ng nabuong video, inilalapat lamang kapag hindi true ang `match_input_frames_per_second`; tinatanggap na value ang 5–30 frames per segundo. |
| `seed` |  | integer \| null | no |  |  | Seed na ginagawang reproducible ang pagbuo. Ang pagtatakda nito sa None ay random na pumipili ng seed. |
| `resolution` |  | enum (string) | no | `auto` | `auto`, `240p`, `360p`, `480p`, `580p`, `720p` | Resolution ng output video. |
| `aspect_ratio` |  | enum (string) | no | `auto` | `auto`, `16:9`, `1:1`, `9:16` | Aspect ratio ng resultang video. |
| `num_inference_steps` |  | integer | no | `30` | 2 – 50 | Bilang ng sampling step, kung saan ipinagpapalit ang mas mahabang oras ng pagproseso para sa mas magandang kalidad habang tumataas ang bilang. |
| `guidance_scale` |  | number | no | `5` | 1 – 10 | Lakas ng prompt alignment na kinokontrol sa pamamagitan ng classifier-free guidance; hinihikayat ng pagtaas ng scale ang mga nabuong larawan na mas sumunod sa text. |
| `sampler` |  | enum (string) | no | `unipc` | `unipc`, `dpm++`, `euler` | Sampler na ginagamit sa pagbuo ng video. |
| `shift` |  | number | no | `5` | 1 – 15 | Setting ng shift na inilalapat sa pagbuo ng video. |
| `video_url` | `video` | string (video URL) | yes |  |  | URL ng source video file, kinakailangan kapag isinasagawa ang depth task. |
| `ref_image_urls` |  | array of image URL | no |  |  | Opsyonal na mga source-larawan URL na nagbibigay sa modelo ng mga reference larawan na gagamitin. |
| `first_frame_url` | `image` | string \| null | no |  |  | Opsyonal na first-frame reference na ibinigay sa pamamagitan ng URL para gamitin ng modelo sa pagproseso ng video. |
| `last_frame_url` | `end_image` | string \| null | no |  |  | Opsyonal na last-frame reference na ibinigay sa pamamagitan ng URL para gamitin ng modelo sa pagproseso ng video. |
| `enable_safety_checker` |  | boolean | no | `false` |  | Switch para sa safety checking na nangangailangan ng authorization ng account kapag naka-off. Kung walang authorization na iyon, sinusuri ang bawat kahilingan anuman ang setting; ino-on ng true ang checker. |
| `enable_prompt_expansion` |  | boolean | no | `false` |  | Kinokontrol kung naka-enable ang prompt expansion. |
| `preprocess` |  | boolean | no | `false` |  | Kinokontrol ang preprocessing ng input video. |
| `acceleration` |  | enum (string) \| null | no | `regular` | `none`, `low`, `regular` | Setting para sa acceleration ng inference, na may pagpipiliang 'none' o 'regular': nagbibigay ang accelerated processing ng malaking pagtaas sa bilis kapalit ng napakaliit na pagbabago sa output. |
| `video_quality` |  | enum (string) | no | `high` | `low`, `medium`, `high`, `maximum` | Antas ng kalidad para sa resultang video. |
| `video_write_mode` |  | enum (string) | no | `balanced` | `fast`, `balanced`, `small` | Write mode para sa resultang video. |
| `num_interpolated_frames` |  | integer | no | `0` | 0 – 5 | Bilang ng interpolation: iniiwan ng 0 na walang interpolation ang orihinal na frame; tinutukoy ng ibang value kung ilang intermediate frame ang bubuuin sa pagitan ng mga ito. |
| `temporal_downsample_factor` |  | integer | no | `0` | 0 – 5 | Factor ng frame-skipping ng video, ipinapahayag bilang integer, na may awtomatikong upsampling na inilalapat isang beses para sa bawat downsampling factor. Gamitin ang 0 upang panatilihing naka-disable ang temporal downsampling. |
| `enable_auto_downsample` |  | boolean | no | `false` |  | Awtomatikong adaptation ng bilang ng frame: kapag pinagana, pinoproseso ng modelo ang temporally downsampled na video na may angkop na haba, at ibinabalik ng interpolation pagkatapos ang orihinal na bilang ng frame. |
| `auto_downsample_min_fps` |  | number | no | `15` | 1 – 60 | Minimum na frame rate, sa frame per segundo, na pinapayagan pagkatapos ng downsampling. Para sa footage na kaunti ang galaw, nagbibigay ang pagbaba ng value na ito ng mas malaking downsampling at mas mahahabang sequence; maaaring mangailangan ng mas mataas na value ang napakabilis na galaw, bagama't ang default ay angkop sa karamihan ng video. Ginagamit ng awtomatikong downsampling ang threshold na ito upang hanapin ang pinakamababang factor na nagpapanatili ng detalye. |
| `interpolator_model` |  | enum (string) | no | `film` | `rife`, `film` | Pagpili ng frame interpolation modelo: alinman sa 'rife' o 'film'. |
| `transparency_mode` |  | enum (string) | no | `content_aware` | `content_aware`, `white`, `black` | Paghawak sa transparency para sa starting at ending frame, na tumutukoy kung paano pupunan ang mga transparent na rehiyon ng mga ito. |
| `return_frames_zip` |  | boolean | no | `false` |  | Kinokontrol kung ibabalik din ang ZIP archive na naglalaman ng bawat nabuong frame; pinapagana kapag true. |

File parameters (`video`, `ref_image_urls`) take a public `https://` URL, a `data:` URI up to 10 MB, or the `file_url` of an upload from `POST /files`.

## Example input

Required parameters only:

```json
{
  "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
  "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
}
```

A fuller example:

```json
{
  "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
  "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
}
```

## Run it

Set `DOITONG_API_KEY` to a key from https://doitong.com/developers/dashboard#keys. `?wait=20` returns the finished request in the same call when it is ready within 20 seconds; otherwise poll `GET /requests/{id}` (it also accepts `?wait=`), or pass `webhook_url`.

### curl

```bash
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/wan-vace-14b/depth?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"
```

### JavaScript

```javascript
const API = "https://api.doitong.com/v1";
const headers = {
  "Authorization": "Bearer " + process.env.DOITONG_API_KEY,
  "Content-Type": "application/json",
};

// Run the model; wait up to 20 s for the finished result in the same call
let res = await fetch(API + "/run/wan-vace-14b/depth?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }),
});
let request = await res.json();
if (!res.ok) throw new Error(request.error.code + ": " + request.error.message);

// Not finished yet: long-poll until it is
while (request.status === "queued" || request.status === "running") {
  res = await fetch(API + "/requests/" + request.id + "?wait=20", { headers });
  request = await res.json();
}
if (request.status !== "succeeded") throw new Error(JSON.stringify(request.error));
console.log(request.outputs.map((o) => o.url), request.cost.credits + " API credits ($" + request.cost.usd + ")");
```

### Python

```python
import os
import requests

API = "https://api.doitong.com/v1"
headers = {"Authorization": "Bearer " + os.environ["DOITONG_API_KEY"]}

payload = {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/wan-vace-14b/depth", params={"wait": 20}, json=payload, headers=headers)
request = r.json()
if not r.ok:
    raise RuntimeError(request["error"]["code"] + ": " + request["error"]["message"])

# Not finished yet: long-poll until it is
while request["status"] in ("queued", "running"):
    request = requests.get(API + "/requests/" + request["id"], params={"wait": 20}, headers=headers).json()
if request["status"] != "succeeded":
    raise RuntimeError(request["error"])
print([o["url"] for o in request["outputs"]], request["cost"]["credits"], "API credits", "$" + request["cost"]["usd"])
```

### MCP

The MCP server at `https://api.doitong.com/v1/mcp` exposes the tools `search_models`, `get_model`, `quote`, `run`, `get_request`, `cancel_request`, `list_requests`, `create_upload` and `get_account`. A `run` call for this model:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "run",
    "arguments": {
      "model_id": "wan-vace-14b/depth",
      "input": {
        "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
        "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
      },
      "wait_seconds": 20
    }
  }
}
```

## Response

Every call returns a request object. `status` is one of `queued`, `running`, `succeeded`, `failed`, `canceled`. `outputs` lists the generated files with URLs on our storage (kept forever, or 7 days with `?storage=temporary`; `storage` says which); `output` is the model's own result object with the same URLs.

```json
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "wan-vace-14b/depth",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 405,
    "usd": "0.405",
    "charged": 405,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "fps": 1.0,
      "duration": 5,
      "num_frames": 1
    },
    "prompt": "string",
    "seed": 42,
    "frames_zip": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
```

### Output fields (`output`)

| Field | Type | Description |
|---|---|---|
| `video` | object {url, content_type, file_name, file_size, width, height, fps, duration, num_frames} | Depth video file na ginawa ng modelo. |
| `prompt` | string | Prompt na ginamit sa pagbuo ng output. |
| `seed` | integer | Seed value na inilapat sa pagbuo. |
| `frames_zip` | object {url, content_type, file_name, file_size} \| null | ZIP archive na naglalaman ng bawat video frame, ibinabalik kapag hiniling. |

## Related models

- [Wan VACE 14B](https://doitong.com/developers/models/wan-vace-14b.md) (`wan-vace-14b`): from $0.04 / second of output video
- [Wan VACE 14B · Inpainting](https://doitong.com/developers/models/wan-vace-14b/inpainting.md) (`wan-vace-14b/inpainting`): from $0.04 / second of output video
- [Wan VACE 14B · Outpainting](https://doitong.com/developers/models/wan-vace-14b/outpainting.md) (`wan-vace-14b/outpainting`): from $0.04 / second of output video
- [Wan VACE 14B · Pose](https://doitong.com/developers/models/wan-vace-14b/pose.md) (`wan-vace-14b/pose`): from $0.04 / second of output video
- [Wan VACE 14B · Reframe](https://doitong.com/developers/models/wan-vace-14b/reframe.md) (`wan-vace-14b/reframe`): from $0.04 / second of output video
- [Happy Horse Video Edit](https://doitong.com/developers/models/alibaba/happy-horse/video-edit.md) (`alibaba/happy-horse/video-edit`): from $0.28 / second of input video
- [Wan 2.1 VACE Long Reframe](https://doitong.com/developers/models/wan-vace-apps/long-reframe.md) (`wan-vace-apps/long-reframe`): from $0.04 / 2 seconds of input video
- [Wan 2.2 VACE Fun A14B · Depth](https://doitong.com/developers/models/wan-22-vace-fun-a14b/depth.md) (`wan-22-vace-fun-a14b/depth`): from $0.05 / second of output video

## Links

- HTML page: https://doitong.com/developers/models/wan-vace-14b/depth
- All models and guides for AI agents: https://doitong.com/developers/llms.txt
- OpenAPI 3.1 with this model's typed request body: https://doitong.com/developers/openapi.json?model=wan-vace-14b/depth
- Errors: https://doitong.com/developers/docs/errors
- Model details as JSON: https://api.doitong.com/v1/models/wan-vace-14b/depth