Model ID

Wan-AI_Wan2.1-I2V-14B-480P

Wan-AI_Wan2.1-I2V-14B-480P API Usage Guide

Overview

Wan-AI_Wan2.1-I2V-14B-480P is a comprehensive and open video foundation model that transforms static images into dynamic videos. This 480P-optimized version offers advantages in terms of fast generation and excellent quality, making it ideal for efficient video creation workflows.

Key Features:

SOTA Performance: Consistently outperforms existing open-source models and state-of-the-art commercial solutions across multiple benchmarks
Fast Generation: Optimized for 480P resolution providing faster generation times while maintaining excellent quality
Consumer-GPU Friendly: More accessible for consumer-grade hardware with lower VRAM requirements
Visual Text Generation: Capable of generating both Chinese and English text with robust text generation capabilities
Multi-GPU Support: Optimized for both single and multi-GPU inference using FSDP + xDiT USP technology

Use Cases:

Animating static images efficiently
Creating dynamic presentations from still photos
Bringing artwork and photographs to life
Rapid prototyping for video content
Marketing and advertising content creation

Authentication

All API requests require authentication using an API key. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Submit Video Generation Request

Endpoint

POST /api/v1/apikey/requests

Request Format

curl -X POST "https://api.example.com/api/v1/apikey/requests" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Wan-AI_Wan2.1-I2V-14B-480P",
    "payload": {
      "prompt": "A majestic eagle soaring through a mountain landscape with dramatic motion and wind effects",
      "path_input_image": "your_image_data_here",
      "video_length": 10,
      "prompt_extend": true,
      "seed": 42
    }
  }'

Request Parameters

Parameter	Type	Required	Description	Default	Constraints
`model`	string	Yes	Model identifier	-	Must be “Wan-AI_Wan2.1-I2V-14B-480P”
`payload.prompt`	string	Yes	Detailed text description of the desired video content, motion and style	-	Required
`payload.path_input_image`	string	Yes	Input image to be transformed into a video	-	Required
`payload.video_length`	integer	No	Length of the generated video in seconds	5	Options: 5, 10
`payload.prompt_extend`	boolean	No	Enable advanced prompt extension for better results	false	true/false
`payload.seed`	integer	No	Seed for reproducible results	-1	-1 to 2147483647

Response

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "Wan-AI_Wan2.1-I2V-14B-480P",
  "status": "queued",
  "created_at": 1750442925,
  "updated_at": 1750442925,
  "queued_at": 1750442925
}

Check Request Status

Endpoint

GET /api/v1/apikey/requests/{request_id}

Example

curl -X GET "https://api.example.com/api/v1/apikey/requests/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "org_id": "your-org-id",
  "model": "Wan-AI_Wan2.1-I2V-14B-480P",
  "status": "success",
  "is_public": false,
  "payload": {
    "prompt": "A majestic eagle soaring through a mountain landscape with dramatic motion and wind effects",
    "path_input_image": "your_image_data_here",
    "video_length": 10,
    "prompt_extend": true,
    "seed": 42
  },
  "outcome": {
    "video_url": "https://storage.googleapis.com/bucket/generated-video.mp4",
    "thumbnail_image_url": "https://storage.googleapis.com/bucket/thumbnail.jpg"
  },
  "qworker_id": "worker-123",
  "created_at": 1750442925,
  "updated_at": 1750442930,
  "queued_at": 1750442925
}

Request Status Values

Status	Description
`queued`	Request is waiting to be processed
`processing`	Video generation is in progress
`success`	Video generation completed successfully
`failed`	Video generation failed
`cancelled`	Request was cancelled

List Your Requests

Endpoint

GET /api/v1/apikey/requests?model_id=Wan-AI_Wan2.1-I2V-14B-480P

Example

curl -X GET "https://api.example.com/api/v1/apikey/requests?model_id=Wan-AI_Wan2.1-I2V-14B-480P" \
  -H "Authorization: Bearer YOUR_API_KEY"

Get Model Information

Endpoint

GET /api/v1/apikey/models/Wan-AI_Wan2.1-I2V-14B-480P

Example

curl -X GET "https://api.example.com/api/v1/apikey/models/Wan-AI_Wan2.1-I2V-14B-480P" \
  -H "Authorization: Bearer YOUR_API_KEY"

List Available Models

Endpoint

GET /api/v1/apikey/models

Example

curl -X GET "https://api.example.com/api/v1/apikey/models" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "model_ids": [
    "Wan-AI_Wan2.1-I2V-14B-480P",
    "other-model-1",
    "other-model-2"
  ]
}

Video Specifications

Duration: 5-10 seconds
Resolution: Fixed at 480P (832x480)
Quality: Excellent quality optimized for fast generation

Tips for Better Results

High-Quality Input Images: Use clear, well-lit images with good composition
Detailed Prompts: Provide comprehensive descriptions of desired motion and style
Prompt Extension: Enable for enhanced results with more detailed scene generation
Seed Usage:
- Use -1 for random generation (default)
- Use specific values (0-2147483647) for reproducible results
Video Length:
- 5 seconds: Quick animations, social media content
- 10 seconds: More complex motion sequences, detailed storytelling
Image Requirements:
- Use high-quality images with clear subjects
- Avoid overly complex or cluttered images
- Ensure good lighting and contrast

Parameter Examples

Landscape Animation

{
  "prompt": "A serene mountain lake with gentle ripples and flowing water motion",
  "path_input_image": "your_image_data_here",
  "video_length": 10,
  "prompt_extend": true,
  "seed": 12345
}

Portrait Animation

{
  "prompt": "A person walking through a forest with flowing hair and natural movement",
  "path_input_image": "your_image_data_here",
  "video_length": 5,
  "prompt_extend": false,
  "seed": -1
}

Artistic Transformation

{
  "prompt": "A painting coming to life with flowing brushstrokes and dynamic colors",
  "path_input_image": "your_image_data_here",
  "video_length": 10,
  "prompt_extend": true,
  "seed": 42
}

Product Animation

{
  "prompt": "A product rotating smoothly with subtle lighting changes and professional presentation",
  "path_input_image": "your_image_data_here",
  "video_length": 5,
  "prompt_extend": false,
  "seed": 789
}

Nature Animation

{
  "prompt": "Flowers blooming with gentle swaying motion and natural wind effects",
  "path_input_image": "your_image_data_here",
  "video_length": 10,
  "prompt_extend": true,
  "seed": -1
}

Advanced Features

Prompt Extension

Enable advanced prompt extension for enhanced scene generation:

{
  "prompt": "A magical forest scene with flowing elements",
  "path_input_image": "your_image_data_here",
  "prompt_extend": true,
  "video_length": 10
}

Reproducible Results

Use specific seeds for consistent video generation:

{
  "prompt": "A flowing river with gentle motion",
  "path_input_image": "your_image_data_here",
  "seed": 42,
  "video_length": 10
}

Model Architecture Details

Architecture: 14B parameter Diffusion Transformer
Dimension: 5120
Heads: 40
Layers: 40
Resolution: 480P (832x480)
VRAM Requirement: Lower than 720P variant, more accessible for consumer GPUs

Best Practices

Image Quality: Use high-resolution, well-composed images for best results
Motion Description: Be specific about the type of motion you want to see
Prompt Extension: Enable for complex scenes requiring detailed generation
Seed Management: Use consistent seeds for series of related videos
Fast Generation: This 480P model is optimized for quick turnaround times
Consumer Hardware: More accessible for users with standard GPU setups

Image Input Guidelines

Image Requirements

Quality: High-resolution images work best
Composition: Clear subjects with good framing
Lighting: Well-lit images with good contrast

Documentation Index

​Wan-AI_Wan2.1-I2V-14B-480P API Usage Guide

​Overview

​Key Features:

​Use Cases:

​Authentication

​Submit Video Generation Request

​Endpoint

​Request Format

​Request Parameters

​Response

​Check Request Status

​Endpoint

​Example

​Response

​Request Status Values

​List Your Requests

​Endpoint

​Example

​Get Model Information

​Endpoint

​Example

​List Available Models

​Endpoint

​Example

​Response

​Video Specifications

​Tips for Better Results

​Parameter Examples

​Landscape Animation

​Portrait Animation

​Artistic Transformation

​Product Animation

​Nature Animation

​Advanced Features

​Prompt Extension

​Reproducible Results

​Model Architecture Details

​Best Practices

​Image Input Guidelines

​Image Requirements

Wan-AI_Wan2.1-I2V-14B-480P API Usage Guide

Overview

Key Features:

Use Cases:

Authentication

Submit Video Generation Request

Endpoint

Request Format

Request Parameters

Response

Check Request Status

Endpoint

Example

Response

Request Status Values

List Your Requests

Endpoint

Example

Get Model Information

Endpoint

Example

List Available Models

Endpoint

Example

Response

Video Specifications

Tips for Better Results

Parameter Examples

Landscape Animation

Portrait Animation

Artistic Transformation

Product Animation

Nature Animation

Advanced Features

Prompt Extension

Reproducible Results

Model Architecture Details

Best Practices

Image Input Guidelines

Image Requirements