> ## 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. # seedance-2-0-fast-260128 > API usage guide for seedance-2-0-fast-260128. {/* source_model_id: seedance-2-0-fast-260128 */} {/* source_updated_at: 1782346636 */} **Model ID** ```bash theme={null} seedance-2-0-fast-260128 ``` **Calling method:** async # 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: ```bash theme={null} 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 ```bash theme={null} 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"` | | `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 ```json theme={null} { "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 ```bash theme={null} 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 ```json theme={null} { "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 ``` ## Get Model Information ### Endpoint ``` GET /api/v1/ie/requestqueue/apikey/models/seedance-2-0-fast-260128 ``` ## Tips for Better Results 1. **Detailed Prompts**: More descriptive text yields better visuals 2. **Use First/Last Frame**: Anchor the start and end for tighter I2V consistency 3. **Adaptive Ratio**: Use `adaptive` to let the model choose the best ratio for your content 4. **Seeds for Control**: Use a fixed seed for reproducible outputs 5. **Audio Sync**: Enable `generate_audio` for immersive, sound-matched videos 6. **Extended Duration**: Take advantage of up to 15 seconds for complex scenes ## Examples ### Text-to-Video ```bash theme={null} 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": "720p", "ratio": "21:9", "generate_audio": true } }' ``` ### Image-to-Video with First and Last Frame ```bash theme={null} 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 ```bash theme={null} 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" } }' ```