# Wan VACE 14B · Reframe API

> Reframing VACE 14B ta’ vidjo għal proporzjon ġdid, bi zoom u qtugħ tal-borduri; prompt fakultattiv

Jieħu `video_url` u jerġa’ jikkomponih għal `aspect_ratio` differenti (auto, 16:9, 1:1 jew 9:16). Il-`prompt` huwa fakultattiv. `zoom_factor` (0 sa 0.9) jaqta’ ġewwa l-frame u `trim_borders` ineħħi t-truf. In-numru tal-frames u r-rata tal-frames jaqblu mal-input b’mod awtomatiku, u `resolution` tvarja minn 240p sa 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.ru/v1/run/wan-vace-14b/reframe`
- Quote: `POST https://api.doitong.ru/v1/quote/wan-vace-14b/reframe`
- Docs page: https://doitong.com/mt/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.ru/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 | `` |  | Istruzzjonijiet testwali li jiggwidaw il-ġenerazzjoni tal-vidjo; mhux obbligatorji meta jsir 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 negattiv applikat waqt il-ġenerazzjoni ta’ vidjo. |
| `match_input_num_frames` |  | boolean | no | `true` |  | Sors tal-għadd ta’ frejms tal-vidjo ġġenerat: false juża `num_frames`, filwaqt li true jikkopja l-għadd ta’ frejms tal-vidjo tal-input. |
| `num_frames` |  | integer | no | `81` | 17 – 241 | Għadd ta’ frejms output, b’medda inklużiva ta’ 81–241. |
| `match_input_frames_per_second` |  | boolean | no | `true` |  | Sors tar-rata tal-frejms tal-vidjo ġġenerat: false juża `frames_per_second`, filwaqt li true jikkopja r-rata tal-frejms tal-vidjo tal-input. |
| `frames_per_second` |  | integer \| null | no | `16` | 5 – 30 | Rata tal-frejms tal-vidjo ġġenerat, applikata biss meta `match_input_frames_per_second` ma tkunx true; il-valuri aċċettati huma 5–30 frejm kull sekonda. |
| `seed` |  | integer \| null | no |  |  | Seed li jagħmel il-ġenerazzjoni riproduċibbli. L-issettjar tiegħu għal None jagħżel seed b’mod każwali. |
| `resolution` |  | enum (string) | no | `auto` | `auto`, `240p`, `360p`, `480p`, `580p`, `720p` | Riżoluzzjoni tal-vidjo output. |
| `aspect_ratio` |  | enum (string) | no | `auto` | `auto`, `16:9`, `1:1`, `9:16` | Ratio tal-aspett għall-vidjo li jirriżulta. |
| `num_inference_steps` |  | integer | no | `30` | 2 – 50 | Għadd ta’ passi ta’ kampjunar; għadd ogħla jżid il-ħin tal-ipproċessar iżda jtejjeb il-kwalità. |
| `guidance_scale` |  | number | no | `5` | 1 – 10 | Saħħa tal-allinjament mal-prompt ikkontrollata permezz ta’ guidance mingħajr klassifikatur; iż-żieda fl-iskala tħeġġeġ lill-immaġnijiet ġġenerati jsegwu t-test aktar mill-qrib. |
| `sampler` |  | enum (string) | no | `unipc` | `unipc`, `dpm++`, `euler` | Sampler użat waqt il-ġenerazzjoni tal-vidjo. |
| `shift` |  | number | no | `5` | 1 – 15 | Setting ta’ shift applikat waqt il-ġenerazzjoni tal-vidjo. |
| `video_url` | `video` | string (video URL) | yes |  |  | Referenza għar-reframing ipprovduta bħala URL li jindika l-fajl tal-vidjo tas-sors. |
| `first_frame_url` | `image` | string \| null | no |  |  | Referenza mhux obbligatorja tal-ewwel frejm ipprovduta permezz ta' URL għall-użu tal-mudell waqt l-ipproċessar tal-vidjo. |
| `last_frame_url` | `end_image` | string \| null | no |  |  | Referenza mhux obbligatorja tal-aħħar frejm ipprovduta permezz ta' URL għall-użu tal-mudell waqt l-ipproċessar tal-vidjo. |
| `enable_safety_checker` |  | boolean | no | `false` |  | Swiċċ tal-kontroll tas-sikurezza li l-issettjar mitfi tiegħu jeħtieġ awtorizzazzjoni tal-kont. Mingħajr dik l-awtorizzazzjoni, kull talba tiġi kkontrollata irrispettivament mill-issettjar; true jippermetti l-kontrollur. |
| `enable_prompt_expansion` |  | boolean | no | `false` |  | Jikkontrolla jekk l-espansjoni tal-prompt hijiex attivata. |
| `acceleration` |  | enum (string) \| null | no | `regular` | `none`, `low`, `regular` | Setting tal-aċċelerazzjoni tal-inferenza, b’għażla ta’ 'none' jew 'regular': l-ipproċessar aċċellerat joffri titjib sostanzjali fil-veloċità bi spiża ta’ bidla żgħira ħafna fl-output. |
| `video_quality` |  | enum (string) | no | `high` | `low`, `medium`, `high`, `maximum` | Livell tal-kwalità għall-vidjo li jirriżulta. |
| `video_write_mode` |  | enum (string) | no | `balanced` | `fast`, `balanced`, `small` | Modalità tal-kitba għall-vidjo li jirriżulta. |
| `num_interpolated_frames` |  | integer | no | `0` | 0 – 5 | Għadd ta’ interpolazzjonijiet: 0 iħalli l-frejms oriġinali mingħajr interpolazzjoni; valuri oħra jispeċifikaw kemm għandhom jiġu ġġenerati frejms intermedji bejniethom. |
| `temporal_downsample_factor` |  | integer | no | `0` | 0 – 5 | Fattur ta’ qbiż tal-frejms tal-vidjo, espress bħala numru sħiħ, b’upsampling awtomatiku applikat darba għal kull fattur ta’ downsampling. Uża 0 biex tħalli d-downsampling temporali diżattivat. |
| `enable_auto_downsample` |  | boolean | no | `false` |  | Adattament awtomatiku tal-għadd ta’ frejms: l-attivazzjoni tippermetti lill-mudell jipproċessa vidjo temporanjament downsampled ta’ tul xieraq, b’interpolazzjoni wara li tirrestawra l-għadd oriġinali ta’ frejms. |
| `auto_downsample_min_fps` |  | number | no | `15` | 1 – 60 | Rata minima tal-frejms, f'frejms kull sekonda, permessa wara downsampling. Għal filmati b'moviment baxx, it-tnaqqis ta' dan il-valur jippermetti downsampling akbar u sekwenzi itwal; moviment mgħaġġel ħafna jista' jeħtieġ valur ogħla, għalkemm il-prestabbilit jaqbel mal-biċċa l-kbira tal-vidjows. Id-downsampling awtomatiku juża dan il-limitu biex ifittex l-inqas fattur li jippreserva d-dettall. |
| `interpolator_model` |  | enum (string) | no | `film` | `rife`, `film` | Għażla tal-mudell għall-interpolazzjoni tal-frejms: jew 'rife' jew 'film'. |
| `transparency_mode` |  | enum (string) | no | `content_aware` | `content_aware`, `white`, `black` | Immaniġġjar tat-trasparenza għall-frejms inizjali u finali, li jiddetermina kif jimtlew ir-reġjuni trasparenti tagħhom. |
| `return_frames_zip` |  | boolean | no | `false` |  | Jikkontrolla jekk għandux jiġi rritornat ukoll arkivju ZIP li fih kull frejm ġġenerat; attivat meta jkun true. |
| `zoom_factor` |  | number | no | `0` | 0 – 0.9 | Issettja ż-żum tal-vidjo għal 0 biex tħallih mhux mibdul. Fattur pożittiv ikabbar il-vidjo relattivament għall-kanvas b'dak l-ammont, billi jaqta' t-truf ta' barra. |
| `trim_borders` |  | boolean | no | `true` |  | Jikkontrolla jekk it-truf tal-vidjo jinqatgħux. |

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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"
```

### JavaScript

```javascript
const API = "https://api.doitong.ru/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.ru/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.ru/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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/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} | Fajl tal-vidjo reframed prodott mill-mudell. |
| `prompt` | string | Prompt li ntuża biex jiġi ġġenerat l-output. |
| `seed` | integer | Valur ta’ seed applikat waqt il-ġenerazzjoni. |
| `frames_zip` | object {url, content_type, file_name, file_size} \| null | Arkivju ZIP li fih kull frejm tal-vidjo, irritornat meta mitlub. |

## 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.ru/v1/models/wan-vace-14b/reframe