> ## 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-T2V-14B

> API usage guide for Wan-AI_Wan2.1-T2V-14B.

{/* source_model_id: Wan-AI_Wan2.1-T2V-14B */}

{/* source_updated_at: 1782169220 */}

**Model ID**

```bash theme={null}
Wan-AI_Wan2.1-T2V-14B
```

**Calling method:** async

# Wan-AL\_Wan2.1-T2V-14B API Usage Guide

## Overview

**Wan-AL\_Wan2.1-T2V-14B** is a comprehensive and open video foundation model that pushes the boundaries of text-to-video generation. 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 both 480P and 720P resolution
* **Visual Text Generation**: First video model 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:

* Creative content generation
* Storytelling and visualization
* Educational materials and presentations
* 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/ie/requestqueue/apikey/requests
```

### Request Format

```bash theme={null}
curl --location 'https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data '{
    "model": "Wan-AL_Wan2.1-T2V-14B",
    "payload": {
        "prompt": "A majestic eagle soaring through a mountain landscape at sunset with dramatic lighting",
        "video_resolution": "832x480",
        "video_length": 5,
        "prompt_extend": true,
        "seed": -1
    }
}'
```

# Request Parameters

| Parameter         | Type    | Required | Description                                                               | Default    | Constraints                    |
| ----------------- | ------- | -------- | ------------------------------------------------------------------------- | ---------- | ------------------------------ |
| prompt            | string  | Yes      | Detailed text description of the desired video content, motion, and style | -          | Required                       |
| video\_resolution | string  | No       | Resolution of the generated video                                         | "832\*480" | Options: "832*480", "1280*720" |
| video\_length     | integer | No       | Length of the generated video in seconds                                  | 5          | Options: 5, 10                 |
| prompt\_extend    | boolean | No       | Enable advanced prompt extension for better results                       | false      | true/false                     |
| seed              | integer | No       | Seed for reproducible results. Use -1 for random result                   | -1         | -1 to 2147483647               |

### Response

```json theme={null}
{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "Wan-AI_Wan2.1-T2V-14B",
  "status": "queued",
  "created_at": 1750442925,
  "updated_at": 1750442925,
  "queued_at": 1750442925
}
```

## Check Request Status

### Endpoint

```
GET /api/v1/ie/requestqueue/apikey/requests/{request_id}
```

### Example

```bash theme={null}
curl --location 'https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests/550e8400-e29b-41d4-a716-446655440000' \
--header '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-T2V-14B",
  "status": "success",
  "is_public": false,
  "payload": {
    "prompt": "A majestic eagle soaring through a mountain landscape at sunset with dramatic lighting",
    "video_resolution": "1280*720",
    "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"
  },
  "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/ie/requestqueue/apikey/requests?model_id=Wan-AI_Wan2.1-T2V-14B
```

### Example

```bash theme={null}
curl --location 'https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests?model_id=Wan-AI_Wan2.1-T2V-14B' \
--header 'Authorization: Bearer YOUR_API_KEY'
```

## Get Model Information

### Endpoint

```
GET /api/v1/ie/requestqueue/apikey/models/Wan-AI_Wan2.1-T2V-14B
```

### Example

```bash theme={null}
curl --location 'https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/models/Wan-AI_Wan2.1-T2V-14B' \
--header 'Authorization: Bearer YOUR_API_KEY'
```

## List Available Models

### Endpoint

```
GET /api/v1/ie/requestqueue/apikey/models
```

### Example

```bash theme={null}
curl --location 'https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/models' \
--header 'Authorization: Bearer YOUR_API_KEY'
```

### Response

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

# Pricing

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

Example cost calculation:

* 5-second video: 5 × $0.08 = $0.40
* 10-second video: 10 × $0.08 = $0.80

## Video Specifications

* **Duration**: 5, 10 seconds
* **Resolutions**:
  * 480P (832×480) – economical option
  * 720P (1280×720) – high definition
* **Quality**: State-of-the-art performance with advanced text generation capabilities

## Tips for Better Results

1. **Detailed Prompts**: Provide comprehensive descriptions including scene, motion, lighting, and style
2. **Resolution Selection**:
   * Use 480P for faster generation and testing
   * Use 720P for high-quality final content
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 content, social media
   * 10 seconds: More complex scenes, detailed storytelling
6. **Text Generation**: This model excels at generating videos with text elements in both Chinese and English

## Parameter Examples

### High-Quality Landscape Scene

```json theme={null}
{
  "prompt": "A serene mountain lake reflecting snow-capped peaks at golden hour with gentle ripples on the water surface",
  "video_resolution": "1280*720",
  "video_length": 10,
  "prompt_extend": true,
  "seed": 12345
}
```

### Reproducible Content

```json theme={null}
{
  "prompt": "A futuristic cityscape with flying cars and neon lights at night",
  "video_resolution": "1280*720",
  "video_length": 10,
  "prompt_extend": true,
  "seed": 42
}
```

### Text-Heavy Content

```json theme={null}
{
  "prompt": "A classroom scene with a teacher writing mathematical equations on a blackboard, clear readable text",
  "video_resolution": "1280*720",
  "video_length": 10,
  "prompt_extend": true,
  "seed": -1
}
```

### Creative Animation

```json theme={null}
{
  "prompt": "An abstract geometric pattern with flowing colors and dynamic movement",
  "video_resolution": "1280*720",
  "video_length": 5,
  "prompt_extend": false,
  "seed": 789
}
```

## Advanced Features

### Prompt Extension

Enable advanced prompt extension for enhanced scene generation:

```json theme={null}
{
  "prompt": "A magical forest with glowing mushrooms",
  "prompt_extend": true,
  "video_resolution": "1280*720",
  "video_length": 10
}
```

### Reproducible Results

Use specific seeds for consistent video generation:

```json theme={null}
{
  "prompt": "A flowing river in a forest",
  "seed": 42,
  "video_resolution": "1280*720",
  "video_length": 10
}
```

# Best Practices

1. **Detailed Descriptions**: Include specific details about motion, lighting, atmosphere
2. **Text Elements**: This model excels at generating videos with readable text
3. **Resolution Choice**: Balance quality vs. generation time based on your needs
4. **Seed Management**: Use consistent seeds for series of related videos
5. **Prompt Extension**: Enable for complex scenes requiring detailed generation