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 
vidu-q3-pro-t2v

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

​
Overview

Vidu Q3 Pro is a text-to-video model designed to generate high-quality 1080p video content from descriptive prompts. 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-t2v",
    "payload": {
      "prompt": "Cinematic shot of a futuristic city with flying vehicles, sunset lighting, high detail",
      "duration": 5,
      "audio": true,
      "seed": 42
    }
  }'

​
Request Parameters

ParameterTypeRequiredDescriptionDefaultConstraints
promptstringYesText description of the desired video.-Max 2000 chars
durationintegerNoLength of the video in seconds.5Min: 1, Max: 16
audiobooleanNoWhether to include generated audio.false-
seedintegerNoSpecific seed for reproducible results.null-

​
Response

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

​
Request Status Values

StatusDescription
queuedRequest is waiting in the queue
processingVideo is currently being rendered
successVideo generation completed
failedGeneration failed (check logs for details)
cancelledRequest was manually cancelled

​
Tips for Better Results

  1. Prompt Detail: Describe lighting, camera movement, and atmosphere for better cinematic results.
  2. Audio Sync: Enabling audio works best when the prompt includes sound-producing elements (e.g., “thunderstorm”, “crowded street”).