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.
Seedance 2.0 Fast Text-to-Video API
seedance-2.0-fast/text-to-videoSeedance 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
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.
Output
IdleYour generated files will appear here
Set the inputs, choose a duration, then run the asynchronous video task.
Continue with
Examples
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
- POST
https://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.
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",
"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/BTTXD9SZOQ62OOWHBegin 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{
"code": 200,
"data": {
"task_id": "BTTXD9SZOQ62OOWH",
"status": "running",
"created_time": "2026-08-27T14:22:42"
}
}{
"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.
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",
"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
doneRequest 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_startedAccepted and waiting to begin.
runningGeneration is active; continue polling with backoff.
finishedSuccessful terminal state; read every file.
failedFailed 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 |
Related Models
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.