Skip to main content
Model ID 
seedance-2-0-260128-upscale
Calling method: async

​
Seedance 2.0 API Usage Guide

​
Overview

Seedance 2.0 is BytePlus’s flagship video generation model. It supports text-to-video (T2V), image-to-video (I2V) using first/last frame conditioning, and reference-to-video (R2V) using reference images, videos, or audio.

​
Authentication

Authorization: Bearer YOUR_API_KEY

​
Submit Video Generation Request

​
Endpoint

POST /api/v1/ie/requestqueue/apikey/requests

​
Request Format (T2V)

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-260128",
    "payload": {
      "prompt": "A majestic eagle soaring over snowy mountains at sunset",
      "duration": 5,
      "resolution": "720p",
      "ratio": "16:9",
      "generate_audio": true
    }
  }'

​
Request Format (I2V — 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-2-0-260128",
    "payload": {
      "first_frame": "https://example.com/frame.jpg",
      "prompt": "Camera slowly pans upward",
      "duration": 5,
      "resolution": "720p",
      "ratio": "16:9"
    }
  }'

​
Request Format (R2V — reference images)

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-260128",
    "payload": {
      "reference_images": ["https://example.com/ref1.jpg"],
      "prompt": "Cinematic slow motion",
      "duration": 7,
      "resolution": "720p",
      "ratio": "16:9"
    }
  }'

​
Request Parameters

ParameterTypeRequiredDescriptionDefault
payload.promptstringNo*Text description. Optional for I2V/R2V""
payload.first_frameimage URLNo*First frame image URL (I2V)—
payload.last_frameimage URLNoLast frame image URL (I2V)—
payload.reference_imagesimage URL[]No*Reference image URLs (R2V, max 9)—
payload.reference_videosvideo URL[]No*Reference video URLs (R2V, max 3)—
payload.reference_audiosaudio URL[]NoReference audio URLs (R2V, max 3)—
payload.durationintegerNoVideo length in seconds (4–15)5
payload.resolutionenumNoOutput resolution: 480p / 720p / 1080p"720p"
payload.ratioenumNoAspect ratio"adaptive"
payload.generate_audiobooleanNoGenerate audio tracktrue
payload.watermarkbooleanNoAdd watermarkfalse
payload.seedintegerNoReproducibility seed (-1 = random)—
payload.web_searchbooleanNoEnrich prompt with web searchfalse
*At least one of prompt, first_frame, reference_images, or reference_videos must be provided.

​
Response

{
  "request_id": "abc123",
  "model": "seedance-2-0-260128",
  "status": "success",
  "outcome": {
    "media_urls": [{"id": "0", "url": "https://storage.googleapis.com/..."}],
    "thumbnail_image_url": "https://storage.googleapis.com/..."
  }
}

​
Pricing (per second of video)

ResolutionPrice / second
480p$0.056
720p$0.122
1080p$0.299

​
Check Request Status

GET /api/v1/ie/requestqueue/apikey/requests/{request_id}