Seedance 2 Legacy IDs

Compatibility reference for the legacy seedance-2 and seedance-2-fast model IDs

POST /api/generate/submit

cURL

seedance-2-text-to-video

curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "seedance-2",
  "callback_url": "https://your-domain.com/callback",
  "input": {
    "prompt": "A cinematic city reveal after rain, smooth dolly shot, reflective streets, natural ambience.",
    "resolution": "4k",
    "duration": 5,
    "aspect_ratio": "auto",
    "generate_audio": true,
    "return_last_frame": true,
    "web_search": false,
    "seed": 42
  }
}
'

200

{
  "code": 200,
  "data": {
    "task_id": "task-unified-1757165031-uyujaw3d",
    "status": "not_started",
    "created_time": "2026-04-17T10:30:00"
  }
}

1. After submission, a task_id is returned immediately. If you provide a callback_url, Vidgo sends a POST request to that URL when the task reaches finished or failed.
2. You can always fetch the latest task result through the unified Query Task Status endpoint.

Seedance 2 Legacy IDs

This page documents legacy model IDs kept for compatibility. New integrations should use the model-specific Seedance 2.0 public model pages in the navigation.

Seedance 2 is ByteDance’s multimodal video family for API-based generation. On Vidgo API, you can choose between seedance-2 for higher fidelity and seedance-2-fast for lower-latency generation, while keeping a single submit and status API.

Available Models

• seedance-2: Higher-quality video generation with multimodal references and native audio support
• seedance-2-fast: Faster generation path with the same submit schema and lower per-second pricing

Supported Generation Modes

• Text to Video: Generate directly from a prompt
• First and Last Frame: Guide motion between one or two frame anchors via image_urls
• Multimodal Reference: Add reference images, videos, and audio through reference_image_urls, reference_video_urls, and reference_audio_urls

Input Rules

• resolution: seedance-2 supports 480p, 720p, 1080p, and 4k; seedance-2-fast supports 480p and 720p
• duration accepts integer values from 4 to 15
• image_urls supports up to 2 items
• image_urls is mutually exclusive with all reference_*_urls fields
• reference_image_urls supports up to 9 items; reference_video_urls and reference_audio_urls each support up to 3 items
• reference_audio_urls requires at least one reference_image_urls or reference_video_urls item
• Total reference inputs across image, video, and audio fields can contain at most 12 files
• aspect_ratio supports auto, 1:1, 21:9, 4:3, 3:4, 16:9, and 9:16
• generate_audio, return_last_frame, and web_search are optional boolean controls

Seedance 2 vs Seedance 1.5 Pro vs Seedance 1.0 Pro

• Seedance 2 adds multimodal reference image, video, and audio guidance with first and last frame control in one API shape.
• Seedance 1.5 Pro focuses on high-quality text-to-video and image-to-video generation with optional audio but without the same multimodal reference set.
• Seedance 1.0 Pro remains a strong option for earlier Seedance use cases, but Seedance 2 expands creative control and API flexibility for newer production pipelines.

Authorizations

Authorization · string · header · required

All API endpoints require Bearer Token authentication

Get your API Key:

Visit the API Key Management Page to get your API Key

Add it to the request header:

Authorization: Bearer YOUR_API_KEY

Body

application/json

model · enum<string> · required

Seedance 2 model identifier

Available options: seedance-2, seedance-2-fast

input · object · required

Input parameters for Seedance 2 generation. image_urls cannot be combined with any reference_*_urls field.

Show child attributes

callback_url · string<uri>

Optional webhook callback URL for result notifications.

Example:

"https://your-domain.com/callback"

Response

200 - application/json

Task submitted successfully

code · integer · required

HTTP status code

Example:

200

data · object · required

Show child attributes