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 API consoles
- Technical facts to verify first
- How token billing actually works
- 480p and 720p — not 4K on the API rate card
- Third-party gateways vs first-party access
- Pre-production integration checklist
- What AISeedance25 is (and is not) for API users
- Frequently asked questions
- Sources and verification status
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.
BytePlus ModelArk
dreamina-seedance-2-5-260628
Verified on 2026-08-15.
Volcano Engine Ark
doubao-seedance-2.5
Verified on 2026-08-15.
Technical facts developers should verify first
| Field | Value |
|---|---|
| BytePlus model ID | dreamina-seedance-2-5-260628 Use this ID in BytePlus ModelArk API calls for international accounts. |
| Volcano Engine model ID | doubao-seedance-2.5 China-region console only. Not interchangeable with the BytePlus ID. |
| Authoritative billing field | usage.completion_tokens Final charge is based on tokens returned after a successful generation. |
| Failed-generation billing | Only 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 resolutions | 480p 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:
- The callable model ID matches
dreamina-seedance-2-5-260628(international) ordoubao-seedance-2.5(China). - The returned usage object includes a token count you can reconcile against the provider docs.
- 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
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
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
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
Test with and without video input
Video-input requests use a different token rate and minimum-token floors. Benchmark both paths before budgeting.
- 5
Measure the downloaded file
Record pixel dimensions, duration, codec, and bitrate from the delivered file — not from the request label alone.
- 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:
- ByteDance Seed — Seedance 2.5 — model owner release and capability description.
- BytePlus — Dreamina Seedance 2.5 product page — international API availability statement.
- BytePlus ModelArk — model pricing — token rates, calculation formula, and resolution tiers.
- Volcano Engine — China-region console for
doubao-seedance-2.5.
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.