Seedance 2.0 Fast Serverless API
Professional-grade video creation model with native audio, similar to SeeDance 2.0 but faster and cheaper.
POST /v2/seedance-2.0-fast · submit + poll 1# pip install "segmind>=1.1.0"
2# export SEGMIND_API_KEY="YOUR_API_KEY"
3from segmind import SegmindClient, InferenceFailed, InferenceTimeout
4
5# Async (v2) — recommended for long-running / video models.
6# run() blocks up to 600s; submit_async + job.wait(timeout=...) sets a longer
7# deadline and keeps the request_id so you can re-poll later.
8client = SegmindClient() # reads SEGMIND_API_KEY
9payload = {
10 "prompt": "Modern Rural Aesthetics, Cinematic Commercial quality, shot on Sony A7S3 or cinema camera, 4K/8K ultra-high resolution, Extreme Macro photography, natural and transparent lighting, healing ASMR atmosphere, no period drama aesthetics.\n\nScene: A well-organized modern farmhouse open-concept kitchen, lush vegetable garden visible in the background, bright sunny day.\n\nCharacter: Modern lifestyle creator, long black hair casually pinned up with a single wooden hairpin, wearing a comfortable deep-blue cotton-linen set, fresh minimal makeup, focused and serene expression.\n\nShot 1 [00:00-00:05] - The Freshness: High-definition close-up. Morning sunlight hits the plants in side-backlight. The creator's bare hands pluck a vivid red tomato covered in glistening dewdrops from a vine. Razor-sharp focus capturing the fine fuzz on the tomato's surface and a water droplet sliding down. Background is premium blurred green bokeh.\n\nShot 2 [00:05-00:10] - The Craft: Indoor kitchen stove, full of lived-in warmth yet spotlessly clean. The creator chops vegetables with practiced, fluid efficiency. Macro lens captures the blade splitting through the ingredient with juice splashing mid-air. Cut to clay stove firebox with dancing orange flames, warm and authentic light.\n\nShot 3 [00:10-00:15] - The Moment: Wide shot transitioning to medium shot. A beautifully plated home-cooked dish placed on a natural wood table in the courtyard. The creator sits quietly, tucks a loose strand of hair behind her ear, and lifts a bite with chopsticks. Steam rises slowly in backlighting. Still and serene, evoking effortless modern slow-living.",
11 "duration": 5,
12 "resolution": "720p",
13 "aspect_ratio": "16:9",
14 "generate_audio": False,
15 "seed": -1,
16}
17job = client.submit_async("seedance-2.0-fast", **payload)
18print(job.request_id) # available immediately
19try:
20 result = job.wait(timeout=900, interval=2.0)
21 print(result["status"]) # COMPLETED
22 print(result.get("output")) # model output (e.g. video URL)
23except InferenceTimeout as e:
24 print("still running:", e.request_id) # re-poll later with this id
25except InferenceFailed as e:
26 print("failed:", e.detail)
27
28# Fast models (<=600s) can use the one-liner instead:
29# result = segmind.run("seedance-2.0-fast", **payload) 1# pip install "segmind>=1.1.0"
2# export SEGMIND_API_KEY="YOUR_API_KEY"
3from segmind import SegmindClient, InferenceFailed, InferenceTimeout
4
5# Async (v2) — recommended for long-running / video models.
6# run() blocks up to 600s; submit_async + job.wait(timeout=...) sets a longer
7# deadline and keeps the request_id so you can re-poll later.
8client = SegmindClient() # reads SEGMIND_API_KEY
9payload = {
10 "prompt": "Modern Rural Aesthetics, Cinematic Commercial quality, shot on Sony A7S3 or cinema camera, 4K/8K ultra-high resolution, Extreme Macro photography, natural and transparent lighting, healing ASMR atmosphere, no period drama aesthetics.\n\nScene: A well-organized modern farmhouse open-concept kitchen, lush vegetable garden visible in the background, bright sunny day.\n\nCharacter: Modern lifestyle creator, long black hair casually pinned up with a single wooden hairpin, wearing a comfortable deep-blue cotton-linen set, fresh minimal makeup, focused and serene expression.\n\nShot 1 [00:00-00:05] - The Freshness: High-definition close-up. Morning sunlight hits the plants in side-backlight. The creator's bare hands pluck a vivid red tomato covered in glistening dewdrops from a vine. Razor-sharp focus capturing the fine fuzz on the tomato's surface and a water droplet sliding down. Background is premium blurred green bokeh.\n\nShot 2 [00:05-00:10] - The Craft: Indoor kitchen stove, full of lived-in warmth yet spotlessly clean. The creator chops vegetables with practiced, fluid efficiency. Macro lens captures the blade splitting through the ingredient with juice splashing mid-air. Cut to clay stove firebox with dancing orange flames, warm and authentic light.\n\nShot 3 [00:10-00:15] - The Moment: Wide shot transitioning to medium shot. A beautifully plated home-cooked dish placed on a natural wood table in the courtyard. The creator sits quietly, tucks a loose strand of hair behind her ear, and lifts a bite with chopsticks. Steam rises slowly in backlighting. Still and serene, evoking effortless modern slow-living.",
11 "duration": 5,
12 "resolution": "720p",
13 "aspect_ratio": "16:9",
14 "generate_audio": False,
15 "seed": -1,
16}
17job = client.submit_async("seedance-2.0-fast", **payload)
18print(job.request_id) # available immediately
19try:
20 result = job.wait(timeout=900, interval=2.0)
21 print(result["status"]) # COMPLETED
22 print(result.get("output")) # model output (e.g. video URL)
23except InferenceTimeout as e:
24 print("still running:", e.request_id) # re-poll later with this id
25except InferenceFailed as e:
26 print("failed:", e.detail)
27
28# Fast models (<=600s) can use the one-liner instead:
29# result = segmind.run("seedance-2.0-fast", **payload)API Endpoint
https://api.segmind.com/v1/seedance-2.0-fastParameters
promptrequiredstringDescribe the video scene; use Shot 1: / Shot 2: for multi-shot or image 1 / video 1 for omni-reference. Best for cinematic narration or product demos.
aspect_ratiooptionalstringOutput dimensions: 16:9 for widescreen, 9:16 for mobile Reels, 1:1 for feed posts, 21:9 for cinematic.
"16:9""16:9""9:16""1:1""4:3""3:4""21:9""adaptive"durationoptionalintegerVideo length in seconds: 4, 5, 6, 8, 10, 12, or 15; -1 for auto. Use 5s for social posts, 10-15s for product demos.
545678910111213first_frame_urloptionalstring (uri)Image URL to anchor the starting frame; mutually exclusive with reference_images. Best for product shots and character-led scenes.
generate_audiooptionalbooleanEnable native audio co-generation (dialogue, SFX, ambient, music); set true for final delivery, false for draft iterations.
falselast_frame_urloptionalstring (uri)Image URL to define the final frame; requires first_frame_url set. Use for scene transitions or story resolution.
reference_audiosoptionalstring[]Up to 3 reference audio files (MP3). Cite as 'audio 1' in your prompt. Cannot be used with text+audio only — include an image or video input too.
reference_imagesoptionalstring[]Up to 9 image URLs for style or character consistency; cite as image 1 in prompt. Fewer references yield stronger influence.
reference_videosoptionalstring[]Up to 3 reference videos (2-15 seconds each) for motion/style transfer. Cite as 'video 1' in your prompt. Requests with reference videos are billed at the video-to-video token rate.
resolutionoptionalstringOutput resolution: 720p recommended for production; 480p for faster previews or low-bandwidth delivery.
"720p""480p""720p"return_last_frameoptionalbooleanReturn the final frame as a separate image URL; useful for chaining clips or extracting scene-end stills.
falseseedoptionalintegerInteger for reproducible output; -1 generates a new random seed each run. Fix seed when iterating on prompt changes.
-1Range: -1 - 2147483647skip_moderationoptionalbooleanBypass BytePlus content moderation pre-filter. Useful when generating artistic content or faces that may trigger false positives. Baseline BytePlus safety policies still apply.
falseResponse Type
Returns: Video
Asynchronous requests (v2)
Use Async for video, long-running (>~60s), or high-concurrency workloads; Sync is simplest for fast image & LLM calls. Async submits a request and you poll it to completion.
- 1
POST /v2/seedance-2.0-fastSubmit — returns request_id, status_url, response_url
- 2
GET /v2/requests/{id}/statusPoll — until COMPLETED or FAILED
- 3
GET /v2/requests/{id}Result — final response body
Status states
- A FAILED request is served as HTTP 422 — the body still carries the error detail.
- An unknown or expired request_id returns HTTP 404.
- Results are retained for 1 hour, then expire.
- Content / RAI blocks surface as FAILED, not a separate state.
- Track completion by polling the status endpoint.
Common Error Codes
The API returns standard HTTP status codes. Detailed error messages are provided in the response body.
Bad Request
Invalid parameters or request format
Unauthorized
Missing or invalid API key
Forbidden
Insufficient permissions
Not Found
Model or endpoint not found
Insufficient Credits
Not enough credits to process request
Rate Limited
Too many requests
Server Error
Internal server error
Bad Gateway
Service temporarily unavailable
Timeout
Request timed out