Documentation Index
Fetch the complete documentation index at: https://docs.runflow.io/llms.txt
Use this file to discover all available pages before exploring further.
Pricing: $0.3034/second. Endpoint:
POST /v1/models/bytedance/seedance/2.0/text-to-video/runs.Overview
- Endpoint: https://api.runflow.io/v1/models/bytedance/seedance/2.0/text-to-video/runs
- Model ID: bytedance/seedance/2.0/text-to-video
- Provider: ByteDance
- License: commercial
- Last Updated: 2026-04-08
Pricing
- Base price: $0.3034/second
- Note: Per second (720p)
Seedance 2.0 Text to Video API
Endpoint:POST /v1/models/bytedance/seedance/2.0/text-to-video/runs
Run the model
Python
Node.js
cURL
Request parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
input | object | required | Model input parameters. See “Input schema” below. |
callback_url | string | null | optional | Webhook URL - POSTed when the run reaches a terminal state. |
metadata | object | null | optional | Arbitrary key-value pairs attached to the run. |
Input schema
| Field | Type | Required | Allowed values | Description |
|---|---|---|---|---|
prompt | string | required | Any | The text prompt used to generate the video |
aspect_ratio | string | optional | auto, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | The aspect ratio of the generated video. Use 16:9 for landscape, 9:16 for portrait/vertical, 1:1 for square, 21:9 for ultrawide cinematic, or auto to let the model decide. |
duration | string | optional | auto, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 | Duration of the video in seconds. Supports 4 to 15 seconds, or auto to let the model decide based on the prompt. |
resolution | string | optional | 480p, 720p, 1080p | Video resolution - 480p for faster generation, 720p for balance. |
generate_audio | boolean | optional | Any | Whether to generate synchronized audio for the video, including sound effects, ambient sounds, and lip-synced speech. The cost of video generation is the same regardless of whether audio is generated or not. |
seed | integer | optional | Any | Random seed for reproducibility. Note that results may still vary slightly even with the same seed. |
end_user_id | string | optional | Any | The unique user ID of the end user. |
Output schema
| Field | Type | Description |
|---|---|---|
outputs | json | Unified output array - one entry per generated artifact with url/type/width/height/duration/etc. |
seed | json | The seed used for generation. |
nsfw_detected | json | true if the provider flagged output as NSFW, false if cleared, null if not checked. |
timing | json | Provider timing info (inference_ms etc.), or null. |
Callback payload
When you provide acallback_url, Runflow POSTs to it once the run reaches a terminal state.
| Field | Type | Description |
|---|---|---|
event | string | Event type: “run.completed”, “run.failed”, or “run.cancelled”. |
run_id | string | The unique identifier of the run. |
status | string | Terminal status: “succeeded”, “failed”, or “cancelled”. |
output | object | null | The run output. Null if the run failed or was cancelled. |
duration_ms | number | null | Total run duration in milliseconds. |
created_at | string | null | ISO 8601 timestamp when the run was created. |
completed_at | string | null | ISO 8601 timestamp when the run reached terminal state. |
metadata | object | null | The metadata object passed at run creation, if any. |
- Retries: 3 attempts with exponential backoff (1s, 2s). Retries on 5xx / network errors only.
- Headers:
Runflow-Request-Idis always sent.Runflow-Signatureis sent if a signing secret is configured.
Additional Resources
Related
Browse all models
Browse the catalog.
Run lifecycle
Callbacks, polling, statuses.
Callbacks
Handle async results.
Pricing
How requests bill out.