# Wan VACE 14B · Reframe API

> Reframing VACE 14B d'in video ad ina nova relaziun d'aspect, cun zoom e tagl dals urs; prompt facultativ

Prenda in `video_url` e recomponescha el per in auter `aspect_ratio` (auto, 16:9, 1:1 u 9:16). Il `prompt` è facultativ. `zoom_factor` (0 fin 0.9) taglia pli datiers en il frame e `trim_borders` allontanescha ils urs. Dumber e frequenza da frames correspundan per standard a l'input, e `resolution` tanscha da 240p fin 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/rm/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 | `` |  | Instrucziuns textualas che dirigian la generaziun video; facultativas durant il reframing. |
| `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` |  | Prompt negativ applitgà durant la generaziun d'in video. |
| `match_input_num_frames` |  | boolean | no | `true` |  | Funtauna dal dumber da frames dal video generà: false utilisescha `num_frames`, entant che true copia il dumber da frames dal video d'input. |
| `num_frames` |  | integer | no | `81` | 17 – 241 | Dumber da frames da l'output, cun in interval inclusiv da 81–241. |
| `match_input_frames_per_second` |  | boolean | no | `true` |  | Funtauna dal frame rate dal video generà: false utilisescha `frames_per_second`, entant che true copia il frame rate dal video d'input. |
| `frames_per_second` |  | integer \| null | no | `16` | 5 – 30 | Frequenza da frame dal video generà, applitgada mo sche `match_input_frames_per_second` n'è betg true; las valurs acceptadas èn 5–30 frame per secunda. |
| `seed` |  | integer \| null | no |  |  | Seed che renda la generaziun reproducibla. Cun definir None vegn tschernì in seed casualmain. |
| `resolution` |  | enum (string) | no | `auto` | `auto`, `240p`, `360p`, `480p`, `580p`, `720p` | Resoluziun dal video d'output. |
| `aspect_ratio` |  | enum (string) | no | `auto` | `auto`, `16:9`, `1:1`, `9:16` | Relaziun d'aspect dal video final. |
| `num_inference_steps` |  | integer | no | `30` | 2 – 50 | Dumber da pass da sampling, barattà temp d'elavuraziun pli lung per meglra qualitad cun l'augment dal dumber. |
| `guidance_scale` |  | number | no | `5` | 1 – 10 | Fortezza da l'allineament dal prompt, controllada tras guidance senza classificader; ina scala pli gronda fa che ils maletgs generads suondan il text pli precisamain. |
| `sampler` |  | enum (string) | no | `unipc` | `unipc`, `dpm++`, `euler` | Sampler utilisà durant la generaziun dal video. |
| `shift` |  | number | no | `5` | 1 – 15 | Configuraziun dal shift applitgada durant la generaziun dal video. |
| `video_url` | `video` | string (video URL) | yes |  |  | Referenza per il reframing furnida sco URL che mussa a la datoteca video da funtauna. |
| `first_frame_url` | `image` | string \| null | no |  |  | Referenza facultativa dal prim frame furnida via URL per il model, per l'utilisar durant l'elavuraziun dal video. |
| `last_frame_url` | `end_image` | string \| null | no |  |  | Referenza facultativa da l'ultim frame furnida via URL per il model, per l'utilisar durant l'elavuraziun dal video. |
| `enable_safety_checker` |  | boolean | no | `false` |  | Interrutur da controlla da segirezza, dal qual la configuraziun spustada pretenda l'autorisaziun dal conto. Senza questa autorisaziun vegn mintga dumonda controllada independentamain da la configuraziun; true activa il controllader. |
| `enable_prompt_expansion` |  | boolean | no | `false` |  | Controlla sche l'expansiun dal prompt è activada. |
| `acceleration` |  | enum (string) \| null | no | `regular` | `none`, `low`, `regular` | Configuraziun per accelerar l'inferenza, cun la tscherna 'none' u 'regular': il processament accelerà porscha in grond augment da sveltezza cun ina fitg pitschna midada da l'output. |
| `video_quality` |  | enum (string) | no | `high` | `low`, `medium`, `high`, `maximum` | Nivel da qualitad dal video resultà. |
| `video_write_mode` |  | enum (string) | no | `balanced` | `fast`, `balanced`, `small` | Modus da scriver per il video resultà. |
| `num_interpolated_frames` |  | integer | no | `0` | 0 – 5 | Dumber d'interpolaziuns: 0 lascha ils frames originals senza interpolaziun; autras valurs inditgeschan quants frames intermediars generar tranter els. |
| `temporal_downsample_factor` |  | integer | no | `0` | 0 – 5 | Factur da siglir frames dal video, exprimì sco entir; l'upsampling automatic vegn applitgà ina giada per mintga factur da downsampling. Utilisescha 0 per laschar la reducziun temporala disactivada. |
| `enable_auto_downsample` |  | boolean | no | `false` |  | Adattaziun automaticà dal dumber da frames: l'activaziun permetta al model da processar in video temporalmain reducì d'ina lunghezza adattada, cun interpolaziun posteriura per restaurar il dumber da frames original. |
| `auto_downsample_min_fps` |  | number | no | `15` | 1 – 60 | Rata minimala da frames, en frames per secunda, permessa suenter il downsampling. Per material cun pauc moviment, ina reducziun da questa valur permetta dapli downsampling e sequenzas pli lungas; moviment fitg svelt po pretender ina valur pli auta, entant che la valur standard è adattada per la gronda part dals videos. Il downsampling automatic utilisescha questa limita per tschertgar il factur il pli bass che mantegna il detagl. |
| `interpolator_model` |  | enum (string) | no | `film` | `rife`, `film` | Selecziun dal model d'interpolaziun da frames: u 'rife' u 'film'. |
| `transparency_mode` |  | enum (string) | no | `content_aware` | `content_aware`, `white`, `black` | Tractament da la transparenza per ils frame da cumenzament e da fin, che determinescha co emplenir lur regiuns transparentas. |
| `return_frames_zip` |  | boolean | no | `false` |  | Controlla sche in archiv ZIP che cuntegna mintga frame generà vegn era returnà; activà sche true. |
| `zoom_factor` |  | number | no | `0` | 0 – 0.9 | Fixescha il zoom dal video a 0 per al laschar invarià. In factur positiv engrondescha il video envers la canvas per quella quantitad, tagliand davent ils urs exteriurs. |
| `trim_borders` |  | boolean | no | `true` |  | Controlla sch'ils urs dal video vegnan tagliads. |

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} | Datoteca video reframed produc­ida dal model. |
| `prompt` | string | Prompt utilisà per generar l'output. |
| `seed` | integer | Valur da seed applitgada durant la generaziun. |
| `frames_zip` | object {url, content_type, file_name, file_size} \| null | Archiv ZIP che cuntegna mintga frame dal video, returnà sche dumandà. |

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