Model ID

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

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

Overview

Wan-AI_Wan2.1-I2V-14B-720P is a comprehensive and open video foundation model that transforms static images into dynamic videos. After thousands of rounds of human evaluations, this model has outperformed both closed-source and open-source alternatives, achieving state-of-the-art performance.

Key Features:

SOTA Performance: Consistently outperforms existing open-source models and state-of-the-art commercial solutions across multiple benchmarks
High Definition: Creates high-quality videos at 720P resolution
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
Creating dynamic presentations from still photos
Bringing artwork and photographs to life
Marketing and advertising content

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-720P",
    "payload": {
      "prompt": "A majestic eagle soaring through a mountain landscape with dramatic motion and wind effects",
      "path_to_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-720P”
`payload.prompt`	string	Yes	Detailed text description of the desired video content, motion and style	-	Required
`payload.path_to_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-720P",
  "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-720P",
  "status": "success",
  "is_public": false,
  "payload": {
    "prompt": "A majestic eagle soaring through a mountain landscape with dramatic motion and wind effects",
    "path_to_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-720P

Example

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

Get Model Information

Endpoint

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

Example

curl -X GET "https://api.example.com/api/v1/apikey/models/Wan-AI_Wan2.1-I2V-14B-720P" \
  -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-720P",
    "other-model-1",
    "other-model-2"
  ]
}

Video Specifications

Duration: 5-10 seconds
Resolution: Fixed at 720P (1280x720)
Quality: High definition with excellent detail and clarity

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
High Definition Benefits:
- Better detail preservation
- Sharper motion sequences
- Professional quality output

Parameter Examples

High-Quality Landscape Animation

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

Professional Portrait Animation

{
  "prompt": "A person walking through a forest with flowing hair and natural movement",
  "path_to_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_to_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_to_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_to_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_to_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_to_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: 720P (1280x720)
VRAM Requirement: 24GB+ recommended (supports multi-GPU inference)

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
High Definition: This 720P model provides superior quality for professional use
Hardware Requirements: Ensure adequate GPU resources for optimal performance

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-720P 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

​High-Quality Landscape Animation

​Professional 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-720P 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

High-Quality Landscape Animation

Professional Portrait Animation

Artistic Transformation

Product Animation

Nature Animation

Advanced Features

Prompt Extension

Reproducible Results

Model Architecture Details

Best Practices

Image Input Guidelines

Image Requirements