Back to home

Seedance 2.5 API: Official Model IDs and What to Verify Before Integration

Seedance 2.5 API via BytePlus ModelArk (dreamina-seedance-2-5-260628) and Volcano Engine Ark. Model IDs, billing fields, pre-production checklist.

Last updated: 2026-08-15

Last verified: 2026-08-15. This page documents publicly described Seedance 2.5 API access through ByteDance first-party consoles. AISeedance25 is an independent editorial platform, not a ByteDance API reseller. Seedance and Dreamina are trademarks of their respective owners.

The 30-second answer

Short answer. Seedance 2.5 API access is available through two separate ByteDance consoles that must not be mixed: BytePlus ModelArk (international) under model ID dreamina-seedance-2-5-260628, and Volcano Engine Ark (China) under doubao-seedance-2.5. Billing is token-based; the usage.completion_tokens field returned after a successful generation is the authoritative charge signal. The published BytePlus rate card lists only 480p and 720p output tiers for Seedance 2.5.

If you are integrating Seedance 2.5 into a product, start by probing the correct model ID in the intended account and region, logging completion_tokens on every test, and measuring the downloaded file — not trusting marketing resolution labels alone.

On this page

Two official consoles — do not mix them

BytePlus ModelArk and Volcano Engine Ark use different model IDs, currencies, and contracts. Last verified: 2026-08-15.

International (BytePlus)

BytePlus ModelArk

dreamina-seedance-2-5-260628

Billing model
Token-based pay-as-you-go. Only successfully generated videos are charged.
Published resolutions
480p and 720p on the published rate card.
Max duration
Up to 30 seconds per generation, with extend passes supported by the model.
Reference inputs
Up to 50 multimodal reference assets per generation (provider described).
Status note
BytePlus lists Dreamina-seedance-2.5 API as fully available to clients with published pricing and a Seedance 2.5 Series Pricing Calculator.

Verified on 2026-08-15.

China (Volcano Engine)

Volcano Engine Ark

doubao-seedance-2.5

Billing model
Token-based pay-as-you-go under a separate China-region contract (CNY).
Published resolutions
480p and 720p on the published Volcano Engine pricing section.
Max duration
Up to 30 seconds per generation, matching the native model specification.
Reference inputs
Up to 50 multimodal reference assets per generation (provider described).
Status note
Volcano Engine Ark is the China-region console. Do not mix its model ID or CNY contract with BytePlus international pricing.

Verified on 2026-08-15.

Technical facts developers should verify first

FieldValue
BytePlus model IDdreamina-seedance-2-5-260628

Use this ID in BytePlus ModelArk API calls for international accounts.

Volcano Engine model IDdoubao-seedance-2.5

China-region console only. Not interchangeable with the BytePlus ID.

Authoritative billing fieldusage.completion_tokens

Final charge is based on tokens returned after a successful generation.

Failed-generation billingOnly successfully generated videos are charged (BytePlus documented policy).
Token consumption (provider described)(input_video_seconds + output_seconds) × width × height × frame_rate / 1024

Minimum-token floors apply when the input includes video.

Published output resolutions480p and 720p only on the BytePlus rate card for Seedance 2.5.

Consumer pages advertising 4K are not corroborated by the published API rate card.

How token billing actually works

Short answer. BytePlus documents token-based billing for Seedance 2.5. Token consumption grows with output duration, pixel dimensions, and frame rate, and video-input requests can trigger minimum-token floors. Only successfully generated videos are charged.

The provider-described token formula is:

(input_video_seconds + output_seconds) × width × height × frame_rate / 1024

That formula explains why a five-second 720p clip and a thirty-second 720p clip are not linearly comparable at a glance, and why adding a reference video increases token consumption even when the requested output duration stays the same. For integration work, the practical rule is simpler: log usage.completion_tokens on every successful response and build your cost model from observed usage in your account, not from a single published example row.

Failed generations are documented as non-billable on BytePlus — but your engineering time and queue latency are still consumed. Budget for retries when estimating production throughput.

480p and 720p — not 4K on the API rate card

Short answer. The published BytePlus rate card for Seedance 2.5 lists only 480p and 720p. Consumer pages that advertise 4K are not corroborated by the API rate card or any technical report on this page's last-verified date.

This matters for API integrations because your product UI may expose a "4K" export option that the underlying billed route does not actually deliver at native resolution. Always measure pixel dimensions from the delivered file. For the broader marketing-versus-rate-card gap across consumer surfaces, see the Seedance 2.5 vs 2.0 guide — Seedance 2.0 routes on several platforms still support higher published resolution tiers than Seedance 2.5 today.

Third-party gateways vs first-party access

Aggregators and API gateways can simplify multi-model routing, but they are not interchangeable with first-party BytePlus or Volcano Engine access. A gateway may rename the model, cap resolution, add queue layers, or bill on a flat per-second rate that diverges from token accounting.

Before treating a gateway quote as equivalent to direct access, verify in the target account:

  1. The callable model ID matches dreamina-seedance-2-5-260628 (international) or doubao-seedance-2.5 (China).
  2. The returned usage object includes a token count you can reconcile against the provider docs.
  3. The downloaded file's measured resolution matches what your product promises downstream.

For a consumer-route comparison that includes Higgsfield, Dreamina, Artlist, and BytePlus side by side, see the Higgsfield vs direct access guide.

Pre-production API integration checklist

  1. 1

    Pick the correct regional console

    BytePlus ModelArk serves international accounts under dreamina-seedance-2-5-260628. Volcano Engine Ark serves China under doubao-seedance-2.5. They are not interchangeable.

  2. 2

    Probe the model ID in your account and region

    Run a minimal successful request in the intended account before wiring production traffic. Availability can differ by region, quota, and account tier.

  3. 3

    Read usage.completion_tokens on every response

    Treat the returned completion_tokens field as the billing signal. Do not estimate cost from marketing per-second quotes alone.

  4. 4

    Test with and without video input

    Video-input requests use a different token rate and minimum-token floors. Benchmark both paths before budgeting.

  5. 5

    Measure the downloaded file

    Record pixel dimensions, duration, codec, and bitrate from the delivered file — not from the request label alone.

  6. 6

    Keep a tested fallback route

    Canary production traffic only after a verified fallback model or provider route is available.

What AISeedance25 is (and is not) for API users

AISeedance25 is an independent editorial platform with a web workspace for Seedance generation. It is not an official ByteDance API distribution channel, not a licensee, and not a reseller of dreamina-seedance-2-5-260628 access.

If your job is product integration, your first-party path is BytePlus ModelArk or Volcano Engine Ark — linked and documented on the Seedance 2.5 official access guide. If your job is evaluating Seedance 2.5 output quality and limits before choosing a route, the Seedance 2.5 capability guide separates provider-described facts from independently tested behaviour.

Paid plans on AISeedance25 purchase credits for generation through routes available on this site, with a server-verified estimate shown before each submission. That is a different product from the BytePlus API contract.

Sources and verification status

Primary sources cross-checked for this page:

API availability, model IDs, and pricing sections can change without a public changelog entry. Re-verify in the console before production cutover.

For review standards, see the AISeedance25 editorial policy and testing methodology. Corrections via the contact page.

Frequently asked questions about the Seedance 2.5 API

Is the Seedance 2.5 API available now?

Yes, through ByteDance's first-party developer consoles. BytePlus ModelArk lists dreamina-seedance-2-5-260628 as fully available with published pricing for international accounts. Volcano Engine Ark carries doubao-seedance-2.5 under a separate China-region contract.

What is the official Seedance 2.5 API model ID?

On BytePlus ModelArk (international), the published model ID is dreamina-seedance-2-5-260628. On Volcano Engine Ark (China), the model is doubao-seedance-2.5. Aggregator sites may quote other labels — verify against the console before integration.

How is Seedance 2.5 API billing calculated?

BytePlus documents token-based billing. The usage.completion_tokens field returned after a successful generation is the authoritative billing signal. Only successfully generated videos are charged. Video-input requests use a different token rate and can trigger minimum-token floors.

Does the Seedance 2.5 API support 4K output?

The published BytePlus rate card for Seedance 2.5 lists only 480p and 720p output tiers. Consumer marketing that references 4K is not corroborated by the API rate card or any technical report as of the last-verified date on this page.

Is BytePlus ModelArk the same as Volcano Engine Ark?

No. They are separate ByteDance cloud consoles for different regions. BytePlus ModelArk is the international route with USD token pricing. Volcano Engine Ark is the China-region console with a separate CNY contract and a different model label.

Can I use AISeedance25 as a Seedance 2.5 API proxy?

AISeedance25 is an independent editorial platform with a web workspace, not an official ByteDance API distribution channel. Paid plans purchase AISeedance25 credits for generation through integrated routes on this site, not authorized resale of the BytePlus or Volcano Engine API.

Do third-party API gateways expose the same Seedance 2.5 parameters?

Gateways can wrap the same underlying model but may rename parameters, cap resolutions, or add their own billing layer. Always verify the callable model ID, endpoint schema, and returned usage fields in the target account before treating a gateway quote as equivalent to first-party access.

What should I log for every API integration test?

Log the model ID, resolution, duration, input mode (with or without video input), completion_tokens, terminal status, wall-clock queue time, and the measured pixel dimensions of the downloaded file. That dataset is what makes a cost estimate reproducible.