Wan

Wan models are called through one unified, asynchronous job API. Start a task with POST /api/generate, then poll GET /api/generate/{taskId} until it finishes. This family exposes 17 endpoints.

Overview

Every endpoint shares the same envelope — only model and the input fields change. Run any from the Models Market playground.

Authentication

Create an API key at /api-keys, then send it as a Bearer token. Requests from the browser while logged in also work via the session cookie.

Authorization: Bearer <YOUR_API_KEY>

Create Task

POST

POST https://api.lithovas.com/api/generate

Body: { "model": "<slug>", "input": { … } }

Response: { "taskId": "<id>", "state": "waiting" }

Query Result

GET

GET https://api.lithovas.com/api/generate/<taskId>

Response: { "taskId", "state": "waiting" | "success" | "fail", "resultUrls": [ … ], "creditsConsumed", "failMsg", "balance" }

Asynchronous

A 200 from Create Task only means the task was accepted — not finished. Poll this endpoint until state becomes success or fail. Failed tasks are not billed.

Endpoints

Model	Task	model slug
Wan 2.7 Image	Text to Image	wan/2-7-image
Wan 2.7 Image Pro	Text to Image	wan/2-7-image-pro
Wan 2.2 A14B	Image to Video	wan/2-2-a14b-image-to-video-turbo
Wan 2.2 A14B	Text to Video	wan/2-2-a14b-text-to-video-turbo
Wan 2.2 Animate Move	Lip Sync	wan/2-2-animate-move
Wan 2.6	Image to Video	wan/2-6-image-to-video
Wan 2.6	Text to Video	wan/2-6-text-to-video
Wan 2.6	Video to Video	wan/2-6-video-to-video
Wan 2.6 Flash	Image to Video	wan/2-6-flash-image-to-video
Wan 2.6 Flash	Video to Video	wan/2-6-flash-video-to-video
Wan 2.5	Image to Video	wan/2-5-image-to-video
Wan 2.5	Text to Video	wan/2-5-text-to-video
Wan 2.7	Text to Video	wan/2-7-text-to-video
Wan 2.7	Image to Video	wan/2-7-image-to-video
Wan 2.7 Videoedit	Video Editing	wan/2-7-videoedit
Wan 3.0 Video	Text to Video	wan/3-0-video
Wan 3.0 Prime	Text to Video	alibaba/wan-3.0-prime

Wan 2.7 Image · Text to Image

POSTText to Imagewan/2-7-image

input fields

promptstringrequired

Prompt for image generation or editing (max 5000 chars)

input_urlsarray<string>optional

Array of input image URLs (max 9 images)

aspect_ratioenum<string>optional

Output aspect ratio when no image input provided

enable_sequentialbooleanoptional

Enable sequential/group image mode

nintegeroptional

Number of images (1-4 default; 1-12 if sequential)

resolutionenum<string>optional

Output resolution

thinking_modebooleanoptional

Enable thinking mode (not with sequential or input images)

color_palettearray<object>optional

Custom color theme; 3-10 colors each with hex and ratio

bbox_listarray<array>optional

Interactive editing bounding boxes; max 2 per image [x1,y1,x2,y2]

watermarkbooleanoptional

Add watermark to generated images

seedintegeroptional

Random seed; range 0-2147483647

Example

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan/2-7-image",
  "input": {
    "prompt": "A cinematic red panda surfing through neon rain at dusk.",
    "input_urls": [
      "https://example.com/file"
    ],
    "aspect_ratio": "1:1",
    "enable_sequential": false,
    "n": 4,
    "resolution": "2K",
    "thinking_mode": false,
    "color_palette": [],
    "bbox_list": "example",
    "watermark": false,
    "seed": 0
  }
}'

Wan 2.7 Image Pro · Text to Image

POSTText to Imagewan/2-7-image-pro

input fields

promptstringrequired

Prompt for image generation or editing (max 5000 chars)

input_urlsarray<string>optional

Array of input image URLs (max 9 items)

aspect_ratioenum<string>optional

Output aspect ratio when no image input provided

enable_sequentialbooleanoptional

Enable sequential/group image mode

nintegeroptional

Number of images (1-4 default; 1-12 if sequential)

resolutionenum<string>optional

Output resolution (4K for text-to-image only)

thinking_modebooleanoptional

Enable thinking mode (text-to-image only)

color_palettearray<object>optional

Custom color theme (3-10 colors, 8 recommended)

bbox_listarray<array>optional

Interactive editing bounding boxes (max 2 per image)

watermarkbooleanoptional

Add watermark to output

seedintegeroptional

Random seed (range 0-2147483647)

Example

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan/2-7-image-pro",
  "input": {
    "prompt": "A cinematic red panda surfing through neon rain at dusk.",
    "input_urls": [
      "https://example.com/file"
    ],
    "aspect_ratio": "1:1",
    "enable_sequential": false,
    "n": 4,
    "resolution": "2K",
    "thinking_mode": false,
    "color_palette": [],
    "bbox_list": "example",
    "watermark": false,
    "seed": 0
  }
}'

Wan 2.2 A14B · Image to Video

POSTImage to Videowan/2-2-a14b-image-to-video-turbo

input fields

image_urlstringrequired

URL of input image; resized and center cropped if aspect ratio mismatch

promptstringrequired

Text guidance for video generation (max 5000 chars)

resolutionenum<string>optional

Output video resolution

enable_prompt_expansionbooleanoptional

Use LLM to expand the prompt with additional details

seednumberoptional

Random seed for reproducibility (0-2147483647)

accelerationenum<string>optional

Acceleration level; more acceleration is faster but lower quality

Example

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan/2-2-a14b-image-to-video-turbo",
  "input": {
    "image_url": "https://example.com/input.jpg",
    "prompt": "Animate the image with natural motion, subtle camera movement, and cinematic lighting.",
    "resolution": "720p",
    "enable_prompt_expansion": false,
    "seed": 0,
    "acceleration": "none"
  }
}'

Wan 2.2 A14B · Text to Video

POSTText to Videowan/2-2-a14b-text-to-video-turbo

input fields

promptstringrequired

Text prompt to guide video generation (max 5000 chars)

resolutionenum<string>optional

Generated video resolution setting

aspect_ratioenum<string>optional

Video output aspect ratio format

enable_prompt_expansionbooleanoptional

LLM-based prompt expansion for additional detail

seednumberoptional

Random seed for reproducible results (0-2147483647)

accelerationenum<string>optional

Trade-off control between speed and quality

Example

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan/2-2-a14b-text-to-video-turbo",
  "input": {
    "prompt": "A cinematic red panda surfing through neon rain at dusk.",
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "enable_prompt_expansion": false,
    "seed": 0,
    "acceleration": "none"
  }
}'

Wan 2.2 Animate Move · Lip Sync

POSTLip Syncwan/2-2-animate-move

input fields

video_urlstringrequired

URL of the input video (mp4, quicktime, matroska; max 10MB)

image_urlstringrequired

URL of input image; resized/center-cropped if aspect ratio mismatch (max 10MB)

resolutionenum<string>optional

Output video resolution selection

Example

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan/2-2-animate-move",
  "input": {
    "video_url": "https://example.com/reference.mp4",
    "image_url": "https://example.com/input.jpg",
    "resolution": "480p"
  }
}'

Wan 2.6 · Image to Video

POSTImage to Videowan/2-6-image-to-video

input fields

promptstringrequired

Text prompts for video generation; supports Chinese and English (max 5000 chars)

image_urlsarray<string>required

Input image files (JPEG/PNG/WebP, max 10MB, min 256x256px)

durationenum<string>optional

Duration of generated video in seconds

resolutionenum<string>optional

Video resolution tier

Example

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan/2-6-image-to-video",
  "input": {
    "prompt": "Animate the image with natural motion, subtle camera movement, and cinematic lighting.",
    "image_urls": [
      "https://example.com/input.jpg"
    ],
    "duration": "5",
    "resolution": "1080p"
  }
}'

Wan 2.6 · Text to Video

POSTText to Videowan/2-6-text-to-video

input fields

promptstringrequired

Text prompts for video generation; supports Chinese and English (max 5000 chars)

durationenum<string>optional

Length of generated video in seconds

resolutionenum<string>optional

Video resolution tier

Example

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan/2-6-text-to-video",
  "input": {
    "prompt": "A cinematic red panda surfing through neon rain at dusk.",
    "duration": "5",
    "resolution": "1080p"
  }
}'

Wan 2.6 · Video to Video

POSTVideo to Videowan/2-6-video-to-video

input fields

promptstringrequired

Text prompt for video transformation (2-5000 chars, Chinese/English)

video_urlsarray<string>required

URLs of source videos to transform (max 3, MP4/QuickTime/Matroska, max 10MB each)

durationenum<string>optional

Generated video duration in seconds

resolutionenum<string>optional

Output video resolution tier

Example

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan/2-6-video-to-video",
  "input": {
    "prompt": "Restyle the source footage with richer lighting, cleaner motion, and a cinematic grade.",
    "video_urls": [
      "https://example.com/reference.mp4"
    ],
    "duration": "5",
    "resolution": "1080p"
  }
}'

Wan 2.6 Flash · Image to Video

POSTImage to Videowan/2-6-flash-image-to-video

input fields

promptstringrequired

Text prompts for video generation (max 1500 chars)

image_urlsarray<string>required

List of image URLs (min 256x256px, max 1 image, 10MB)

durationenum<string>optional

Video duration in seconds

resolutionenum<string>optional

Output video resolution tier

audiobooleanrequired

Whether to generate video with audio

multi_shotsbooleanoptional

Controls shot composition style (single vs multiple shots)

Example

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan/2-6-flash-image-to-video",
  "input": {
    "prompt": "Animate the image with natural motion, subtle camera movement, and cinematic lighting.",
    "image_urls": [
      "https://example.com/input.jpg"
    ],
    "duration": "5",
    "resolution": "1080p",
    "audio": false,
    "multi_shots": false
  }
}'

Wan 2.6 Flash · Video to Video

POSTVideo to Videowan/2-6-flash-video-to-video

input fields

promptstringrequired

Text prompt for video generation (2-1500 chars, Chinese/English)

video_urlsarray<string>required

URLs of videos to transform (max 3 items, up to 10MB each)

durationenum<string>optional

Generated video length in seconds

resolutionenum<string>optional

Video resolution tier

audiobooleanoptional

Whether to generate video with audio

multi_shotsbooleanoptional

Controls shot composition style (single vs multiple shots)

Example

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan/2-6-flash-video-to-video",
  "input": {
    "prompt": "Restyle the source footage with richer lighting, cleaner motion, and a cinematic grade.",
    "video_urls": [
      "https://example.com/reference.mp4"
    ],
    "duration": "5",
    "resolution": "1080p",
    "audio": false,
    "multi_shots": false
  }
}'

Wan 2.5 · Image to Video

POSTImage to Videowan/2-5-image-to-video

input fields

promptstringrequired

Text describing desired video motion (max 800 chars)

image_urlstringrequired

URL of image to use as first frame (JPEG/PNG/WebP, max 10MB)

durationenum<string>required

Generated video duration in seconds

resolutionenum<string>optional

Video output resolution

negative_promptstringoptional

Content to avoid in generation (max 500 chars)

enable_prompt_expansionbooleanoptional

Enable LLM-based prompt rewriting

seedintegeroptional

Random seed for reproducible results

Example

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan/2-5-image-to-video",
  "input": {
    "prompt": "Animate the image with natural motion, subtle camera movement, and cinematic lighting.",
    "image_url": "https://example.com/input.jpg",
    "duration": "5",
    "resolution": "720p",
    "negative_prompt": "example",
    "enable_prompt_expansion": false,
    "seed": 42
  }
}'

Wan 2.5 · Text to Video

POSTText to Videowan/2-5-text-to-video

input fields

promptstringrequired

Text prompt for video generation; supports Chinese and English (max 800 chars)

durationenum<string>required

Duration of the generated video in seconds

aspect_ratioenum<string>optional

Video aspect ratio (landscape, portrait, or square)

resolutionenum<string>optional

Video resolution tier

negative_promptstringoptional

Content to avoid in generation (max 500 chars)

enable_prompt_expansionbooleanoptional

Enable LLM prompt rewriting for improved short prompt results

seedintegeroptional

Random seed for reproducible results

Example

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan/2-5-text-to-video",
  "input": {
    "prompt": "A cinematic red panda surfing through neon rain at dusk.",
    "duration": "5",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "negative_prompt": "example",
    "enable_prompt_expansion": false,
    "seed": 42
  }
}'

Wan 2.7 · Text to Video

POSTText to Videowan/2-7-text-to-video

input fields

promptstringrequired

Positive prompt (1-5000 chars)

negative_promptstringoptional

Negative prompt (max 500 chars)

audio_urlstringoptional

Custom audio track URL for video generation

resolutionenum<string>optional

Video output resolution

ratioenum<string>optional

Video aspect ratio

durationintegeroptional

Video length in seconds (2-15)

prompt_extendbooleanoptional

Enable intelligent prompt rewriting

watermarkbooleanoptional

Add AI-generated watermark to video

seedintegeroptional

Random seed for reproducibility (0-2147483647)

Example

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan/2-7-text-to-video",
  "input": {
    "prompt": "A cinematic red panda surfing through neon rain at dusk.",
    "negative_prompt": "example",
    "audio_url": "https://example.com/reference.mp3",
    "resolution": "1080p",
    "ratio": "16:9",
    "duration": 5,
    "prompt_extend": true,
    "watermark": false,
    "seed": 42
  }
}'

Wan 2.7 · Image to Video

POSTImage to Videowan/2-7-image-to-video

input fields

promptstringrequired

Positive prompt (max 5000 chars)

negative_promptstringoptional

Negative prompt (max 500 chars)

first_frame_urlstringoptional

First frame image URL

last_frame_urlstringoptional

Last frame image URL

first_clip_urlstringoptional

First clip video URL for video continuation

driving_audio_urlstringoptional

Driving audio URL

resolutionenum<string>optional

Video resolution output

durationintegeroptional

Output video duration in seconds (2-15)

prompt_extendbooleanoptional

Enable intelligent prompt rewriting

watermarkbooleanoptional

Add AI-generated watermark to video

seedintegeroptional

Random seed (0-2147483647)

Example

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan/2-7-image-to-video",
  "input": {
    "prompt": "Animate the image with natural motion, subtle camera movement, and cinematic lighting.",
    "negative_prompt": "example",
    "first_frame_url": "example",
    "last_frame_url": "example",
    "first_clip_url": "example",
    "driving_audio_url": "https://example.com/reference.mp3",
    "resolution": "1080p",
    "duration": 5,
    "prompt_extend": true,
    "watermark": false,
    "seed": 42
  }
}'

Wan 2.7 Videoedit · Video Editing

POSTVideo Editingwan/2-7-videoedit

input fields

promptstringoptional

Text prompt describing expected elements and visual features (max 5000 chars)

negative_promptstringoptional

Content that should not appear in the video (max 500 chars)

video_urlstringrequired

URL of source video to edit (mp4/mov, 2-10s, 240-4096px)

reference_imagestringoptional

Optional reference image for character/clothing/style guidance

resolutionenum<string>optional

Output video resolution tier

aspect_ratioenum<string>optional

Output video aspect ratio

durationintegeroptional

Output duration in seconds (0 or 2-10; 0 uses full input)

audio_settingenum<string>optional

Model decides whether to regenerate audio or keep original

prompt_extendbooleanoptional

Whether to enable prompt rewriting/expansion

watermarkbooleanoptional

Add AI generated watermark to lower-right corner

seedintegeroptional

Random seed (0-2147483647)

Example

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan/2-7-videoedit",
  "input": {
    "prompt": "A cinematic red panda surfing through neon rain at dusk.",
    "negative_prompt": "example",
    "video_url": "https://example.com/reference.mp4",
    "reference_image": "https://example.com/input.jpg",
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "duration": 0,
    "audio_setting": "auto",
    "prompt_extend": true,
    "watermark": false,
    "seed": 42
  }
}'

Wan 3.0 Video · Text to Video

POSTText to Videowan/3-0-video

input fields

first_frame_urlstringoptional

Optional start-frame image URL. Cannot be used together with reference_* media.

last_frame_urlstringoptional

Optional end-frame image URL. Requires first_frame_url and cannot be used together with reference_* media.

promptstringoptional

Text prompt describing the desired video. Supports Chinese and English, up to 20,000 characters.

reference_image_urlsarray<string>optional

Reference image URLs, up to 10. Refer to them as Image1, Image2, etc. in the prompt. Cannot be used together with first_frame_url/last_frame_url.

reference_video_urlsarray<string>optional

Reference video URLs, up to 5. Each clip 1-15 seconds, total combined duration <=15 seconds.

reference_audio_urlsarray<string>optional

Reference audio URLs, up to 5. Each clip 1-15 seconds, total combined duration <=15 seconds.

reference_link_urlsarray<string>optional

One public webpage URL. Cannot be used together with reference_file_urls or first/last frame fields.

reference_file_urlsarray<string>optional

One public file URL. Cannot be used together with reference_link_urls or first/last frame fields.

resolutionenum<string>optional

Output video resolution tier.

aspect_ratioenum<string>optional

Output aspect ratio. adaptive lets the model choose from the input and prompt.

durationnumberoptional

Output duration in seconds. Use 2-30, or -1 for smart duration mode.

audiobooleanoptional

Whether the generated video includes audio.

seednumberoptional

Random seed from 0 to 2147483647.

Example

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "wan/3-0-video",
  "input": {
    "first_frame_url": "example",
    "last_frame_url": "example",
    "prompt": "A cinematic red panda surfing through neon rain at dusk.",
    "reference_image_urls": [
      "https://example.com/input.jpg"
    ],
    "reference_video_urls": [
      "https://example.com/reference.mp4"
    ],
    "reference_audio_urls": [
      "https://example.com/reference.mp3"
    ],
    "reference_link_urls": [
      "https://example.com/file"
    ],
    "reference_file_urls": [
      "https://example.com/file"
    ],
    "resolution": "1080P",
    "aspect_ratio": "adaptive",
    "duration": 5,
    "audio": true,
    "seed": 42
  }
}'

Wan 3.0 Prime · Text to Video

POSTText to Videoalibaba/wan-3.0-prime

input fields

promptstringoptional

Text prompt describing the desired video. Supports Chinese and English, up to 20,000 characters.

first_framestringoptional

Optional first-frame image URL for image-to-video.

last_framestringoptional

Optional last-frame image URL. Use together with first_frame for first-to-last-frame video.

reference_image_urlsarray<string>optional

Reference image URLs for all-in-one reference mode. Refer to them as Image1, Image2, etc. in the prompt.

reference_video_urlsarray<string>optional

Reference video URLs for all-in-one reference mode. Use as motion/camera/rhythm cues; videos that contain real people may be rejected upstream. Refer to them as Video1, Video2, etc. in the prompt.

reference_audio_urlsarray<string>optional

Reference audio URLs for voice, music, or ambience guidance.

file_urlstringoptional

Optional public file URL, such as a PPTX, PDF, or other supported media file.

link_urlstringoptional

Optional web link used as source material.

resolutionenum<string>optional

Output video resolution tier.

ratioenum<string>optional

Output aspect ratio. adaptive lets the model choose from the input and prompt.

durationintegeroptional

Output duration in seconds. Use 2-30 for generated clips, or -1 for smart duration mode.

audiobooleanoptional

Whether the generated video includes audio.

seedintegeroptional

Random seed from 0 to 2147483647. Determinism depends on upstream support.

watermarkbooleanoptional

Whether to add a watermark.

Example

cURL

curl -X POST https://api.lithovas.com/api/generate \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "alibaba/wan-3.0-prime",
  "input": {
    "prompt": "A cinematic red panda surfing through neon rain at dusk.",
    "first_frame": "example",
    "last_frame": "example",
    "reference_image_urls": [
      "https://example.com/input.jpg"
    ],
    "reference_video_urls": [
      "https://example.com/reference.mp4"
    ],
    "reference_audio_urls": [
      "https://example.com/reference.mp3"
    ],
    "file_url": "example",
    "link_url": "example",
    "resolution": "1080P",
    "ratio": "adaptive",
    "duration": 5,
    "audio": true,
    "seed": 42,
    "watermark": false
  }
}'