Model ID

vidu-q3-pro-i2v

Calling method: async

Vidu Q3 Pro Image-to-Video API Usage Guide

Overview

Vidu Q3 Pro is an image-to-video model designed to generate high-quality 1080p video content from a starting image and a descriptive text prompt. It supports custom durations up to 16 seconds and optional audio generation. This model is hosted externally by Vidu and accessible via the GMI Cloud request queue.

Authentication

All API requests require authentication using your API key. Include it 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": "vidu-q3-pro-i2v",
    "payload": {
      "prompt": "A cinematic drone shot moving forward from this scene",
      "images": "https://example.com/start_frame.jpg",
      "duration": 5,
      "audio": true,
      "seed": 42
    }
  }'

Request Parameters

Parameter	Type	Required	Description	Default	Constraints
`images`	string	Yes	An image to be used as the start frame of the generated video. Accepts public URL or Base64; formats: png, jpeg, jpg, webp.	-	Exactly 1 image
`prompt`	string	Yes	Text prompt (max 2000 characters) describing the desired video.	-	Max 2000 chars
`duration`	integer	No	Video duration in seconds.	5	Min: 1, Max: 16
`audio`	boolean	No	Whether to have audio in the video or not.	true	-
`seed`	integer	No	Random seed. If not set, a random seed is used.	null	-

Response

{
  "request_id": "8fbb88gd-cd78-5132-0g2c-07c4ge944225",
  "model": "vidu-q3-pro-i2v",
  "status": "queued",
  "created_at": 1772184500
}

Check Request Status

Endpoint

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

Response

{
  "request_id": "8fbb88gd-cd78-5132-0g2c-07c4ge944225",
  "model": "vidu-q3-pro-i2v",
  "status": "success",
  "outcome": {
    "media_urls": [
      {
        "id": "0",
        "url": "https://storage.googleapis.com/gmi-generated-assets/.../vidu_output_0.mp4"
      }
    ]
  }
}

Request Status Values

Status	Description
`queued`	Request is waiting in the queue
`processing`	Video is currently being rendered
`success`	Video generation completed
`failed`	Generation failed (check logs for details)
`cancelled`	Request was manually cancelled

Pricing

Pricing Type: Per second of video
Price: $0.16 per second
Unit: Video Second

Tips for Better Results

High-Quality Inputs: Use clear, high-resolution starting images for the best results.
Prompt Alignment: Describe the motion, lighting, and camera movement you want to see applied to the starting image.
Audio Sync: Keep the audio toggle true if your prompt includes elements that produce sound.

Overview

Model Quickstarts

Agents

Coding Tools

AgentBox Guides

Migration Guides

vidu-q3-pro-i2v

Vidu Q3 Pro Image-to-Video API Usage Guide

Overview

Authentication

Submit Video Generation Request

Base URL

Endpoint

Request Format

Request Parameters

Response

Check Request Status

Endpoint

Response

Request Status Values

Pricing

Tips for Better Results

​Vidu Q3 Pro Image-to-Video API Usage Guide

​Overview

​Authentication

​Submit Video Generation Request

​Base URL

​Endpoint

​Request Format

​Request Parameters

​Response

​Check Request Status

​Endpoint

​Response

​Request Status Values

​Pricing

​Tips for Better Results

Vidu Q3 Pro Image-to-Video API Usage Guide

Overview

Authentication

Submit Video Generation Request

Base URL

Endpoint

Request Format

Request Parameters

Response

Check Request Status

Endpoint

Response

Request Status Values

Pricing

Tips for Better Results