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
seedance-1-5-pro-251215 API Usage Guide
Overview
seedance-1-5-pro-251215 is a professional-grade video generation model that supports both text-to-video and image-to-video workflows. It is designed for flexible, high-quality video synthesis with customizable duration, resolution, aspect ratio, and camera behavior.
This model is ideal for creators who need cinematic, controllable outputs with reproducibility via seeds.
Key Features
- Text-to-Video & Image-to-Video: Supports pure text prompts and optionally an initial first frame
- Flexible Duration: 3–12 seconds of generated video
- Multiple Resolutions: 480p, 720p, or 1080p outputs
- Aspect Ratios: Standard and cinematic ratios supported (16:9, 9:16, 21:9, etc.)
- Camera Controls: Option to fix or allow camera motion
- Reproducibility: Seed parameter ensures deterministic output
- Watermark Control: Choose whether to embed watermark
Authentication
All API requests require authentication using an 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
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": "seedance-1-0-pro-250528",
"payload": {
"prompt": "The head gradually rises, revealing the climber`s back.",
"first_frame": "https://storage.googleapis.com/gmi-video-assests-prod/public-assets/person-walking-winter-snow-boots-1193959625-770x533-1_jpg.jpeg",
"duration": 8,
"resolution": "720p",
"ratio": "16:9",
"camerafixed": false,
"seed": 42,
"watermark": false
}
}'
Request Parameters
| Parameter | Type | Required | Description | Default | Constraints |
|---|
prompt | string | Yes | Text description with optional flags like --ratio, --resolution, --duration, --camerafixed | "" | Required |
duration | integer | No | Duration in seconds | 5 | 3–12 |
resolution | enum | No | Output resolution | ”720p” | Options: "480p", "720p", "1080p" |
ratio | enum | No | Aspect ratio of output | ”16:9” | Options: "16:9", "9:16", "4:3", "3:4", "21:9", "1:1" |
camerafixed | boolean | No | Whether camera stays fixed | false | true / false |
seed | integer | No | Random seed for reproducibility | null | 0–4294967295 |
watermark | boolean | No | Whether to include watermark | false | true / false |
first_frame | image | No | First frame image for Image-to-Video (optional for Pro) | "" | Must be a publicly accessible image url |
Response
{
"request_id": "c1c5a812-3c44-4c77-b02c-91c934abcd12",
"model": "seedance-1-0-pro-250528",
"status": "queued",
"created_at": 1750442925,
"updated_at": 1750442925,
"queued_at": 1750442925
}
Check Request Status
Endpoint
GET /api/v1/ie/requestqueue/apikey/requests/{request_id}
Example
curl -X GET "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests/550e8400-e29b-41d4-a716-446655440000" \
-H "Authorization: Bearer YOUR_API_KEY"
Response
{
"request_id": "c1c5a812-3c44-4c77-b02c-91c934abcd12",
"org_id": "your-org-id",
"model": "seedance-1-0-pro-250528",
"status": "success",
"payload": {
"prompt": "A futuristic city skyline glowing with neon lights, camera panning slowly across tall skyscrapers",
"duration": 8,
"resolution": "720p",
"ratio": "16:9",
"camerafixed": false,
"seed": 42,
"watermark": false
},
"outcome": {
"video_url": "https://storage.googleapis.com/bucket/generated-video.mp4",
"thumbnail_image_url": "https://storage.googleapis.com/bucket/thumbnail.jpg"
},
"created_at": 1750442925,
"updated_at": 1750442930,
"queued_at": 1750442925
}
Request Status Values
| Status | Description |
|---|
queued | Request is waiting to be processed |
processing | Video generation is in progress |
success | Video generation completed successfully |
failed | Video generation failed |
cancelled | Request was cancelled |
List Your Requests
Endpoint
GET /api/v1/ie/requestqueue/apikey/requests?model_id=seedance-1-0-pro-250528
Example
curl -X GET "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests?model_id=seedance-1-0-pro-250528" \
-H "Authorization: Bearer YOUR_API_KEY"
Endpoint
GET /api/v1/ie/requestqueue/apikey/models/seedance-1-0-pro-250528
Example
curl -X GET "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/models/seedance-1-0-pro-250528" \
-H "Authorization: Bearer YOUR_API_KEY"
List Available Models
Endpoint
GET /api/v1/apikey/models
Example
curl -X GET "https://api.example.com/api/v1/apikey/models" \
-H "Authorization: Bearer YOUR_API_KEY"
Response
{
"model_ids": [
"seedance-1-0-pro-250528",
"Minimax-Hailuo-02",
"Wan-AI_Wan2.2-I2V-A14B",
"Wan-AI_Wan2.2-T2V-A14B",
"Veo3-Fast",
"Luma-Ray2",
"Veo3",
"Kling-Text2Video-V2.1-Master",
"Kling-Image2Video-V2.1-Standard",
"Kling-Image2Video-V2.1-Pro",
"Kling-Image2Video-V2.1-Master",
"Kling-Text2Video-V1.6-Standard",
"Kling-Text2Video-V2-Master",
"Kling-Image2Video-V2-Master",
"Kling-Image2Video-V1.6-Standard",
"Kling-Image2Video-V1.6-Pro",
"Wan-AI_Wan2.1-I2V-14B-720P",
"Wan-AI_Wan2.1-I2V-14B-480P",
"Wan-AI_Wan2.1-FLF2V-14B-720P",
"Wan-AI_Wan2.1-T2V-14B"
]
}
Tips for Better Results
- Detailed Prompts: More descriptive text yields better visuals
- Use First Frame for I2V: Provide a starting image for higher temporal consistency
- Seeds for Control: Use a fixed seed for reproducibility
- Camerafixed: Set true to keep perspective locked
- Resolution vs Cost: Higher resolutions take longer and may cost more
Examples
Cinematic Cityscape
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": "seedance-1-0-pro-250528",
"payload": {
"prompt": "A cyberpunk city drenched in rain, with flying cars weaving between neon-lit towers",
"duration": 10,
"resolution": "1080p",
"ratio": "21:9",
"camerafixed": true
}
}'
Image-to-Video (First Frame)
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": "seedance-1-0-pro-250528",
"payload": {
"prompt": "Extend this frame into a surreal animation of a floating island",
"first_frame": "https://example.com/myimage.jpg",
"duration": 6,
"resolution": "720p"
}
}'