# Wan v2.2 A14B API

> Anima una imagen fija para convertirla en un clip, con fotograma final opcional, interpolación y controles detallados de muestreo

Convierte una `image_url` junto con un prompt de texto en un video; una `end_image_url` opcional puede establecer el fotograma final. La salida es 480p, 580p o 720p en auto, 16:9, 9:16 o 1:1, con 17 a 161 fotogramas y de 4 a 60 fotogramas por segundo. El muestreo se puede ajustar mediante pasos de inferencia, dos escalas de guía, shift, un prompt negativo y una semilla. La interpolación está disponible con las opciones film o rife.

- 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/es-MX/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 de la imagen de origen; la relación de aspecto seleccionada determina si se necesita preprocesamiento: una discrepancia activa un redimensionamiento seguido de un recorte central. |
| `prompt` |  | string | yes |  |  | Instrucciones de texto que guían la generación de video. |
| `num_frames` |  | integer | no | `81` | 17 – 161 | Cantidad de fotogramas para la generación, con un rango inclusivo de 17–161. |
| `frames_per_second` |  | integer \| null | no | `16` | 4 – 60 | Velocidad de fotogramas del video generado, que acepta valores de 4 a 60; establecer `adjust_fps_for_interpolation` en false conserva esta velocidad sin cambios. Con la interpolación habilitada y `adjust_fps_for_interpolation` en true (su valor predeterminado), multiplica esta velocidad por uno más la cantidad de fotogramas interpolados para obtener los FPS finales. Por ejemplo, 16 FPS con 1 fotograma interpolado se convierte en 32 FPS. |
| `negative_prompt` |  | string | no | `` |  | Prompt negativo aplicado al generar un video. |
| `seed` |  | integer \| null | no |  |  | Semilla que hace reproducible la generación. Establecerla en None selecciona una semilla aleatoriamente. |
| `resolution` |  | enum (string) | no | `720p` | `480p`, `580p`, `720p` | Resolución del video de salida: 480p, 580p o 720p. |
| `aspect_ratio` |  | enum (string) | no | `auto` | `auto`, `16:9`, `9:16`, `1:1` | Proporciones del video generado, seleccionadas automáticamente a partir de la imagen de entrada cuando se establece en 'auto'. |
| `num_inference_steps` |  | integer | no | `27` | 2 – 40 | Cantidad de pasos de muestreo; un valor mayor intercambia más tiempo de procesamiento por una mejor calidad. |
| `enable_safety_checker` |  | boolean | no | `false` |  | Revisión de seguridad de la entrada antes del procesamiento, que solo las cuentas autorizadas pueden desactivar. Las solicitudes sin autorización siempre se revisan; de lo contrario, true habilita la revisión. |
| `enable_output_safety_checker` |  | boolean | no | `false` |  | Controla la revisión de seguridad del video generado; establecerlo en true habilita una comprobación después de la generación. |
| `enable_prompt_expansion` |  | boolean | no | `false` |  | Permite que un modelo de lenguaje grande enriquezca el prompt con detalles. Habilitar esta expansión mantiene sin cambios el significado del prompt. |
| `acceleration` |  | enum (string) | no | `regular` | `none`, `regular` | Configuración de aceleración, donde 'regular' es la opción recomendada. Aumentar la aceleración sacrifica calidad para reducir el tiempo de generación. |
| `guidance_scale` |  | number | no | `3.5` | 1 – 10 | Intensidad de la guía sin clasificador; al aumentar la escala, se intercambia una posible pérdida de calidad por una mayor coincidencia con el prompt. |
| `guidance_scale_2` |  | number | no | `3.5` | 1 – 10 | Escala de guía que controla qué tan estrechamente sigue el modelo el prompt durante su segunda etapa. |
| `shift` |  | number | no | `5` | 1 – 10 | Configuración de desplazamiento del video, con un rango permitido de 1.0–10.0. |
| `interpolator_model` |  | enum (string) | no | `film` | `none`, `film`, `rife` | Configuración de interpolación de fotogramas: elige None para omitir la interpolación o especifica el modelo que la realizará. |
| `num_interpolated_frames` |  | integer | no | `1` | 0 – 4 | Inserta de 0 a 4 fotogramas interpolados en cada espacio entre dos fotogramas generados. |
| `adjust_fps_for_interpolation` |  | boolean | no | `true` |  | Control de ajuste de la velocidad de fotogramas: false conserva los FPS proporcionados, mientras que true los escala por uno más la cantidad de fotogramas interpolados. Por lo tanto, 16 FPS se convierten en 32 FPS cuando se interpola 1 fotograma y el ajuste está habilitado. |
| `video_quality` |  | enum (string) | no | `high` | `low`, `medium`, `high`, `maximum` | Configuración de calidad del video de salida, que intercambia archivos más grandes por mejores elementos visuales a medida que aumenta el valor. |
| `video_write_mode` |  | enum (string) | no | `balanced` | `fast`, `balanced`, `small` | Modo de escritura del video, donde balanced ofrece un equilibrio entre velocidad y calidad. Elige small para obtener los archivos más pequeños y la escritura más lenta; una escritura más rápida devuelve los resultados antes, pero crea archivos más grandes. |
| `end_image_url` | `end_image` | string (image URL) \| null | no |  |  | URL que apunta a la imagen final. |

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} | Archivo de video producido por la generación. |
| `prompt` | string | Prompt de texto usado para generar el video. |
| `seed` | integer | Valor de semilla aplicado durante la generación. |

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