Skip to main content
Model ID 
seedance-2-0-fast-260128

​
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

​
Request Format

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

ParameterTypeRequiredDescriptionDefaultConstraints
promptstringYesText description of the video""Required
durationintegerNoDuration in seconds54–15
resolutionenumNoOutput resolution"720p""480p", "720p", "1080p"
ratioenumNoAspect ratio"16:9""16:9", "4:3", "1:1", "3:4", "9:16", "21:9", "adaptive"
seedintegerNoRandom seed for reproducibilitynull0–4294967295
watermarkbooleanNoWhether to embed a watermarkfalsetrue / false
generate_audiobooleanNoWhether to synthesize audiotruetrue / false
web_searchbooleanNoWhether to enable web search groundingfalsetrue / false
first_frameimageNoFirst frame image for I2V""Publicly accessible URL
last_frameimageNoLast frame image for I2V""Publicly accessible URL
reference_imagesarrayNoReference images (URLs)[]Array of publicly accessible URLs
reference_videosarrayNoReference videos (URLs)[]Array of publicly accessible URLs
reference_audiosarrayNoReference audio files (URLs)[]Array of publicly accessible URLs
reference_asset_idsarrayNoPre-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

StatusDescription
queuedRequest is waiting to be processed
processingVideo generation is in progress
successVideo generation completed successfully
failedVideo generation failed
cancelledRequest 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

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"
    }
  }'