Skip to main content

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.

Model ID
Wan-AL_Wan2.1-T2V-14B

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:
Authorization: Bearer YOUR_API_KEY

Submit Video Generation Request

Endpoint

POST /api/v1/ie/requestqueue/apikey/requests

Request Format

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

ParameterTypeRequiredDescriptionDefaultConstraints
promptstringYesDetailed text description of the desired video content, motion, and style-Required
video_resolutionstringNoResolution of the generated video”832*480”Options: “832480”, “1280720”
video_lengthintegerNoLength of the generated video in seconds5Options: 5, 10
prompt_extendbooleanNoEnable advanced prompt extension for better resultsfalsetrue/false
seedintegerNoSeed for reproducible results. Use -1 for random result-1-1 to 2147483647

Response

{
  "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

curl --location 'https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests/550e8400-e29b-41d4-a716-446655440000' \
--header 'Authorization: Bearer YOUR_API_KEY'

Response

{
  "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

StatusDescription
queuedRequest is waiting to be processed
processingVideo generation is in progress
successVideo generation completed successfully
failedVideo generation failed
cancelledRequest was cancelled

List Your Requests

Endpoint

GET /api/v1/ie/requestqueue/apikey/requests?model_id=Wan-AI_Wan2.1-T2V-14B

Example

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

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

curl --location 'https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/models' \
--header 'Authorization: Bearer YOUR_API_KEY'

Response

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

Pricing

  • Pricing Type: Video length based pricing
  • Unit: Second
Example cost calculation:
  • 5-second video: 5 × 0.08=0.08 = 0.40
  • 10-second video: 10 × 0.08=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

{
  "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

{
  "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

{
  "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

{
  "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:
{
  "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:
{
  "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