ByteDance logo

Seedance 2.5 API

seedance-2.5

Seedance 2.5 API is APINEED's newer AITokenDance video route for 4–15 second text, image, and video-reference generation at 480p or 720p.

The APINEED production adapter deliberately exposes a narrower contract than third-party descriptions of the broader model: 480p and 720p output, up to 15 seconds, explicit metadata controls, optional reference media, and asynchronous polling. Unsupported 1080p requests are rejected before they can be billed.

MODALITIES
PriceFrom $6.208 / 1M output tokensCONTEXTN/A

Playground

Generate with Seedance 2.5, review the output, and use the same request shape in your application.

Verified 480p and 720p route

APINEED currently validates Seedance 2.5 at 480p or 720p. Use Seedance 2.0 Spicy when the request requires the verified 1080p option. Use Seedance 2.0 Spicy

Workflow
From $6.208 / 1M output tokensSign in required. Final cost uses completed usage.
Output Ready
Sample output
Request preview
{
  "model": "seedance-2.5",
  "prompt": "A cinematic 5-second shot of a designer desk at sunrise. The camera slowly pushes in, dust moves through the light, realistic reflections, no text overlay.",
  "seconds": "5",
  "metadata": {
    "resolution": "720p",
    "ratio": "16:9",
    "generate_audio": false,
    "watermark": false
  }
}

Providers

ByteDance documents the broader model capability. APINEED separately defines the model ID, endpoint, parameter whitelist, authentication, and billing behavior shown on this page.

API Need3% off
Uptime
Total Context
N/A
Max Output
N/A
Input
Free/ 1M
Output
$6.208/ 1M
Cache Read
Route priced
Cache Write
Route priced

Discount

Official Seedance 2.5 API pricing varies by resolution and whether the request includes video input. All rates are shown in USD, with the APINEED prepaid price calculated at 3% off. [1][3]

Seedance 2.5 videoUSD / 1M output tokens
ResolutionInput conditionOfficial priceAPINEED price
480pIncludes video input$6.400$6.2083% off
Excludes video input$10.700$10.3793% off
720pIncludes video input$6.400$6.2083% off
Excludes video input$10.700$10.3793% off

Availability

APINEED monitors Seedance 2.5 API availability. Applications should preserve request and task IDs and handle upstream failures explicitly.

System statusLast 90 days
APINEED GATEWAY99.91% uptime

Seedance 2.5 API capabilities

Seedance 2.5 is presented here through the controls APINEED has actually validated in production, keeping the public playground aligned with the gateway rather than speculative provider features. [1][2][3]

Bounded production settings

APINEED accepts integer-equivalent duration from four through fifteen seconds and limits output resolution to 480p or 720p, rejecting unsupported combinations before task submission. [1][3]

Text and reference workflows

The route supports prompt-only generation, reference images, and one structured video reference while preserving a single task shape across the visible workflow choices. [1][3]

Canonical billing input

Duration, resolution, and video-reference presence are normalized before pre-consumption so the same request properties drive validation, upstream generation, and final pricing. [3]

Asynchronous completion

A successful create call returns a task ID rather than the finished clip. Applications poll the generation endpoint and read the nested video URL after the task reaches success. [1][3]

Condition-aware 3% discount

The production expression prices video-input and no-video-input work separately, then applies the configured 97% rate to the provider baseline for the supported resolutions. [1][3]

Building reliable Seedance 2.5 jobs

Stay within the verified ceiling. Use 480p or 720p and a duration from four to fifteen seconds; do not send 1080p as a hopeful fallback.

Plan one concise sequence. Describe the opening state, motion, camera behavior, sound, and final state in chronological order.

Persist task context. Store the task ID with the originating model and request so polling can resume safely after a page reload.

Quick Start

Call Seedance 2.5 with the verified APINEED endpoint and model-specific request shape.

1

Create an API key

Store your APINEED key server-side as API_NEED_API_KEY.

export API_NEED_API_KEY=sk-apineed-v1-...
2

Send the request

Use seedance-2.5 with POST /v1/video/generations.

curl https://apineed.com/v1/video/generations \
  -H "Authorization: Bearer $API_NEED_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedance-2.5",
  "prompt": "A cinematic 5-second shot of a designer desk at sunrise. The camera slowly pushes in, dust moves through the light, realistic reflections, no text overlay.",
  "seconds": "5",
  "metadata": {
    "resolution": "720p",
    "ratio": "16:9",
    "generate_audio": false,
    "watermark": false
  }
}'
3

Poll the task

Save task_id, then poll GET /v1/video/generations/{task_id} every few seconds until the task is completed or failed.

curl https://apineed.com/v1/video/generations/$TASK_ID -H "Authorization: Bearer $API_NEED_API_KEY"

Seedance 2.5 API Endpoint

Create an asynchronous video task, then use its task ID to retrieve status and the completed video URL.

POST/v1/video/generations
Authorization
Bearer $API_NEED_API_KEY
Content-Type
application/json
HTTP-Referer
optional - your site URL, for rankings
Model
seedance-2.5
GET/v1/video/generations/{task_id}
Authorization
Bearer $API_NEED_API_KEY
Content-Type
application/json
HTTP-Referer
optional - your site URL, for rankings
Model
seedance-2.5

Parameters

These controls follow APINEED's current DTO and adapter behavior. Unsupported upstream-only fields are intentionally omitted.

NameTypeValuesDescription
modelstringRequiredUse seedance-2.5.
promptstringRequiredDescribe the scene, motion, camera, and constraints for Seedance 2.5.
secondsstring4-15Duration for the Seedance task. The page does not send top-level duration.
imagesstring[]OptionalReference image URLs or data URLs for API integrations.
metadata.resolutionstring480p, 720pResolution sent in Seedance metadata.
metadata.ratiostring16:9, 9:16, 1:1, 4:3, 3:4, 21:9Aspect ratio sent as ratio.
metadata.content[].video_urlobjectOptionalRequired API structure for video-reference billing and routing.
metadata.generate_audiobooleanOptionalControls native audio generation.
metadata.watermarkbooleanOptionalControls watermark forwarding.

Seedance 2.5 API questions

Practical answers for choosing, integrating, pricing, and operating the Seedance 2.5 API on APINEED.

What Seedance 2.5 settings has APINEED verified?

The production adapter accepts 4–15 second jobs at 480p or 720p with prompt, reference-image, structured video-reference, aspect-ratio, audio, and watermark controls. [1][3]

Can Seedance 2.5 generate 1080p through APINEED?

No. APINEED currently rejects 1080p for this route before submission. Choose 480p or 720p, or use the separately documented Seedance 2.0 Spicy route for a verified 1080p option. [3]

Which endpoint serves Seedance 2.5 API?

Create a task with POST /v1/video/generations and model seedance-2.5, then poll GET /v1/video/generations/{task_id} until the response reports a terminal status. [3]

How does Seedance 2.5 video-input pricing work?

A request receives the video-input rate only when metadata.content contains a correctly structured video_url item. Prompt-only and image-reference jobs use the no-video-input branch. [1][3]

What discount does APINEED apply to Seedance 2.5?

APINEED charges 97% of the published baseline, which is a 3% discount. The displayed matrix retains separate video-input and no-video-input prices for 480p and 720p. [1][3]

What should production code retain after creating a Seedance 2.5 job?

Persist the APINEED task ID, originating model, submission time, and request context; poll at a controlled interval and preserve upstream error details when a task fails. [3]

How to deploy Seedance 2.5

Connect Seedance 2.5 to your application through the APINEED media API.

1

Add credits

Add APINEED credits before submitting a billable generation.

2

Create an API key

Create and securely store an APINEED API key.

3

Configure the endpoint

Send seedance-2.5 requests to /v1/video/generations.

4

Track the task

Poll the returned task ID and store the completed video URL.

More live models