Skip to main content
POST
/
v1
/
videos
/
generations
curl --request POST \
  --url https://gccai.heqingsong.uk/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "wan2.6",
    "prompt": "A cute cat running on the grass",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01J9HA7JPQ9A0Z6JZ3V8M9W6PZ"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://gccai.heqingsong.uk/llms.txt

Use this file to discover all available pages before exploring further.

curl --request POST \
  --url https://gccai.heqingsong.uk/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "wan2.6",
    "prompt": "A cute cat running on the grass",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01J9HA7JPQ9A0Z6JZ3V8M9W6PZ"
    }
  ]
}

​
Authorization

​
Authorization
string
required
All API endpoints require Bearer Token authenticationGet your API Key:Visit the API Key Management Page to get your API KeyAdd it to the request header:
Authorization: Bearer YOUR_API_KEY

​
Request Parameters

​
model
string
required
Video generation model name, fixed as wan2.6
​
prompt
string
required
Video content descriptionRequired for text-to-video mode. Describe scenes, actions, and styles in detail for better resultsExample: "A cute cat stretching in the sunlight"
​
image_urls
array<url>
Reference image URL array (only 1 image supported)Required for image-to-video mode. Supports publicly accessible image URLsExample: ["https://example.com/image.jpg"]
The system automatically selects text-to-video or image-to-video mode based on whether image_urls is included
​
negative_prompt
string
Negative prompt describing unwanted contentExample: "blurry, low quality, distorted"
​
aspect_ratio
string
default:"16:9"
Video aspect ratioOptions:
  • 16:9 - Landscape (default)
  • 9:16 - Portrait
  • 1:1 - Square
  • 4:3 - Landscape
  • 3:4 - Portrait
Default: 16:9
Not supported in image-to-video mode
​
resolution
string
default:"720p"
Video resolutionOptions:
  • 720p - Standard (default)
  • 1080p - High definition
Default: 720p
480p resolution is not supported
Billed per second. Pricing varies by resolution. Please refer to the model marketplace for specific pricing
​
duration
integer
default:"5"
Video duration (seconds)Supported values: 5, 10, 15 seconds onlyDefault: 5
​
seed
integer
Random seed for reproducible resultsExample: 12345
​
prompt_extend
boolean
Whether to automatically extend the promptWhen enabled, the system will automatically optimize and enrich your prompt
​
audio
boolean
Whether to automatically add audioWhen enabled, the system will generate matching audio for the video
​
audio_url
string
Specified audio URLTakes priority over the audio parameter
Audio duration cannot exceed video duration. If audio is shorter than video duration, the first part of the video will have sound while the rest will be silent.
​
shot_type
string
Shot typeOptions:
  • single - Single shot
  • multi - Multiple shots
​
watermark
boolean
Whether to add watermark
​
template
string
Effect template name for image-to-video special effects mode
When using effects mode:
  • Only one image is required (passed via image_urls)
  • No prompt is needed (model ignores the prompt field)
General Effects:
  • squish - Squish & Squeeze
  • rotation - Rotation
  • poke - Poke
  • inflate - Balloon Inflate
  • dissolve - Molecular Dissolve
  • melt - Heat Wave Melt
  • icecream - Ice Cream Planet
  • flying - Magic Levitation
Single Person Effects:
  • carousel - Time Carousel
  • singleheart - Love You
  • dance1 - Swing Moment
  • dance2 - Dance Move
For more effects, refer to Alibaba Wanxiang Template Documentation

​
Resolution and Aspect Ratio Combinations

Aspect RatioDescription720p Size1080p Size
16:9Landscape (default)1280×7201920×1080
9:16Portrait720×12801080×1920
1:1Square960×9601440×1440
4:3Landscape1088×8321632×1248
3:4Portrait832×10881248×1632

​
Response

​
code
integer
Response status code, 200 on success
​
data
array
Response data array

​
Use Cases

​
Case 1: Text-to-Video (Simple Request)

{
  "model": "wan2.6",
  "prompt": "A cute cat stretching in the sunlight"
}

​
Case 2: Text-to-Video (Full Parameters)

{
  "model": "wan2.6",
  "prompt": "A cute cat running on the grass",
  "negative_prompt": "blurry, low quality, distorted",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": 5,
  "seed": 12345,
  "prompt_extend": true,
  "audio": true,
  "shot_type": "single",
  "watermark": false
}

​
Case 3: Image-to-Video

{
  "model": "wan2.6",
  "prompt": "A kitten running on the ground",
  "image_urls": ["https://upload.gccai.ai/f/gccai-models-images/9998233432754770-c059992d-9b01-47d5-810d-ea0502ac9279-image_task_01KD7SSXDBCEWZ869D6PF249ZW_0.png"],
  "resolution": "1080p",
  "duration": 10
}

​
Case 4: Image-to-Video (Base64 Image)

{
  "model": "wan2.6",
  "prompt": "Make the cat stand up and walk",
  "image_urls": ["data:image/png;base64,iVBORw0KGgo..."],
  "duration": 5
}

​
Mode Description

​
Text-to-Video

  • prompt parameter is required
  • image_urls parameter is not needed

​
Image-to-Video

  • image_urls parameter is required (only 1 image supported)
  • prompt parameter is optional, used to describe expected actions
The system automatically selects the mode based on whether image_urls is included in the request
Query Task ResultsVideo generation is an async task that returns a task_id upon submission. Use the Get Task Status endpoint to query generation progress and results.