> ## 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-1-0-pro-fast-251015 > API usage guide for seedance-1-0-pro-fast-251015. {/* source_model_id: seedance-1-0-pro-fast-251015 */} {/* source_updated_at: 1782168238 */} **Model ID** ```bash theme={null} seedance-1-0-pro-fast-251015 ``` **Calling method:** async # seedance-1-0-pro-fast-251015 API Usage Guide ## Overview **seedance-1-0-pro-fast-251015** 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: ```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-1-0-pro-fast-251015", "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 ```json theme={null} { "request_id": "c1c5a812-3c44-4c77-b02c-91c934abcd12", "model": "seedance-1-0-pro-fast-251015", "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/550e8400-e29b-41d4-a716-446655440000" \ -H "Authorization: Bearer YOUR_API_KEY" ``` ### Response ```json theme={null} { "request_id": "c1c5a812-3c44-4c77-b02c-91c934abcd12", "org_id": "your-org-id", "model": "seedance-1-0-pro-fast-251015", "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-fast-251015 ``` ### Example ```bash theme={null} curl -X GET "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests?model_id=seedance-1-0-pro-fast-251015" \ -H "Authorization: Bearer YOUR_API_KEY" ``` ## Get Model Information ### Endpoint ``` GET /api/v1/ie/requestqueue/apikey/models/seedance-1-0-pro-fast-251015 ``` ### Example ```bash theme={null} curl -X GET "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/models/seedance-1-0-pro-fast-251015" \ -H "Authorization: Bearer YOUR_API_KEY" ``` ## List Available Models ### Endpoint ``` GET /api/v1/apikey/models ``` ### Example ```bash theme={null} curl -X GET "https://api.example.com/api/v1/apikey/models" \ -H "Authorization: Bearer YOUR_API_KEY" ``` ### Response ## Pricing * **Pricing Type**: Video length based pricing * **Unit Price**: TBD * **8-second video**: ## Tips for Better Results 1. **Detailed Prompts**: More descriptive text yields better visuals 2. **Use First Frame for I2V**: Provide a starting image for higher temporal consistency 3. **Seeds for Control**: Use a fixed seed for reproducibility 4. **Camerafixed**: Set true to keep perspective locked 5. **Resolution vs Cost**: Higher resolutions take longer and may cost more ## Examples ### Cinematic Cityscape ```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-1-0-pro-fast-251015", "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) ```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-1-0-pro-fast-251015", "payload": { "prompt": "Extend this frame into a surreal animation of a floating island", "first_frame": "https://example.com/myimage.jpg", "duration": 6, "resolution": "720p" } }' ```