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 
pixverse-v5.5-i2v

​
Pixverse v5.5 Image-to-Video API Usage Guide

​
Overview

Pixverse v5.5 Image-to-Video (I2V) is an advanced model designed to animate static images using text guidance. It supports cinematic camera controls, high-quality motion consistency, and integrated audio generation to bring static frames to life.

​
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)

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": "pixverse-v5.5-i2v",
    "payload": {
      "image_url": "https://example.com/source_image.jpg",
      "prompt": "The character turns their head and smiles, cinematic lighting",
      "negative_prompt": "distorted face, static, morphing",
      "duration": "5",
      "aspect_ratio": "16:9",
      "quality": "1080p",
      "style": "none",
      "thinking_type": "auto",
      "generate_audio_switch": true,
      "generate_multi_clip_switch": true
    }
  }'

​
Request Parameters

ParameterTypeRequiredDescriptionDefaultConstraints
image_urlstringYesURL of the source image (JPG, PNG, WebP).-Must be a public URL.
promptstringYesDescription of the motion or action.-Describe the change.
negative_promptstringNoElements to avoid in the animation.""-
durationenumYesVideo length in seconds.55, 8, 10 (10s unavailable at 1080p).
aspect_ratioenumYesFrame dimensions.16:916:9, 9:16, 1:1, 4:3, 3:4.
qualityenumYesVideo resolution.540p360p, 540p, 720p, 1080p.
thinking_typeenumNoInternal prompt reasoning.autoenabled, disabled, auto.
generate_audio_switchbooleanNoGenerate synchronized SFX/BGM.false-
generate_multi_clip_switchbooleanNoEnable cinematic camera changes.false-
seedintegerNoSeed for reproducibility.-0 - 2147483647.
Visual Style Options: none (Default), anime, 3d_animation, clay, comic, cyberpunk.

​
Check Request Status

​
Endpoint

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

​
Example Response

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "org_id": "pixverse",
  "model": "pixverse-v5.5-i2v",
  "status": "success",
  "payload": {
    "image_url": "https://example.com/source_image.jpg",
    "prompt": "The character turns their head..."
  },
  "outcome": {
    "video_url": "https://storage.googleapis.com/bucket/generated-i2v-video.mp4"
  },
  "created_at": 1750442925,
  "updated_at": 1750442930
}

​
Request Status Values

StatusDescription
queuedRequest is waiting in the queue
processingVideo is being animated
successAnimation complete; URL is in outcome
failedRequest failed