Model ID

wan2.7-t2v

Calling method: async

wan2.7-t2v API Usage Guide

Overview

wan2.7-t2v is Wan AI’s latest text-to-video model with improved visual quality and more flexible controls. It supports separate resolution and aspect-ratio selection, continuous duration from 2 to 15 seconds, and optional audio-driven generation. Requests are submitted to the request-queue API and results are retrieved via polling.

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

Base URL

https://console.gmicloud.ai

Endpoint

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

Request Format

curl -X POST "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-t2v",
    "payload": {
      "prompt": "A drone shot gliding over a misty forest at sunrise, golden light breaking through the canopy",
      "negative_prompt": "blurry, low quality, distorted",
      "resolution": "1080P",
      "ratio": "16:9",
      "duration": 10,
      "audio_url": null,
      "prompt_extend": true,
      "watermark": false,
      "seed": 12345
    }
  }'

Request Parameters

Parameter	Type	Required	Description	Default	Constraints
`prompt`	string	Yes	Text prompt describing desired video	-	Max 1500 characters
`negative_prompt`	string	No	What to avoid in the video	""	Max 500 characters
`audio_url`	string (URL)	No	wav/mp3 audio to drive the video	null	3–30s, ≤15 MB; excess trimmed to duration
`resolution`	string (enum)	No	Output resolution tier	”1080P”	Options: `"720P"`, `"1080P"`
`ratio`	string (enum)	No	Aspect ratio	”16:9”	Options: `"16:9"`, `"9:16"`, `"1:1"`, `"4:3"`, `"3:4"`
`duration`	integer	No	Video length in seconds	5	2–15
`prompt_extend`	boolean	No	Let LLM rewrite prompt for richer detail	true	-
`watermark`	boolean	No	Add fixed `AI Generated` watermark	false	-
`seed`	integer	No	Random seed for reproducibility	-	0–2147483647

Response

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "wan2.7-t2v",
  "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 -X GET "https://console.gmicloud.ai/api/v1/ie/requestqueue/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": "wan2.7-t2v",
  "status": "success",
  "is_public": false,
  "payload": {
    "prompt": "A drone shot gliding over a misty forest at sunrise, golden light breaking through the canopy",
    "negative_prompt": "blurry, low quality, distorted",
    "resolution": "1080P",
    "ratio": "16:9",
    "duration": 10,
    "prompt_extend": true,
    "watermark": false,
    "seed": 12345
  },
  "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=wan2.7-t2v

Example

curl -X GET "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests?model_id=wan2.7-t2v" \
  -H "Authorization: Bearer YOUR_API_KEY"

List Available Models

Endpoint

GET /api/v1/apikey/models

Example

curl -X GET "https://console.gmicloud.ai/api/v1/apikey/models" \
  -H "Authorization: Bearer YOUR_API_KEY"

Tips for Better Results

Detailed prompts: Describe motion, camera movement, lighting, and atmosphere explicitly
Prompt Extension: Keep prompt_extend enabled for short prompts to let the model enrich them
Negative prompts: Exclude common artifacts like “blurry, low quality, deformed, extra fingers”
Audio-driven: Supply audio_url for precise audio-visual alignment
Seed for reproducibility: Fix a seed value to regenerate consistent results
Flexible duration: Take advantage of 2–15 second range for precise timing control

Overview

Model Quickstarts

Agents

Coding Tools

AgentBox Guides

Migration Guides

wan2.7-t2v

wan2.7-t2v API Usage Guide

Overview

Authentication

Submit Video Generation Request

Base URL

Endpoint

Request Format

Request Parameters

Response

Check Request Status

Endpoint

Example

Response

Request Status Values

List Your Requests

Endpoint

Example

List Available Models

Endpoint

Example

Tips for Better Results

​wan2.7-t2v API Usage Guide

​Overview

​Authentication

​Submit Video Generation Request

​Base URL

​Endpoint

​Request Format

​Request Parameters

​Response

​Check Request Status

​Endpoint

​Example

​Response

​Request Status Values

​List Your Requests

​Endpoint

​Example

​List Available Models

​Endpoint

​Example

​Tips for Better Results

wan2.7-t2v API Usage Guide

Overview

Authentication

Submit Video Generation Request

Base URL

Endpoint

Request Format

Request Parameters

Response

Check Request Status

Endpoint

Example

Response

Request Status Values

List Your Requests

Endpoint

Example

List Available Models

Endpoint

Example

Tips for Better Results