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-2-0-fast-260128 API Usage Guide
Overview
seedance-2-0-fast-260128 is the next-generation video generation model supporting text, first/last frame images, reference images, reference videos, reference audios.
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-2-0-fast-260128",
"payload": {
"prompt": "A lone astronaut walks across a crimson Martian landscape at sunset.",
"first_frame": "https://example.com/frame.jpg",
"duration": 8,
"resolution": "720p",
"ratio": "16:9",
"seed": 42,
"watermark": false,
"generate_audio": true,
"web_search": false
}
}'
Request Parameters
| Parameter | Type | Required | Description | Default | Constraints |
|---|
prompt | string | Yes | Text description of the video | "" | Required |
duration | integer | No | Duration in seconds | 5 | 4–15 |
resolution | enum | No | Output resolution | "720p" | "480p", "720p", "1080p" |
ratio | enum | No | Aspect ratio | "16:9" | "16:9", "4:3", "1:1", "3:4", "9:16", "21:9", "adaptive" |
seed | integer | No | Random seed for reproducibility | null | 0–4294967295 |
watermark | boolean | No | Whether to embed a watermark | false | true / false |
generate_audio | boolean | No | Whether to synthesize audio | true | true / false |
web_search | boolean | No | Whether to enable web search grounding | false | true / false |
first_frame | image | No | First frame image for I2V | "" | Publicly accessible URL |
last_frame | image | No | Last frame image for I2V | "" | Publicly accessible URL |
reference_images | array | No | Reference images (URLs) | [] | Array of publicly accessible URLs |
reference_videos | array | No | Reference videos (URLs) | [] | Array of publicly accessible URLs |
reference_audios | array | No | Reference audio files (URLs) | [] | Array of publicly accessible URLs |
reference_asset_ids | array | No | Pre-uploaded asset IDs | [] | Array of asset ID strings |
Response
{
"request_id": "c1c5a812-3c44-4c77-b02c-91c934abcd12",
"model": "seedance-2-0-fast-260128",
"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/c1c5a812-3c44-4c77-b02c-91c934abcd12" \
-H "Authorization: Bearer YOUR_API_KEY"
Response
{
"request_id": "c1c5a812-3c44-4c77-b02c-91c934abcd12",
"org_id": "your-org-id",
"model": "seedance-2-0-fast-260128",
"status": "success",
"payload": {
"prompt": "A lone astronaut walks across a crimson Martian landscape at sunset.",
"duration": 8,
"resolution": "720p",
"ratio": "16:9",
"seed": 42,
"watermark": false,
"generate_audio": true
},
"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-2-0-fast-260128
Endpoint
GET /api/v1/ie/requestqueue/apikey/models/seedance-2-0-fast-260128
Tips for Better Results
- Detailed Prompts: More descriptive text yields better visuals
- Use First/Last Frame: Anchor the start and end for tighter I2V consistency
- Adaptive Ratio: Use
adaptive to let the model choose the best ratio for your content
- Seeds for Control: Use a fixed seed for reproducible outputs
- Audio Sync: Enable
generate_audio for immersive, sound-matched videos
- Extended Duration: Take advantage of up to 15 seconds for complex scenes
Examples
Text-to-Video
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-2-0-fast-260128",
"payload": {
"prompt": "A thunderstorm rolls over a medieval castle at night, lightning illuminating stone towers",
"duration": 12,
"resolution": "1080p",
"ratio": "21:9",
"generate_audio": true
}
}'
Image-to-Video with First and Last 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-2-0-fast-260128",
"payload": {
"prompt": "The flower slowly blooms, petals unfurling in morning light",
"first_frame": "https://example.com/bud.jpg",
"last_frame": "https://example.com/bloom.jpg",
"duration": 6,
"resolution": "720p",
"ratio": "1:1",
"generate_audio": false
}
}'
With Reference Assets
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-2-0-fast-260128",
"payload": {
"prompt": "The character walks through a neon-lit alley",
"reference_asset_ids": ["asset-id-abc123"],
"reference_images": ["https://example.com/style-ref.jpg"],
"duration": 10,
"resolution": "720p",
"ratio": "adaptive"
}
}'
