Appearance
Wan
Wan 2.6 video models for creative scenes and structured camera prompts.
API surface
| Operation | Endpoint | Mode |
|---|---|---|
| Video generation task | POST /v1/async/videos/generations | Async only |
Models
| Model id | Notes |
|---|---|
wan2.6 | Text-to-video and image-to-video. seconds only 5 / 10 / 15. Default resolution 1080p. |
wan2.6-flash | Requires image-to-video or reference video (image or providerOptions.metadata.reference_urls). Default resolution 1080p. Default audio on. |
Pricing
Billed as n × seconds × rate(resolution) credits.
| Model | 720p | 1080p |
|---|---|---|
wan2.6-flash | 5/sec | 8/sec |
wan2.6 | 9/sec | 15/sec |
Request fields
Send the common fields at the top level. Put the model-specific controls listed below inside providerOptions.
| Field | Type | Required | Description |
|---|---|---|---|
model | string | Yes | wan2.6, wan2.6-flash |
prompt | string | Yes | 1–1,500 characters; describe motion, camera work, and dialogue. |
seconds | integer | Yes | 5, 10, 15; with reference media only 5 or 10. |
resolution | string | No | 720p / 1080p. Pixapi default: 1080p. |
n | integer | No | Default 1; only integer 1 is supported. |
image | string / string[] | No | One public first-frame URL; JPEG/PNG/WebP/BMP. Flash requires this or metadata.reference_urls. Do not combine both modes. |
providerOptions | object | No | Model-specific options; see the table below. |
providerOptions
All fields in this table are nested inside providerOptions, not alongside model.
| Field | Type | Description |
|---|---|---|
aspect_ratio | string | 16:9, 9:16, 1:1, 4:3, 3:4. Default 16:9; image-to-video follows the input image ratio. |
negative_prompt | string | Content to exclude; at most 500 characters. |
seed | integer | Random seed, 0–2147483647; omitted means random. The same seed does not guarantee identical output. |
prompt_extend | boolean | Rewrite and expand the prompt for generation; default true. |
watermark | boolean | Add a visible AI watermark. Default false. |
audio | boolean | Default on. Only wan2.6-flash permits false; wan2.6 rejects silent output. |
audio_url | string | Public WAV/MP3 URL for synchronized audio. Input audio should be at least as long as the requested video; longer audio is trimmed. Not supported in reference mode. |
shot_type | string | single (default) or multi. Generation from text/first frame requires prompt_extend=true for this control. |
metadata | object | Only reference_urls: 1–5 public image/video URLs, at most 3 videos (MP4/MOV). Do not combine with image, audio_url, or prompt_extend; seconds must be 5 or 10. Use character1, character2 in prompt order. |
Example
bash
curl https://api.pixapi.ai/v1/async/videos/generations \
-H "Authorization: Bearer $PIXAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "wan2.6",
"prompt": "A quiet morning street with soft sunlight and gentle camera drift",
"n": 1,
"seconds": 5,
"resolution": "1080p",
"providerOptions": {
"aspect_ratio": "16:9"
}
}'py
import os
import requests
response = requests.post(
"https://api.pixapi.ai/v1/async/videos/generations",
headers={
"Authorization": f"Bearer {os.environ['PIXAPI_KEY']}",
"Content-Type": "application/json",
},
json={
"model": "wan2.6",
"prompt": "A quiet morning street with soft sunlight and gentle camera drift",
"n": 1,
"seconds": 5,
"resolution": "1080p",
"providerOptions": {
"aspect_ratio": "16:9"
}
},
)
response.raise_for_status()
task = response.json()
print(task["id"])js
const response = await fetch('https://api.pixapi.ai/v1/async/videos/generations', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.PIXAPI_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
"model": "wan2.6",
"prompt": "A quiet morning street with soft sunlight and gentle camera drift",
"n": 1,
"seconds": 5,
"resolution": "1080p",
"providerOptions": {
"aspect_ratio": "16:9"
}
}),
});
if (!response.ok) {
throw new Error(await response.text());
}
const task = await response.json();
console.log(task.id);go
package main
import (
"bytes"
"fmt"
"io"
"net/http"
"os"
)
func main() {
body := []byte(`{
"model": "wan2.6",
"prompt": "A quiet morning street with soft sunlight and gentle camera drift",
"n": 1,
"seconds": 5,
"resolution": "1080p",
"providerOptions": {
"aspect_ratio": "16:9"
}
}`)
req, err := http.NewRequest(
"POST",
"https://api.pixapi.ai/v1/async/videos/generations",
bytes.NewBuffer(body),
)
if err != nil {
panic(err)
}
req.Header.Set("Authorization", "Bearer "+os.Getenv("PIXAPI_KEY"))
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
result, _ := io.ReadAll(resp.Body)
fmt.Println(string(result))
}Response
Pixapi returns a submitted task. Poll GET /v1/tasks/{id} for the final result.
