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-q2-pro-flfv

​
Vidu Q2 Pro First-Last-Frame-to-Video API Usage Guide

​
Overview

Vidu Q2 Pro is a first-last-frame-to-video model designed to generate 720p video content transitioning between a specified starting and ending frame, guided by a descriptive text prompt. It supports custom durations up to 8 seconds. 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
```text

## Submit Video Generation Request

### Base URL
https://console.gmicloud.ai 

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

### Request Format

```bash
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-q2-pro-flfv",
    "payload": {
      "prompt": "A smooth transition from a blooming flower to a withered state",
      "first_frame_image": "https://example.com/start_frame.jpg",
      "last_frame_image": "https://example.com/end_frame.jpg",
      "duration": 5,
      "seed": 42
    }
  }'

​
Request Parameters

ParameterTypeRequiredDescriptionDefaultConstraints
first_frame_imagestringYesImage URL to be the first frame of the generated video.-1 image
last_frame_imagestringYesImage URL to be the last frame of the video.-1 image
promptstringYesText prompt (max 2000 characters) describing the desired video.-Max 2000 chars
durationintegerNoVideo duration in seconds.5Min: 1, Max: 8
seedintegerNoRandom seed. If not set, a random seed is used.null-

​
Response

{
  "request_id": "8fbb88gd-cd78-5132-0g2c-07c4ge944225",
  "model": "vidu-q2-pro-flfv",
  "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-q2-pro-flfv",
  "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. Provide Clear Frames: Ensure the first and last frame images have consistent subjects and lighting for smoother transitions.
  2. Logical Prompts: Describe how the transition between the two states should occur.