> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gmicloud.ai/llms.txt
> Use this file to discover all available pages before exploring further.

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

> API usage guide for Wan-AI_Wan2.1-I2V-14B-720P.

{/* source_model_id: Wan-AI_Wan2.1-I2V-14B-720P */}

{/* source_updated_at: 1782169234 */}

**Model ID**

```bash theme={null}
Wan-AI_Wan2.1-I2V-14B-720P
```

**Calling method:** async

# 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:

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```

## Submit Video Generation Request

### Endpoint

```
POST /api/v1/apikey/requests
```

### Request Format

```bash theme={null}
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

```json theme={null}
{
  "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

```bash theme={null}
curl -X GET "https://api.example.com/api/v1/apikey/requests/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### Response

```json theme={null}
{
  "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

```bash theme={null}
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

```bash theme={null}
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

```bash theme={null}
curl -X GET "https://api.example.com/api/v1/apikey/models" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### Response

```json theme={null}
{
  "model_ids": [
    "Wan-AI_Wan2.1-I2V-14B-720P",
    "other-model-1",
    "other-model-2"
  ]
}
```

## Pricing

* **Pricing Type**: Video length based pricing
* **Price**: \$0.60 per second
* **Unit**: Second

Example cost calculation:

* 5-second video: 5 × $0.60 = $3.00
* 10-second video: 10 × $0.60 = $6.00

## Video Specifications

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

## Tips for Better Results

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

## Parameter Examples

### High-Quality Landscape Animation

```json theme={null}
{
  "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

```json theme={null}
{
  "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

```json theme={null}
{
  "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

```json theme={null}
{
  "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

```json theme={null}
{
  "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:

```json theme={null}
{
  "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:

```json theme={null}
{
  "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

1. **Image Quality**: Use high-resolution, well-composed images for best results
2. **Motion Description**: Be specific about the type of motion you want to see
3. **Prompt Extension**: Enable for complex scenes requiring detailed generation
4. **Seed Management**: Use consistent seeds for series of related videos
5. **High Definition**: This 720P model provides superior quality for professional use
6. **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
* **Content**: Avoid overly complex or cluttered scenes