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 
wan2.7-i2v

​
wan2.7-i2v API Usage Guide

​
Overview

wan2.7-i2v converts images into videos with improved visual fidelity, temporal consistency, and flexible media inputs. It supports first frame, last frame, driving audio, and first clip as media references, with continuous duration from 2 to 15 seconds. 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-i2v",
    "payload": {
      "prompt": "Slow cinematic pan around a futuristic tower at sunset with neon accents",
      "first_frame": "https://example.com/start-frame.jpg",
      "last_frame": "https://example.com/end-frame.jpg",
      "negative_prompt": "blurry, low quality, distorted",
      "resolution": "1080P",
      "duration": 10,
      "prompt_extend": true,
      "watermark": false,
      "seed": 987654321
    }
  }'

​
Request Parameters

ParameterTypeRequiredDescriptionDefaultConstraints
promptstringNoText prompt guiding motion/styling""Max 1500 characters
negative_promptstringNoWhat to avoid in the video""Max 500 characters
first_frameimage (URL)NoStarting frame imagenull360–2000 px, ≤10 MB, 1 image
last_frameimage (URL)NoEnding frame imagenull360–2000 px, ≤10 MB, 1 image
driving_audioaudio (URL)NoAudio to drive video generationnullwav/mp3, 3–30s, ≤15 MB
first_clipvideo (URL)NoVideo clip used as starting referencenull1 video
resolutionstring (enum)NoOutput resolution tier”1080P”Options: "720P", "1080P"
durationintegerNoVideo length in seconds52–15
prompt_extendbooleanNoLLM rewrites prompt for richer detailtrue-
watermarkbooleanNoAdd fixed AI Generated watermarkfalse-
seedintegerNoRandom seed for reproducibility-0–2147483647

​
Response

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "wan2.7-i2v",
  "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-i2v",
  "status": "success",
  "is_public": false,
  "payload": {
    "prompt": "Slow cinematic pan around a futuristic tower at sunset with neon accents",
    "first_frame": "https://example.com/start-frame.jpg",
    "last_frame": "https://example.com/end-frame.jpg",
    "negative_prompt": "blurry, low quality, distorted",
    "resolution": "1080P",
    "duration": 10,
    "prompt_extend": true,
    "watermark": false,
    "seed": 987654321
  },
  "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=wan2.7-i2v

​
Example

curl -X GET "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests?model_id=wan2.7-i2v" \
  -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

  1. Provide clear reference frames: High-quality first/last frame images yield smoother interpolation
  2. Detailed prompts: Describe motion, camera movement, and atmosphere explicitly
  3. Prompt Extension: Keep prompt_extend enabled for short prompts
  4. Driving Audio: Supply driving_audio for precise audio-visual synchronization
  5. First Clip: Use first_clip to provide motion reference from an existing video