Seedance 2.0 Fast Text-to-Video

seedance-2.0-fast/text-to-video

Seedance 2.0 Fast Text-to-Video turns a written scene into a 4–15 second video without source media. Direct the subject, action, camera, light, atmosphere, and optional audio across 480p or 720p at the lower current Fast rates.

Input

Prompt

134/20000

Resolution

Duration

Aspect ratio

Advanced

Generate audio

Ask the model to generate an audio track with the video.

Return last frame

Keep the video result and request the final frame as an additional file.

Web search

Send the optional web-assisted generation field.

Seed

Output

Idle

Your generated files will appear here

Set the inputs, choose a duration, then run the asynchronous video task.

Continue with

Standard Text-to-Video Image-to-Video Image-to-Video

Examples

One continuous four-second macro tracking shot across a worn oak worktable. A palm-sized fictional brass clockwork beetle with six articulated legs follows one painted-free curved path between three plain wooden blocks. It starts still, walks around the first block, makes one quick right-left correction between the next two blocks, then stops beside a small steel washer. The camera tracks low beside it at constant distance. Preserve the beetle's single oval shell, six legs, exposed rear winding key, scale, route direction, block positions, table grain, and warm workshop light. Use coherent leg contacts, stable body mechanics, and no sliding. Synchronized audio: fine gear ticks, six-leg taps on wood, and one quiet metal click at the stop. No cuts, no people, no other insects, no readable text, no logos, no brands, no products, no advertising, no watermark.

REST API

Quick Start

Authenticate, submit the smallest valid Text-to-Video request, then retrieve the asynchronous video result.

Connect to the Vidgo API

Create an API key, store it only on your server, and send it as a Bearer header.

Endpoint: POSThttps://api.vidgo.ai/api/generate/submit
Authentication: Authorization: Bearer VIDGO_API_KEY

Submit one generation task

Send the exact model ID and required mode fields; success immediately returns task_id.

Submit request

curl --request POST \
  --url "https://api.vidgo.ai/api/generate/submit" \
  --header "Authorization: Bearer $VIDGO_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "seedance-2.0-fast/text-to-video",
  "callback_url": "https://httpbin.org/post",
  "input": {
    "prompt": "One continuous four-second macro tracking shot across a worn oak worktable. A palm-sized fictional brass clockwork beetle with six articulated legs follows one painted-free curved path between three plain wooden blocks. It starts still, walks around the first block, makes one quick right-left correction between the next two blocks, then stops beside a small steel washer. The camera tracks low beside it at constant distance. Preserve the beetle's single oval shell, six legs, exposed rear winding key, scale, route direction, block positions, table grain, and warm workshop light. Use coherent leg contacts, stable body mechanics, and no sliding. Synchronized audio: fine gear ticks, six-leg taps on wood, and one quiet metal click at the stop. No cuts, no people, no other insects, no readable text, no logos, no brands, no products, no advertising, no watermark.",
    "duration": 4,
    "resolution": "480p",
    "aspect_ratio": "16:9",
    "generate_audio": true,
    "seed": 26082703
  }
}'

Wait for the result

Poll only not_started or running, or receive the flat terminal object at callback_url.

Track status

GET https://api.vidgo.ai/api/generate/status/BTTXD9SZOQ62OOWH

Begin near a 2 second polling interval, back off for long tasks, and enforce a timeout. finished and failed are terminal. Handle network failure, request timeout, and task failure separately; callback_url uses the same request contract.

not_startedrunningfinishedfailed

Submit response

{
  "code": 200,
  "data": {
    "task_id": "BTTXD9SZOQ62OOWH",
    "status": "running",
    "created_time": "2026-08-27T14:22:42"
  }
}

Finished response

{
  "code": 200,
  "data": {
    "task_id": "BTTXD9SZOQ62OOWH",
    "status": "finished",
    "progress": 100,
    "created_time": "2026-08-27T14:22:42",
    "error_message": null,
    "files": [
      {
        "file_type": "video",
        "file_url": "https://cdn.vidgo.ai/apis/models/bytedance/seedance-2.0-fast/text-to-video/v1/output.mp4"
      }
    ]
  }
}

Complete runnable example

The example checks HTTP and business codes, task_id, backoff, timeout, terminal states, and result files.

Complete runnable example

set -euo pipefail
: "${VIDGO_API_KEY:?Set VIDGO_API_KEY in your environment}"

REQUEST_BODY=$(cat <<'JSON'
{
  "model": "seedance-2.0-fast/text-to-video",
  "callback_url": "https://httpbin.org/post",
  "input": {
    "prompt": "One continuous four-second macro tracking shot across a worn oak worktable. A palm-sized fictional brass clockwork beetle with six articulated legs follows one painted-free curved path between three plain wooden blocks. It starts still, walks around the first block, makes one quick right-left correction between the next two blocks, then stops beside a small steel washer. The camera tracks low beside it at constant distance. Preserve the beetle's single oval shell, six legs, exposed rear winding key, scale, route direction, block positions, table grain, and warm workshop light. Use coherent leg contacts, stable body mechanics, and no sliding. Synchronized audio: fine gear ticks, six-leg taps on wood, and one quiet metal click at the stop. No cuts, no people, no other insects, no readable text, no logos, no brands, no products, no advertising, no watermark.",
    "duration": 4,
    "resolution": "480p",
    "aspect_ratio": "16:9",
    "generate_audio": true,
    "seed": 26082703
  }
}
JSON
)

SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  --request POST \
  --url "https://api.vidgo.ai/api/generate/submit" \
  --header "Authorization: Bearer $VIDGO_API_KEY" \
  --header "Content-Type: application/json" \
  --data "$REQUEST_BODY")

TASK_ID=$(printf '%s' "$SUBMIT_RESPONSE" | jq -r '.data.task_id // .task_id // empty')
if [ -z "$TASK_ID" ]; then
  printf 'Submit response did not include task_id:
%s
' "$SUBMIT_RESPONSE" >&2
  exit 1
fi

while true; do
  STATUS_RESPONSE=$(curl --silent --show-error --fail-with-body \
    --url "https://api.vidgo.ai/api/generate/status/BTTXD9SZOQ62OOWH" \
    --header "Authorization: Bearer $VIDGO_API_KEY")
  STATUS=$(printf '%s' "$STATUS_RESPONSE" | jq -r '.data.status // .status // empty')

  case "$STATUS" in
    finished)
      printf '%s' "$STATUS_RESPONSE" | jq -r '(.data.files // .files // [])[]?.file_url'
      break
      ;;
    failed)
      printf '%s' "$STATUS_RESPONSE" | jq -r '.data.error_message // .error_message // "Generation failed"' >&2
      exit 1
      ;;
    not_started|running)
      sleep 2
      ;;
    *)
      printf 'Unexpected task status: %s
' "$STATUS" >&2
      exit 1
      ;;
  esac
done

Request Parameters

model and optional callback_url are top-level; generation fields belong in input, and unsupported media is rejected.

Field	Type	Required	Default	Description
model	string	Yes	—	Must equal seedance-2.0-fast/text-to-video.
callback_url	string (URL)	No	—	Public HTTP(S) endpoint for the terminal task object.
input	object	Yes	—	Contains only fields public for this mode.
input.prompt	string	Required	—	Trimmed length 1–20,000; the Playground supplies a mode-specific example.
input.duration	integer	Required	—	Any integer from 4 through 15 inclusive; Playground default 5.
input.resolution	string	Required	720p	480p, 720p; Playground default 720p.
input.aspect_ratio	string	Optional	16:9	auto, 21:9, 16:9, 4:3, 1:1, 3:4, or 9:16; Playground default 16:9.
input.generate_audio	boolean	Optional	true	Boolean. The Playground explicitly sends true by default.
input.return_last_frame	boolean	Optional	false	Boolean. The Playground explicitly sends false by default.
input.web_search	boolean	Optional	false	Boolean. The Playground explicitly sends false by default.
input.seed	integer	Optional	—	Integer with no published range; omitted when empty.
Rejected media fields	—	—	—	image_urls, start_image_url, end_image_url, reference_*_urls, video_url, video_urls

Response Fields

Submission identifies the task; status adds progress, every result file, or failure detail.

Field	Type	Description
code	integer	Business code; success accepts 0 or 200.
message	string	Optional response or error message.
data.task_id	string	Task ID used by the status endpoint.
data.status	string	not_started, running, finished, or failed.
data.created_time	string	Task creation timestamp.
data.progress	integer	Reported completion percentage.
data.files[]	array	All result files in returned order.
data.files[].file_url	string	Direct result URL.
data.files[].file_type	string	Public type such as video or image.
data.files[].watermark_url	string \| null	Watermarked URL when returned by the status service.
data.error_message	string \| null	Failure detail for a failed task.

Task Lifecycle

not_started and running are non-terminal; finished and failed are terminal.

not_started
Accepted and waiting to begin.
running
Generation is active; continue polling with backoff.
finished
Successful terminal state; read every file.
failed
Failed terminal state; read error_message and stop.

Polling and Errors

Authentication401 means the Bearer key is missing or invalid; correct it before retrying.
Validation400 means the payload violates this endpoint contract; fix the named field.
Insufficient balanceTreat balance errors separately and show required credits and USD.
Polling and timeoutBegin around 2 seconds and back off; network failure and client timeout are not task failed.
Terminal states and callbackStop on finished or failed; callback_url can receive the same task as a flat terminal object.

Model Specifications

Specification	Value	Details
Input mode	Text only	All media fields are rejected.
Output	Asynchronous video task	May return multiple files, all preserved in order.
Resolution	480p / 720p	Fast rejects 1080p and 4K.
Duration	4–15 whole seconds	Inclusive boundaries.
Aspect ratio	7 values	Auto plus six fixed ratios.
Billing basis	Output seconds	480p: 14 credits ($0.070)/s; 720p: 28 credits ($0.140)/s

View Seedance 2.0 Fast Text-to-Video API documentation

Seedance 2.0 Fast Text-to-Video

Why Choose This?

Start from text alone.Describe a complete shot without sending image, video, or audio media.
Lower current rates.Use 480p or 720p for cost-conscious iteration and repeated trials.
Continuous duration control.Select any whole-second duration from 4 through 15 instead of a short preset list.
Explicit advanced controls.Request audio, a returned last frame, web assistance, and an optional integer seed.

Parameters

Parameter	Requirement	Description
prompt	Required	Trimmed length 1–20,000; the Playground supplies a mode-specific example.
duration	Required	Any integer from 4 through 15 inclusive; Playground default 5.
resolution	Required	480p, 720p; Playground default 720p. Default`720p480p`
aspect_ratio	Optional	auto, 21:9, 16:9, 4:3, 1:1, 3:4, or 9:16; Playground default 16:9. Default`16:99:161:121:94:33:4auto`
generate_audio	Optional	Boolean. The Playground explicitly sends true by default. Default`true`
return_last_frame	Optional	Boolean. The Playground explicitly sends false by default. Default`false`
web_search	Optional	Boolean. The Playground explicitly sends false by default. Default`false`
seed	Optional	Integer with no published range; omitted when empty.

How to Use

Define subject and settingState who or what appears, the setting, and details that must remain visible.
Direct the movementUse concrete verbs and separate subject motion from camera motion.
Set the outputChoose 480p, 720p, a 4–15 second duration, and the applicable composition.
Review advanced controlsConfirm audio, last-frame, web-assistance, and seed choices.
Submit and trackRun the request, then poll the task ID or process its terminal callback.

Pricing

One credit equals $0.005. Credits equal output duration times the selected resolution rate. Advanced options, image count, and audio count do not change the current formula.

Usage	Rate	Details
480p output	14 credits / output second	$0.070/s; 5 seconds uses 70 credits ($0.350).
720p output	28 credits / output second	$0.140/s; 5 seconds uses 140 credits ($0.700).

Best Use Cases

Concept clipsTurn a written scene into a reviewable motion concept.
Social variantsCompose the same short idea for landscape, square, or vertical delivery.
Advertising storyboardsTest one advertising shot's action, light, and timing.
Film or game previsValidate staging, camera movement, and atmosphere before production.

Pro Tips

Order the prompt as subject and setting, action, camera, light and mood, then sound intent.
Give a short text-only clip one primary action to preserve readability.
Use concrete motion verbs and separate subject movement from camera movement.
Choose composition before describing where the subject sits in frame.
When timing matters, describe an opening, development, and final beat.

Notes

This endpoint rejects every media field.
resolution is required by the public OpenAPI, so examples and the Playground always send it explicitly.
Playground upload limits are 30 MB images, 50 MB videos, and 15 MB audio; they are not the complete upstream file contract.
Fast accepts only 480p and 720p, not 1080p or 4K.
Tasks are asynchronous; poll only while status is not_started or running.

MiniMax H3Compare a fixed-2K text, frame, or multimodal reference workflow.

Wan 2.6Create 1080p videos with text, image, or video-guided inputs.

Kling 2.6Generate short videos with optional synchronized dialogue and ambient audio.

Frequently Asked Questions about Seedance 2.0 Fast Text-to-Video API

What is the Seedance 2.0 Fast Text-to-Video API?

Seedance 2.0 Fast is a ByteDance Seedance model. This Text-to-Video endpoint accepts a text prompt without source media and returns an asynchronous video-generation task through the documented REST request contract.

How do I call the Seedance 2.0 Fast Text-to-Video API?

Send POST /api/generate/submit with Authorization: Bearer VIDGO_API_KEY. A successful response includes task_id for the unified status endpoint.

How much does the Seedance 2.0 Fast Text-to-Video API cost?

Multiply output seconds by the selected resolution rate. 480p: 14 credits ($0.070)/s; 720p: 28 credits ($0.140)/s.

What inputs does the Seedance 2.0 Fast Text-to-Video API accept?

It accepts a 1–20,000 character prompt, 4–15 whole seconds, 480p, 720p, seven ratios, and optional advanced fields; media is rejected.

How do I get the generated video?

Poll GET /api/generate/status/{task_id}, or submit callback_url. Continue only for not_started or running; read every data.files[].file_url after finished, and stop with the error after failed.

Which Seedance 2.0 endpoint should I choose?

Choose Text with no source asset, Image for a start or start/end frame, and Reference for image, video, or audio guidance. Standard offers resolutions through 4K; Fast is limited to 480p/720p at lower current rates.

Seedance 2.0 Fast Text-to-Video

Continue with

Examples

Quick Start

Connect to the Vidgo API

Submit one generation task

Wait for the result

Track status

Request Parameters

Response Fields

Task Lifecycle

Polling and Errors

Model Specifications

Seedance 2.0 Fast Text-to-Video

Why Choose This?

Parameters

How to Use

Pricing

Best Use Cases

Pro Tips

Notes

Related Models

Frequently Asked Questions about Seedance 2.0 Fast Text-to-Video API