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

wan2.6-i2v API Usage Guide

Overview

wan2.6-i2v converts images into videos with intelligent shot scheduling, optional prompt extension, and audio support. Requests are sent through the request-queue API and results are fetched by 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.6-i2v",
    "payload": {
      "prompt": "Slow cinematic pan around a futuristic tower at sunset with neon accents",
      "img_url": "https://example.com/reference-image.jpg",
      "audio_url": null,
      "negative_prompt": "blurry, low quality, distorted",
      "resolution": "1080P",
      "duration": 10,
      "prompt_extend": true,
      "shot_type": "single",
      "audio": true,
      "watermark": false,
      "seed": 987654321
    }
  }'

Request Parameters

ParameterTypeRequiredDescriptionDefaultConstraints
modelstringYesModel identifier-Must be "wan2.6-i2v"
payload.promptstringNoText prompt guiding motion/styling""Max 1500 characters
payload.img_urlstring (URL)YesReference image-360–2000 px width/height, ≤10 MB, 1 image
payload.audio_urlstring (URL)Nowav/mp3 audio to align withnull3–30s, ≤15 MB; excess trimmed to duration
payload.negative_promptstringNoWhat to avoid in the video""Max 500 characters
payload.resolutionstring (enum)NoOutput resolution tier”1080P”Options: “720P”, “1080P”; aspect ratio follows input image
payload.durationinteger (enum)NoVideo length in seconds5Options: 5, 10, 15
payload.prompt_extendbooleanNoLLM rewrites prompt for richer detailtrue-
payload.shot_typestring (enum)NoSingle vs multi-shot sequencing”single”Options: “single”, “multi”; applied when prompt_extend is true
payload.audiobooleanNoAuto-generate audio if audio_url not settrue-
payload.watermarkbooleanNoAdd fixed AI Generated watermarkfalse-
payload.seedintegerNoRandom seed for reproducibility-0–2147483647

Response

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "model": "wan2.6-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.6-i2v",
  "status": "success",
  "is_public": false,
  "payload": {
    "prompt": "Slow cinematic pan around a futuristic tower at sunset with neon accents",
    "img_url": "https://example.com/reference-image.jpg",
    "audio_url": null,
    "negative_prompt": "blurry, low quality, distorted",
    "resolution": "1080P",
    "duration": 10,
    "prompt_extend": true,
    "shot_type": "single",
    "audio": 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.6-i2v

Example

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

List Available Models

Endpoint

GET /api/v1/apikey/models

Example

curl -X GET "https://api.example.com/api/v1/apikey/models" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
    "model_ids": [
        "wan2.6-t2v",
        "wan2.6-i2v",
        "wan2.6-r2v"
    ]
}