# Wan v2.2 A14B API

> Ka whakahākorikori i tētahi atahanga tū hei topenga, me te anga whakamutunga, te whakawhitinga anga me ngā mana tīpako taipitopito hei kōwhiringa

Ka huri i tētahi `image_url` kotahi me tētahi tohutohu kuputuhi hei ataata, ā, mā te `end_image_url` kōwhiringa e whakarite te anga whakamutunga. Ko te putanga he 480p, 580p, 720p rānei i roto i te auto, 16:9, 9:16, 1:1 rānei, me te 17 ki te 161 anga me te 4 ki te 60 anga ia hēkona. Ka taea te whakarite i te tīpako mā ngā hipanga whakatauira, ngā tauine arataki e rua, te shift, te tohutohu whakahē me te kākano. E wātea ana te whakawhitinga anga mā ngā kōwhiringa film, rife rānei.

- Model id: `wan/v2.2-a14b/image-to-video`
- Made by: Alibaba
- Category: Image 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/v2.2-a14b/image-to-video`
- Quote: `POST https://api.doitong.ru/v1/quote/wan/v2.2-a14b/image-to-video`
- Docs page: https://doitong.com/mi/developers/models/wan/v2.2-a14b/image-to-video

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

- 480p: $0.04 / second of output video
- 580p: $0.06 / 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 (720p)).

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/v2.2-a14b/image-to-video` 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 |
|---|---|---|---|---|---|---|
| `image_url` | `image` | string (image URL) | yes |  |  | URL atahanga pūtake, ā, mā te ōwehenga āhuatanga kua kōwhiria e whakatau mēnā me tukatuka-mua: mā te rerekētanga ka rahi anō, kātahi ka tapahia te pokapū. |
| `prompt` |  | string | yes |  |  | Ngā tohutohu kuputuhi hei ārahi i te whakaputanga ataata. |
| `num_frames` |  | integer | no | `81` | 17 – 161 | Te maha o ngā anga mō te whakaputanga, he awhe whakauru 17–161. |
| `frames_per_second` |  | integer \| null | no | `16` | 4 – 60 | Te auau anga ataata kua whakaputaina, e whakaae ana ki ngā uara mai i te 4 ki te 60; mā te tautuhi `adjust_fps_for_interpolation` ki false ka pupuri tonu i tēnei auau. Ina whakamahia te whakanuitanga, ā, ko te taunoa o `adjust_fps_for_interpolation` he true, whakareatia tēnei auau ki te kotahi tāpirihia ki te maha o ngā anga kua whakanuitia hei whiwhi i te FPS whakamutunga. Hei tauira, ka huri te 16 FPS me te 1 anga kua whakanuitia ki te 32 FPS. |
| `negative_prompt` |  | string | no | `` |  | Te tohutohu tōraro e whakamahia ana i te whakaputa ataata. |
| `seed` |  | integer \| null | no |  |  | Te kākano e taea ai te tārua o te whakaputanga. Mā te tautuhi ki None e kōwhiri matapōkeretia ai he kākano. |
| `resolution` |  | enum (string) | no | `720p` | `480p`, `580p`, `720p` | Te taumira ataata putanga: 480p, 580p, 720p rānei. |
| `aspect_ratio` |  | enum (string) | no | `auto` | `auto`, `16:9`, `9:16`, `1:1` | Ngā taurite o te ataata kua whakaputaina, ka kōwhiria aunoatia mai i te atahanga tāuru ina tautuhia ki 'auto'. |
| `num_inference_steps` |  | integer | no | `27` | 2 – 40 | Te tatau kaupae tīpako, ka whakawhiti i te wā tukatuka roa mō te kounga pai ake ina piki te tatau. |
| `enable_safety_checker` |  | boolean | no | `false` |  | Te tirotiro haumaru tāuru i mua i te tukatuka, ā, ko ngā pūkete whai mana anake ka taea te whakaweto. Ka tirotirohia tonutia ngā tono kāore he mana; ki te whai mana, mā true e whakahohe te tirotiro. |
| `enable_output_safety_checker` |  | boolean | no | `false` |  | Ka whakahaere i te tirotiro haumaru o te ataata kua whakaputaina; mā te tautuhi true e whakahohe te tirotiro i muri i te whakaputanga. |
| `enable_prompt_expansion` |  | boolean | no | `false` |  | Tukua he tauira reo nui kia whakarangatira i te tohutohu ki ngā taipitopito. Mā tēnei whakawhānuitanga e noho pūmau ai te tikanga o te tohutohu. |
| `acceleration` |  | enum (string) | no | `regular` | `none`, `regular` | Te tautuhinga whakatere, ko 'regular' te kōwhiringa e taunakitia ana. Mā te whakanui i te whakatere ka heke te kounga hei whakapoto i te wā whakaputa. |
| `guidance_scale` |  | number | no | `3.5` | 1 – 10 | Te kaha arataki classifier-free, ka whakawhiti i te ngaronga kounga pea mō te ū tata ake ki te tohutohu ina piki te tauine. |
| `guidance_scale_2` |  | number | no | `3.5` | 1 – 10 | Te tauine ārahi e whakahaere ana i te tino whai a te tauira i te tohutohu i tana wāhanga tuarua. |
| `shift` |  | number | no | `5` | 1 – 10 | Te tautuhinga neke ataata, he awhe whakaaetia 1.0–10.0. |
| `interpolator_model` |  | enum (string) | no | `film` | `none`, `film`, `rife` | Te tautuhinga whakanui anga: kōwhiria None hei karo i te whakanui, tautuhia rānei te tauira hei mahi māna. |
| `num_interpolated_frames` |  | integer | no | `1` | 0 – 4 | Whakaurua ngā anga kua whakanuitia 0–4 ki ia āputa i waenga i ngā anga whakaputa e rua. |
| `adjust_fps_for_interpolation` |  | boolean | no | `true` |  | Pana whakatikatika auau-anga: mā false e pupuri te FPS kua tukuna, ā, mā true e whakareatia ki te kotahi tāpirihia ki te maha o ngā anga kua whakanuitia. Nō reira, ka huri te 16 FPS ki te 32 FPS ina whakanuitia te 1 anga, ā, ka whakahohea te whakatikatika. |
| `video_quality` |  | enum (string) | no | `high` | `low`, `medium`, `high`, `maximum` | Te tautuhinga kounga ataata putanga, e whakawhiti ana i te rahi ake o te kōnae mō ngā āhua pai ake ina piki te tautuhinga. |
| `video_write_mode` |  | enum (string) | no | `balanced` | `fast`, `balanced`, `small` | Te aratau tuhi ataata, ko balanced te taurite i waenga i te tere me te kounga. Kōwhiria small mō ngā kōnae iti rawa me te tuhi pōturi rawa; mā te tuhi tere ake ka hoki wawe mai ngā hua, engari ka nui ake ngā kōnae. |
| `end_image_url` | `end_image` | string (image URL) \| null | no |  |  | URL e tohu ana ki te atahanga mutunga. |

File parameters (`image`, `end_image`) 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",
  "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
}
```

A fuller example:

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

## 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/v2.2-a14b/image-to-video?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",
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# 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/v2.2-a14b/image-to-video?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",
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }),
});
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 = {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
}

# Run the model; wait up to 20 s for the finished result in the same call
r = requests.post(API + "/run/wan/v2.2-a14b/image-to-video", 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/v2.2-a14b/image-to-video",
      "input": {
        "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
        "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
      },
      "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/v2.2-a14b/image-to-video",
  "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",
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "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
    },
    "prompt": "The white dragon warrior stands still, eyes full of determination and strength. The camera slowly moves closer or circles around the warrior, highlighting the powerful presence and heroic spirit of the character.",
    "seed": 42
  },
  "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} | Te kōnae ataata i whakaputaina. |
| `prompt` | string | Te tohutohu kuputuhi i whakamahia hei whakaputa i te ataata. |
| `seed` | integer | Te uara kākano i whakamahia i te whakaputanga. |

## Related models

- [Wan · v2.2 A14b · Text to Image](https://doitong.com/developers/models/wan/v2.2-a14b/text-to-image.md) (`wan/v2.2-a14b/text-to-image`): $0.025 / image
- [Wan-2.2 Text-to-Video A14B](https://doitong.com/developers/models/wan/v2.2-a14b/text-to-video.md) (`wan/v2.2-a14b/text-to-video`): from $0.04 / second of output video
- [Wan · v2.2 A14b · Video to Video](https://doitong.com/developers/models/wan/v2.2-a14b/video-to-video.md) (`wan/v2.2-a14b/video-to-video`): from $0.04 / second of output video
- [Wan-2.2 Speech-to-Video 14B](https://doitong.com/developers/models/wan/v2.2-14b/speech-to-video.md) (`wan/v2.2-14b/speech-to-video`): from $0.10 / second of output video
- [Wan 3.0 Image to Video](https://doitong.com/developers/models/alibaba/wan-3.0/image-to-video.md) (`alibaba/wan-3.0/image-to-video`): from $0.05 / second
- [FLUX 3 Max Image to Video](https://doitong.com/developers/models/blackforestlabs/flux-3-max/image-to-video.md) (`blackforestlabs/flux-3-max/image-to-video`): from $0.0425 / second of output video
- [Grok Imagine Video 1.5 Image to Video](https://doitong.com/developers/models/xai/grok-imagine-video/v1.5/image-to-video.md) (`xai/grok-imagine-video/v1.5/image-to-video`): from $0.082 / second
- [Kling 3.0 Pro Image to Video](https://doitong.com/developers/models/kling-video/v3/pro/image-to-video.md) (`kling-video/v3/pro/image-to-video`): from $0.112 / second

## Links

- HTML page: https://doitong.com/developers/models/wan/v2.2-a14b/image-to-video
- 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/v2.2-a14b/image-to-video
- Errors: https://doitong.com/developers/docs/errors
- Model details as JSON: https://api.doitong.ru/v1/models/wan/v2.2-a14b/image-to-video