# Wan 2.2 A14B Speech to Video Turbo API

> Wan 2.2 A14B Speech to Video Turbo — high-quality AI video generation.

- **Provider**: Wan
- **Model id**: `wan-2-2-a14b-speech-to-video-turbo`
- **Modality**: video
- **Price**: 8.21–16.42 credits /sec

## Overview

Wan 2.2 A14B Speech to Video Turbo is called in two steps: create a generation task, then poll the task until the result is ready.

## Authentication

All requests require a Bearer Token in the request header:

```
Authorization: Bearer YOUR_API_KEY
```

## Create Task

`POST https://you.bot/api/v1/generate`

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| modelId | string | Yes | Model id: `wan-2-2-a14b-speech-to-video-turbo` |
| input | object | Yes | Input parameters object (see below) |
| callbackUrl | string | No | https URL to receive a signed webhook on completion |

### input object parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| prompt | string | Yes | The text prompt used for video generation (default: Subtle lifelike motion driven by the audio, gentle natural head movement, soft cinematic lighting, smooth realistic delivery.) |
| image_url | string | Yes | URL of the input image. If the input image does not match the chosen aspect ratio, it is resized and center cropped (image URL) |
| audio_url | string | Yes | The URL of the audio file (image URL) |
| num_frames | number | No | Number of frames to generate. Must be between 40 to 120, (must be multiple of 4) (range 40-120) (default: 80) |
| frames_per_second | number | No | Frames per second of the generated video. Must be between 4 to 60. When using interpolation and adjust_fps_for_interpolation is set to true (default true,) the final FPS will be multiplied by the number of interpolated frames plus one. For example, if the generated frames per second is 16 and the number of interpolated frames is 1, the final frames per second will be 32. If adjust_fps_for_interpolation is set to false, this value will be used as-is (range 4-60) (default: 16) |
| resolution | string | No | Resolution of the generated video (480p, 580p, or 720p) (options: 480p | 580p | 720p) (default: 480p) |
| negative_prompt | string | No | Negative prompt for video generation |
| seed | number | No | Random seed for reproducibility. If None, a random seed is chosen |
| num_inference_steps | number | No | Number of inference steps for sampling. Higher values give better quality but take longer (range 2-40) (default: 27) |
| guidance_scale | number | No | Classifier-free guidance scale. Higher values give better adherence to the prompt but may decrease quality (range 1-10) (default: 3.5) |
| shift | number | No | Shift value for the video. Must be between 1.0 and 10.0 (range 1-10) (default: 5) |
| enable_safety_checker | boolean | No | If set to true, input data will be checked for safety before processing (true/false) (default: true) |
| nsfw_checker | boolean | No | A configurable parameter. Defaults to true in the Playground. (true/false) (default: true) |

### Request example

```json
{
  "modelId": "wan-2-2-a14b-speech-to-video-turbo",
  "input": {
    "prompt": "A cinematic aerial shot of a coastal town at golden hour, gentle waves rolling onto the shore, warm light, slow camera push-in.",
    "image_url": "https://example.com/input.jpg",
    "audio_url": "https://example.com/input.jpg",
    "num_frames": "80",
    "frames_per_second": "16",
    "resolution": "480p",
    "negative_prompt": "blurry, low quality, distorted, watermark, text",
    "seed": "1",
    "num_inference_steps": "27",
    "guidance_scale": "3.5",
    "shift": "5",
    "enable_safety_checker": true,
    "nsfw_checker": true
  }
}
```

### Response example

```json
{
  "taskId": "281e5b0…f39b9",
  "creditsCharged": 24
}
```

## Query Task

`GET https://you.bot/api/v1/task/{taskId}?model=wan-2-2-a14b-speech-to-video-turbo`

When `state` is `success`, the output is in `resultUrls`: `{ "state": "success", "resultUrls": [ ... ] }`. (Text models return inline in the create response.)

## Error Codes

| Code | Description |
|------|-------------|
| 200 | Request successful |
| 400 | Invalid request parameters |
| 401 | Authentication failed, check API Key |
| 402 | Insufficient account balance |
| 422 | Parameter validation failed |
| 429 | Request rate limit exceeded |
| 500 | Internal server error |