# Wan VACE 14B · Reframe API

> Ailfframio fideo VACE 14B i gymhareb agwedd newydd, gyda chwyddo a thocio'r border; anogiad dewisol

Yn derbyn `video_url` ac yn ei ail-gyfansoddi ar gyfer `aspect_ratio` gwahanol (auto, 16:9, 1:1 neu 9:16). Mae'r `prompt` yn ddewisol. Mae `zoom_factor` (0 i 0.9) yn tocio i mewn i'r ffrâm ac mae `trim_borders` yn tynnu ffiniau. Mae cyfrif a chyfradd fframiau'r mewnbwn yn cael eu cadw'n ddiofyn, ac mae `resolution` yn mynd o 240p i 720p.

- Model id: `wan-vace-14b/reframe`
- 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/reframe`
- Quote: `POST https://api.doitong.com/v1/quote/wan-vace-14b/reframe`
- Docs page: https://doitong.com/cy/developers/models/wan-vace-14b/reframe

## 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 $1.50 = 1500 API credits (18.75 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/reframe` 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 | no | `` |  | Cyfarwyddiadau testun sy'n arwain cynhyrchu fideo; dewisol wrth ail-fframio. |
| `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` |  | Anogiad negyddol a gymhwysir wrth gynhyrchu fideo. |
| `match_input_num_frames` |  | boolean | no | `true` |  | Ffynhonnell cyfrif fframiau'r fideo a gynhyrchir: mae false yn defnyddio `num_frames`, tra bo true yn copïo cyfrif fframiau'r fideo mewnbwn. |
| `num_frames` |  | integer | no | `81` | 17 – 241 | Cyfrif fframiau allbwn, gydag ystod gynhwysol o 81–241. |
| `match_input_frames_per_second` |  | boolean | no | `true` |  | Ffynhonnell cyfradd fframiau'r fideo a gynhyrchir: mae false yn defnyddio `frames_per_second`, tra bo true yn copïo cyfradd fframiau'r fideo mewnbwn. |
| `frames_per_second` |  | integer \| null | no | `16` | 5 – 30 | Cyfradd fframiau'r fideo a gynhyrchir, a gymhwysir dim ond pan nad yw `match_input_frames_per_second` yn true; gwerthoedd derbyniol yw 5–30 ffrâm yr eiliad. |
| `seed` |  | integer \| null | no |  |  | Hadau sy'n gwneud cynhyrchu'n atgynhyrchadwy. Mae ei osod i None yn dewis hedyn ar hap. |
| `resolution` |  | enum (string) | no | `auto` | `auto`, `240p`, `360p`, `480p`, `580p`, `720p` | Cydraniad yr allbwn fideo. |
| `aspect_ratio` |  | enum (string) | no | `auto` | `auto`, `16:9`, `1:1`, `9:16` | Cymhareb agwedd y fideo sy'n deillio. |
| `num_inference_steps` |  | integer | no | `30` | 2 – 50 | Cyfrif camau samplu, sy'n cyfnewid amser prosesu hirach am ansawdd gwell wrth i'r cyfrif gynyddu. |
| `guidance_scale` |  | number | no | `5` | 1 – 10 | Cryfder aliniad anogiad a reolir drwy arweiniad di-ddosbarthwr; mae cynyddu'r raddfa yn annog delweddau a gynhyrchir i ddilyn y testun yn fwy agos. |
| `sampler` |  | enum (string) | no | `unipc` | `unipc`, `dpm++`, `euler` | Samplwr a ddefnyddir wrth gynhyrchu fideo. |
| `shift` |  | number | no | `5` | 1 – 15 | Gosodiad shifft a gymhwysir wrth gynhyrchu fideo. |
| `video_url` | `video` | string (video URL) | yes |  |  | Cyfeiriad ail-fframio a ddarperir fel URL sy'n pwyntio at ffeil fideo ffynhonnell. |
| `first_frame_url` | `image` | string \| null | no |  |  | Cyfeiriad ffrâm gyntaf dewisol a ddarperir drwy URL i'r model ei ddefnyddio wrth brosesu'r fideo. |
| `last_frame_url` | `end_image` | string \| null | no |  |  | Cyfeiriad ffrâm olaf dewisol a ddarperir drwy URL i'r model ei ddefnyddio wrth brosesu'r fideo. |
| `enable_safety_checker` |  | boolean | no | `false` |  | Switsh gwirio diogelwch y mae ei osodiad diffodd yn gofyn am awdurdodiad cyfrif. Heb yr awdurdodiad hwnnw, caiff pob cais ei wirio waeth beth fo'r gosodiad; mae true yn galluogi'r gwiriwr. |
| `enable_prompt_expansion` |  | boolean | no | `false` |  | Yn rheoli a yw ehangu'r anogiad wedi'i alluogi. |
| `acceleration` |  | enum (string) \| null | no | `regular` | `none`, `low`, `regular` | Gosodiad cyflymu casglu, gyda dewis o 'none' neu 'regular': mae prosesu cyflymach yn cynnig gwelliant sylweddol mewn cyflymder ar draul newid bach iawn i'r allbwn. |
| `video_quality` |  | enum (string) | no | `high` | `low`, `medium`, `high`, `maximum` | Lefel ansawdd y fideo sy'n deillio o hynny. |
| `video_write_mode` |  | enum (string) | no | `balanced` | `fast`, `balanced`, `small` | Modd ysgrifennu'r fideo sy'n deillio o hynny. |
| `num_interpolated_frames` |  | integer | no | `0` | 0 – 5 | Cyfrif rhyngosod: mae 0 yn gadael y fframiau gwreiddiol heb eu rhyngosod; mae gwerthoedd eraill yn pennu faint o fframiau canolradd i'w cynhyrchu rhyngddynt. |
| `temporal_downsample_factor` |  | integer | no | `0` | 0 – 5 | Ffactor sgipio fframiau fideo, wedi'i fynegi fel cyfanrif, gyda samplu i fyny awtomatig unwaith ar gyfer pob ffactor samplu i lawr. Defnyddiwch 0 i gadw samplu amserol i lawr wedi'i analluogi. |
| `enable_auto_downsample` |  | boolean | no | `false` |  | Addasu cyfrif fframiau'n awtomatig: mae ei alluogi yn gadael i'r model brosesu fideo wedi'i samplu i lawr yn amserol o hyd addas, gyda rhyngosod wedyn yn adfer y cyfrif fframiau gwreiddiol. |
| `auto_downsample_min_fps` |  | number | no | `15` | 1 – 60 | Cyfradd ffrâm leiaf, mewn fframiau yr eiliad, a ganiateir ar ôl is-samplu. Ar gyfer ffilm gyda symudiad isel, mae lleihau'r gwerth hwn yn caniatáu mwy o is-samplu a dilyniannau hirach; efallai y bydd angen gwerth uwch ar symudiad cyflym iawn, er bod y rhagosodiad yn addas ar gyfer y rhan fwyaf o fideos. Mae is-samplu awtomatig yn defnyddio'r trothwy hwn i chwilio am y ffactor isaf sy'n cadw manylion. |
| `interpolator_model` |  | enum (string) | no | `film` | `rife`, `film` | Dewis model rhyngosod fframiau: naill ai 'rife' neu 'film'. |
| `transparency_mode` |  | enum (string) | no | `content_aware` | `content_aware`, `white`, `black` | Trin tryloywder ar gyfer y fframiau dechrau a diwedd, gan bennu sut mae eu rhanbarthau tryloyw yn cael eu llenwi. |
| `return_frames_zip` |  | boolean | no | `false` |  | Yn rheoli a ddychwelir hefyd archif ZIP sy'n cynnwys pob ffrâm a gynhyrchwyd; wedi'i alluogi pan fo true. |
| `zoom_factor` |  | number | no | `0` | 0 – 0.9 | Gosodwch chwyddo'r fideo i 0 i'w adael yn ddigyfnewid. Mae ffactor positif yn ehangu'r fideo o'i gymharu â'r cynfas gymaint â hynny, gan docio'r ymylon allanol. |
| `trim_borders` |  | boolean | no | `true` |  | Yn rheoli a yw borderi'r fideo yn cael eu trimio. |

File parameters (`video`) 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
{
  "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
}
```

A fuller example:

```json
{
  "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/reframe?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "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/reframe?wait=20", {
  method: "POST",
  headers,
  body: JSON.stringify({
    "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 = {
    "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/reframe", 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/reframe",
      "input": {
        "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/reframe",
  "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": 1500,
    "usd": "1.50",
    "charged": 1500,
    "refunded": 0
  },
  "input": {
    "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} | Ffeil fideo wedi'i hail-fframio a gynhyrchwyd gan y model. |
| `prompt` | string | Anogiad a ddefnyddiwyd i gynhyrchu'r allbwn. |
| `seed` | integer | Gwerth hedyn a gymhwysir wrth gynhyrchu. |
| `frames_zip` | object {url, content_type, file_name, file_size} \| null | Archif ZIP sy'n cynnwys pob ffrâm fideo, a ddychwelir pan ofynnir amdani. |

## 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 · Depth](https://doitong.com/developers/models/wan-vace-14b/depth.md) (`wan-vace-14b/depth`): 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
- [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/reframe
- 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/reframe
- Errors: https://doitong.com/developers/docs/errors
- Model details as JSON: https://api.doitong.com/v1/models/wan-vace-14b/reframe