Seedance 2.5 Text-to-Video

ByteDance

Generate video from text prompts with duration, resolution and aspect-ratio controls.

Current price
$0.0300/1k tokens
Availability
Ready to run
Last accepted verification

What this API does

Create a 480p or 720p Seedance 2.5 clip from text, with explicit duration and aspect ratio for an exact pre-run hold. The MP4 is persisted privately and the provider receives only a stable pseudonymous account identifier.

Agents select this operation with tool ID bytedance.seedance-2-5-text-to-video, then inspect its current executable contract before a run.

Public input and output shape

Input

aspect_ratiostring · optional

Value supplied for aspect ratio.

enum: 21:9, 16:9, 4:3, 1:1, 3:4, 9:16

durationinteger · optional

Value supplied for duration.

minimum: 4 · maximum: 30

generate_audioboolean · optional

Value supplied for generate audio.

promptstring · required

Instruction describing the requested generated output.

minLength: 1 · maxLength: 5000

resolutionstring · optional

Value supplied for resolution.

enum: 480p, 720p

Output

notestring

Returned note value.

videoobject

Returned video value.

Example request and output

This reviewed worked example is shared with inspect. Inspect also returns the current executable schema and price estimate before a paid run.

Request

{
  "tool_id": "bytedance.seedance-2-5-text-to-video",
  "input": {
    "prompt": "a cobalt reusable bottle rotates on a stone plinth as soft daylight moves across the scene",
    "duration": 4,
    "resolution": "480p",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }
}

Output

{
  "note": "video returned as an artifact",
  "video": {
    "audio": true,
    "content_type": "video/mp4",
    "duration_seconds": 4
  }
}
Teaching errors and limitations
  • invalid_input: duration must be an integer from 4 to 30 secondsexample: {"prompt":"a cobalt reusable bottle rotates on a stone plinth as soft daylight moves across the scene","aspect_ratio":"16:9","resolution":"480p","duration":4,"generate_audio":true}
Updated
21 August 2026

Use Seedance 2.5 Text-to-Video with Scrollport

Scrollport identifies and validates the best-in-class API tools and provides them on a pay-as-you-go basis so you don't need to maintain a separate provider account, subscription or credits.

Give your agent the setup prompt to receive $1 in trial credit and start using the tools right away.