@tanstack/ai-byteplus 0.1.0 → 0.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/ai-byteplus",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "BytePlus ModelArk adapter for TanStack AI: Seed LLM chat, Seedance video, Seedream image, and Seed Speech TTS/ASR.",
   "author": "Tanner Linsley",
   "license": "MIT",
@@ -48,18 +48,18 @@
     "text-to-speech"
   ],
   "devDependencies": {
-    "@vitest/coverage-v8": "4.0.14",
-    "vite": "^8.1.4",
-    "@tanstack/ai": "0.43.0"
+    "@vitest/coverage-v8": "4.1.10",
+    "vite": "^8.2.1",
+    "@tanstack/ai": "0.45.0"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@tanstack/ai": "^0.43.0"
+    "@tanstack/ai": "^0.45.0"
   },
   "dependencies": {
     "openai": "^6.41.0",
-    "@tanstack/ai-utils": "0.4.0",
-    "@tanstack/openai-base": "0.9.10"
+    "@tanstack/ai-utils": "^0.4.0",
+    "@tanstack/openai-base": "^0.9.13"
   },
   "scripts": {
     "build": "vite build",

package/src/adapters/text.ts

@@ -334,21 +334,20 @@ export class BytePlusTextAdapter<
       // Mirror the base's contract: failures inside structuredOutputStream
       // surface as a RUN_STARTED → RUN_ERROR pair rather than a throw, so
       // consumers keep a single error-handling path.
-      const timestamp = Date.now()
       const runId = generateId(this.name)
       yield {
         type: EventType.RUN_STARTED,
         runId,
         threadId: options.chatOptions.threadId ?? generateId(this.name),
         model: options.chatOptions.model,
-        timestamp,
+        timestamp: Date.now(),
         parentRunId: options.chatOptions.parentRunId,
       }
       yield {
         type: EventType.RUN_ERROR,
         runId,
         model: options.chatOptions.model,
-        timestamp,
+        timestamp: Date.now(),
         message: unsupported,
         code: 'unsupported-structured-output',
         error: { message: unsupported, code: 'unsupported-structured-output' },

package/src/adapters/video.ts

@@ -17,6 +17,7 @@ import {
 import {
   resolveBytePlusVideoResolution,
   resolveBytePlusVideoSize,
+  supportsAudioOnlyReference,
   supportsLastFrame,
   supportsReferenceMedia,
 } from '../video/video-provider-options'
@@ -161,7 +162,8 @@ function describeTaskFailure(task: BytePlusVideoTask): string {
  *   `seedance-1-0-pro-fast-251015` does not support it at all.
  * - `'reference'` / `'character'` → `reference_image`, video parts →
  *   `reference_video`, audio parts → `reference_audio` — subject and style
- *   references the model draws on (`r2v`, Seedance 2.0 family only).
+ *   references the model draws on (`r2v`, Seedance 2.5 and 2.0 family).
+ *   Seedance 2.5 also accepts audio-only reference input; 2.0 does not.
  *
  * Frame roles and reference roles cannot be combined in one request, so the
  * adapter rejects a mix up front rather than surfacing a raw 400.
@@ -232,18 +234,18 @@ export class BytePlusVideoAdapter<
     if (resolved.text) content.push({ type: 'text', text: resolved.text })
 
     // Every rule below except the role vocabulary itself is a claim about a
-    // *specific* model's capabilities, drawn from probing the six models that
-    // exist today. None of it can be true of a model that does not exist yet,
-    // so for an unknown id the guards stand down and Ark rules — otherwise the
-    // escape hatch would block exactly the requests it exists to enable (see
+    // *specific* model's capabilities, drawn from the known Seedance catalog.
+    // None of it can be true of a model that does not exist yet, so for an
+    // unknown id the guards stand down and Ark rules — otherwise the escape
+    // hatch would block exactly the requests it exists to enable (see
     // BytePlusVideoModelOrString). 'mask' / 'control' still throw: Seedance's
     // wire format has no field to carry them on any model.
     const gated = isKnownBytePlusVideoModel(model)
 
     let firstFrames = 0
     let lastFrames = 0
-    // Audio counts as a reference for the mode-exclusivity check but not for
-    // the "audio can't be the only reference" rule, which wants a visual.
+    // Audio counts as a reference for the mode-exclusivity check. On Seedance
+    // 2.0 it also needs a visual reference; 2.5 allows audio-only.
     let visualReferences = 0
     let audioReferences = 0
 
@@ -277,8 +279,8 @@ export class BytePlusVideoAdapter<
           if (gated && !supportsReferenceMedia(model)) {
             throw new Error(
               `byteplus: ${model} does not support reference images. Reference ` +
-                `media is available on the Seedance 2.0 family; on this model use ` +
-                `'start_frame' / 'end_frame' images instead.`,
+                `media is available on Seedance 2.5 and the 2.0 family; on this ` +
+                `model use 'start_frame' / 'end_frame' images instead.`,
             )
           }
           visualReferences++
@@ -311,7 +313,7 @@ export class BytePlusVideoAdapter<
       if (gated && !supportsReferenceMedia(model)) {
         throw new Error(
           `byteplus: ${model} does not accept video prompt parts. Reference ` +
-            `video is available on the Seedance 2.0 family only.`,
+            `video is available on Seedance 2.5 and the 2.0 family only.`,
         )
       }
       visualReferences++
@@ -326,7 +328,7 @@ export class BytePlusVideoAdapter<
       if (gated && !supportsReferenceMedia(model)) {
         throw new Error(
           `byteplus: ${model} does not accept audio prompt parts. Reference ` +
-            `audio is available on the Seedance 2.0 family only.`,
+            `audio is available on Seedance 2.5 and the 2.0 family only.`,
         )
       }
       audioReferences++
@@ -372,10 +374,16 @@ export class BytePlusVideoAdapter<
       )
     }
 
-    if (gated && audioReferences > 0 && visualReferences === 0) {
+    if (
+      gated &&
+      audioReferences > 0 &&
+      visualReferences === 0 &&
+      !supportsAudioOnlyReference(model)
+    ) {
       throw new Error(
         `byteplus: a reference audio input cannot be the only reference on ` +
-          `model ${model}. Pair it with a reference image or video.`,
+          `model ${model}. Pair it with a reference image or video, or use ` +
+          `Seedance 2.5 which accepts audio-only reference input.`,
       )
     }
 

package/src/index.ts

@@ -21,11 +21,13 @@ export {
   parseBytePlusVideoSize,
   resolveBytePlusVideoResolution,
   resolveBytePlusVideoSize,
+  supportsAudioOnlyReference,
   supportsLastFrame,
   supportsReferenceMedia,
 } from './video/video-provider-options'
 export type {
   BytePlusVideoModelProviderOptionsByName,
+  BytePlusVideoOutputFormat,
   BytePlusVideoProviderOptions,
   BytePlusVideoServiceTier,
 } from './video/video-provider-options'

package/src/model-meta.ts

@@ -488,10 +488,11 @@ export type BytePlusVideoRatio =
 /**
  * Resolution tiers accepted by the Seedance task API.
  *
- * All four are probe-verified per model (2026-07-31). Two findings contradict
- * the BytePlus prose docs: there is **no 2K tier on any Seedance model** —
- * `2k`/`2K` is rejected everywhere, including on the 2.0 flagship documented
- * as reaching 4K — and `4k` exists only on `dreamina-seedance-2-0-260128`.
+ * Resolution tiers are model-specific (see
+ * {@link BytePlusVideoModelResolutionByName}). Two findings that still
+ * contradict older BytePlus prose: there is **no 2K tier on any Seedance
+ * model**, and `4k` exists only on `dreamina-seedance-2-0-260128` (Seedance
+ * 2.5 is 480p/720p only, per the live ModelArk docs).
  *
  * The API matches this field case-insensitively (`4K`, `4k` and `1080P` are
  * all accepted), so this package standardizes on the lowercase spelling.
@@ -508,11 +509,18 @@ export type BytePlusVideoSize<
   TResolution extends BytePlusVideoResolution = BytePlusVideoResolution,
 > = BytePlusVideoRatio | `${BytePlusVideoRatio}_${TResolution}`
 
-// The Seedance 2.0 family's `audio` input modality is docs-derived, not
-// live-probed: the docs' multimodal-reference caps list `reference_audio`
-// parts (up to 3, never sent without a visual reference). Every 2.0 model id
-// below is itself probe-verified live; only the audio-reference capability
-// rests on the docs.
+// Multimodal reference-media capabilities (reference images / video / audio)
+// are docs-derived from the ModelArk create-task page. Model ids and the
+// resolution / duration tables for 2.0 were also live-probed on 2026-07-31;
+// 2.5 lands from the public docs once the model was fully opened (2026-08-07).
+const DREAMINA_SEEDANCE_2_5 = {
+  name: 'dreamina-seedance-2-5-260628',
+  supports: {
+    input: ['text', 'image', 'video', 'audio'],
+    output: ['video', 'audio'],
+  },
+} as const satisfies ModelMeta
+
 const DREAMINA_SEEDANCE_2_0 = {
   name: 'dreamina-seedance-2-0-260128',
   supports: {
@@ -565,6 +573,7 @@ const SEEDANCE_1_0_PRO_FAST = {
  * All supported Seedance video model identifiers.
  */
 export const BYTEPLUS_VIDEO_MODELS = [
+  DREAMINA_SEEDANCE_2_5.name,
   DREAMINA_SEEDANCE_2_0.name,
   DREAMINA_SEEDANCE_2_0_FAST.name,
   DREAMINA_SEEDANCE_2_0_MINI.name,
@@ -580,11 +589,12 @@ export type BytePlusVideoModel = (typeof BYTEPLUS_VIDEO_MODELS)[number]
 
 /**
  * Type-only map from video model name to the non-text prompt modalities it
- * accepts. The Seedance 2.0 family takes multimodal references (start/end
- * frames, reference images, reference video and audio); the 1.x models take
- * start/end frames only.
+ * accepts. Seedance 2.5 and the 2.0 family take multimodal references
+ * (start/end frames, reference images, reference video and audio); the 1.x
+ * models take start/end frames only.
  */
 export type BytePlusVideoModelInputModalitiesByName = {
+  [DREAMINA_SEEDANCE_2_5.name]: readonly ['image', 'video', 'audio']
   [DREAMINA_SEEDANCE_2_0.name]: readonly ['image', 'video', 'audio']
   [DREAMINA_SEEDANCE_2_0_FAST.name]: readonly ['image', 'video', 'audio']
   [DREAMINA_SEEDANCE_2_0_MINI.name]: readonly ['image', 'video', 'audio']
@@ -596,10 +606,13 @@ export type BytePlusVideoModelInputModalitiesByName = {
 /**
  * Type-only map from video model name to the resolutions it accepts.
  *
- * Probe-verified per model on 2026-07-31. Note `seedance-1-0-pro-fast-251015`
- * does accept `1080p`, despite the BytePlus docs listing it as 480p/720p.
+ * 2.0 / 1.x cells were probe-verified on 2026-07-31; 2.5 comes from the
+ * public ModelArk create-task docs (2026-08-07). Note
+ * `seedance-1-0-pro-fast-251015` does accept `1080p`, despite older BytePlus
+ * prose listing it as 480p/720p.
  */
 export type BytePlusVideoModelResolutionByName = {
+  [DREAMINA_SEEDANCE_2_5.name]: '480p' | '720p'
   [DREAMINA_SEEDANCE_2_0.name]: '480p' | '720p' | '1080p' | '4k'
   [DREAMINA_SEEDANCE_2_0_FAST.name]: '480p' | '720p'
   [DREAMINA_SEEDANCE_2_0_MINI.name]: '480p' | '720p'
@@ -621,24 +634,16 @@ export type BytePlusVideoModelSizeByName = {
  * A Seedance model id: one this package knows, or any other string.
  *
  * The open half is a deliberate escape hatch for models BytePlus ships between
- * releases of this package. **Seedance 2.5 is the live example.** Its real id
- * is `dreamina-seedance-2-5-260628` — note the June date suffix, which is why
- * guessing ids around its 2026-07-31 announcement never landed. It is absent
- * from the table below because its capability cells are unverified, not
- * because it is unreachable: probing it returns 404 `ModelNotOpen` ("your
- * account has not activated the model"), so no capability question can be
- * answered until someone enables it in the Ark Console. Passing it through
- * the escape hatch works today for an account that has.
- *
- * Adding a model here *narrows* it — the adapter's guards switch on and reject
- * against this file's tables. For a model whose real limits are unknown that
- * is strictly worse than the open path, which lets Ark judge. So an id lands
- * here only once probed.
+ * releases of this package. Adding a model to {@link BYTEPLUS_VIDEO_MODELS}
+ * *narrows* it — the adapter's guards switch on and reject against this
+ * file's tables. For a model whose real limits are unknown that is strictly
+ * worse than the open path, which lets Ark judge. So an id lands in the
+ * known table only once its capability cells are documented or probed.
  *
  * Discovering ids: `GET /models` on the Ark data plane enumerates the catalog
- * (id, `task_type`, `modalities`, `status`) and is how 2.5 was found. It is
- * not exhaustive — `seedream-5-0-lite-260128` answers requests but is missing
- * from the listing — so absence there is not evidence of absence. The ModelArk
+ * (id, `task_type`, `modalities`, `status`). It is not exhaustive —
+ * `seedream-5-0-lite-260128` answers requests but is missing from the
+ * listing — so absence there is not evidence of absence. The ModelArk
  * release notes (https://docs.byteplus.com/en/docs/ModelArk/1159178) are the
  * other watch surface.
  *
@@ -651,7 +656,7 @@ export type BytePlusVideoModelSizeByName = {
  * Unknown ids trade compile-time narrowing for reach: the full size surface is
  * accepted, provider options are ungated, and the adapter's model-specific
  * runtime guards stand down so a new model's legitimate request reaches Ark.
- * Known ids keep their probe-verified narrowing.
+ * Known ids keep their documented / probe-verified narrowing.
  */
 export type BytePlusVideoModelOrString = BytePlusVideoModel | (string & {})
 
@@ -694,8 +699,8 @@ export function isKnownBytePlusVideoModel(
  * Per-model duration type. Seedance accepts any integer second inside the
  * model's range, so this is a continuous range expressed as `number` — a
  * literal union cannot represent it. (The API also accepts `duration: -1` on
- * Seedance 2.0 and 1.5-pro to let the model choose; that is reachable through
- * provider options, not through the generic `duration`.)
+ * Seedance 2.5, 2.0 and 1.5-pro to let the model choose; that is reachable
+ * through provider options, not through the generic `duration`.)
  */
 export type BytePlusVideoModelDurationByName = {
   [K in BytePlusVideoModel]: number
@@ -709,6 +714,13 @@ export const BYTEPLUS_VIDEO_DURATIONS: {
     BytePlusVideoModelDurationByName[TModel]
   >
 } = {
+  'dreamina-seedance-2-5-260628': {
+    kind: 'range',
+    min: 4,
+    max: 30,
+    step: 1,
+    unit: 'seconds',
+  },
   'dreamina-seedance-2-0-260128': {
     kind: 'range',
     min: 4,
@@ -757,15 +769,15 @@ export const BYTEPLUS_VIDEO_DURATIONS: {
  * Duration hint for a model this package has no table for.
  *
  * Spans every range Seedance has shipped so far (2s on the 1.0 models through
- * 15s on the 2.0 family) so `availableDurations()` can still drive a UI. It is
+ * 30s on Seedance 2.5) so `availableDurations()` can still drive a UI. It is
  * a hint, not a contract: the adapter does **not** snap an unknown model's
- * duration against it, because clamping a future model's legitimate 20-second
- * request down to 15 would corrupt the request rather than protect it.
+ * duration against it, because clamping a future model's legitimate longer
+ * request down to 30 would corrupt the request rather than protect it.
  */
 export const BYTEPLUS_VIDEO_FALLBACK_DURATIONS: DurationOptions<number> = {
   kind: 'range',
   min: 2,
-  max: 15,
+  max: 30,
   step: 1,
   unit: 'seconds',
 }

package/src/video/video-provider-options.ts

@@ -2,13 +2,15 @@
  * Provider options and per-model capability tables for the BytePlus Seedance
  * video models.
  *
- * Every applicability claim below was probed live against
+ * Applicability for Seedance 1.x / 2.0 was probed live against
  * `https://ark.ap-southeast.bytepluses.com/api/v3` on 2026-07-31. The probe
  * sent an out-of-range `seed` alongside the field under test, so requests that
  * passed validation still failed before a task was created (nothing billed):
  * an error naming the field under test means "rejected", an error naming
  * `seed` means "accepted". Ark reports only one arbitrary invalid parameter
- * per request, so each cell was retried until a verdict repeated.
+ * per request, so each cell was retried until a verdict repeated. Seedance 2.5
+ * cells come from the public ModelArk create-task docs once the model was
+ * fully opened (2026-08-07).
  *
  * Ark rejects an inapplicable field outright — "the specified parameter
  * `draft` is not supported for model seedance-1-0-pro in t2v, must be empty" —
@@ -17,15 +19,15 @@
  *
  * **Where the adapter guards, and where it doesn't** (deliberate, not an
  * oversight). Scalar applicability — `service_tier`, `draft`, `priority`,
- * `frames`, `camera_fixed` — is left to Ark, whose 400 names the offending
- * field and the model precisely enough to act on, and whose per-model rules
- * shift as BytePlus ships models. Duplicating that here would mean a table
- * that silently goes stale and starts rejecting requests the API would have
- * accepted. The adapter guards locally only where the API's own error is
- * misleading or arrives too late to be actionable: prompt media shape (role
- * vocabulary, frame-vs-reference exclusivity, frame cardinality) and the
- * resolution tier, both of which are derived from a caller's `prompt` /
- * `size` rather than passed through verbatim.
+ * `frames`, `camera_fixed`, `output_format` — is left to Ark, whose 400 names
+ * the offending field and the model precisely enough to act on, and whose
+ * per-model rules shift as BytePlus ships models. Duplicating that here would
+ * mean a table that silently goes stale and starts rejecting requests the API
+ * would have accepted. The adapter guards locally only where the API's own
+ * error is misleading or arrives too late to be actionable: prompt media shape
+ * (role vocabulary, frame-vs-reference exclusivity, frame cardinality,
+ * audio-only reference) and the resolution tier, both of which are derived
+ * from a caller's `prompt` / `size` rather than passed through verbatim.
  *
  * @experimental Video generation is an experimental feature and may change.
  */
@@ -47,13 +49,24 @@ import type {
  *   price, with no latency guarantee. Task ids come back with a `cgt-batch-`
  *   prefix (live-verified).
  *
- * Only the Seedance 1.x models accept this field. The Seedance 2.0 family
- * rejects it ("service_tier is not supported … must be empty").
+ * Only the Seedance 1.x models accept this field. Seedance 2.5 and the 2.0
+ * family reject it ("service_tier is not supported … must be empty" / "not
+ * currently supported").
  *
  * @experimental Video generation is an experimental feature and may change.
  */
 export type BytePlusVideoServiceTier = 'default' | 'flex'
 
+/**
+ * Container format of the generated video.
+ *
+ * Seedance 2.5 documents `mp4` (default) and `mov`. Other models historically
+ * return `mp4` only; scalar applicability is left to Ark (see file header).
+ *
+ * @experimental Video generation is an experimental feature and may change.
+ */
+export type BytePlusVideoOutputFormat = 'mp4' | 'mov'
+
 /**
  * Provider-specific options for Seedance video generation. These map one-to-one
  * onto the create-task request body and take precedence over the values the
@@ -69,8 +82,8 @@ export interface BytePlusVideoProviderOptions {
   /**
    * Output aspect ratio. Overrides the ratio half of the generic `size`.
    *
-   * `adaptive` (follow the input frame) is the default on Seedance 2.0 and
-   * 1.5-pro but is rejected by Seedance 1.0-pro / 1.0-pro-fast for
+   * `adaptive` (follow the input frame) is the default on Seedance 2.5, 2.0
+   * and 1.5-pro but is rejected by Seedance 1.0-pro / 1.0-pro-fast for
    * text-to-video.
    */
   ratio?: BytePlusVideoRatio
@@ -78,8 +91,8 @@ export interface BytePlusVideoProviderOptions {
   /**
    * Output resolution tier. Overrides the resolution half of the generic
    * `size`. Matched case-insensitively by the API; this package uses
-   * lowercase throughout. `4k` exists only on `dreamina-seedance-2-0-260128`,
-   * and there is no 2K tier on any model.
+   * lowercase throughout. `4k` exists only on `dreamina-seedance-2-0-260128`
+   * (Seedance 2.5 is 480p/720p only), and there is no 2K tier on any model.
    */
   resolution?: BytePlusVideoResolution
 
@@ -87,8 +100,8 @@ export interface BytePlusVideoProviderOptions {
    * Whole seconds of output. Overrides the generic `duration`, and unlike it
    * is sent verbatim rather than snapped into the model's range.
    *
-   * `-1` asks the model to choose its own length; accepted by Seedance 2.0
-   * and 1.5-pro only.
+   * `-1` asks the model to choose its own length; accepted by Seedance 2.5,
+   * 2.0 and 1.5-pro only. On 2.5 video-editing tasks, `-1` is required.
    */
   duration?: number
 
@@ -111,7 +124,7 @@ export interface BytePlusVideoProviderOptions {
    * Appends a "fix the camera" instruction to the prompt. Best-effort — the
    * model is not constrained to obey it.
    *
-   * Seedance 1.5-pro, 1.0-pro and 1.0-pro-fast only; the 2.0 family rejects
+   * Seedance 1.5-pro, 1.0-pro and 1.0-pro-fast only; the 2.x family rejects
    * it.
    */
   camera_fixed?: boolean
@@ -125,12 +138,13 @@ export interface BytePlusVideoProviderOptions {
    * better results.
    *
    * Accepted by every model at the API's validation layer, but only Seedance
-   * 2.0 and 1.5-pro actually produce audio.
+   * 2.5, 2.0 and 1.5-pro actually produce audio.
    */
   generate_audio?: boolean
 
   /**
-   * Inference queue. Seedance 1.x only — the 2.0 family has no offline tier.
+   * Inference queue. Seedance 1.x only — Seedance 2.5 and the 2.0 family have
+   * no offline tier.
    */
   service_tier?: BytePlusVideoServiceTier
 
@@ -150,15 +164,21 @@ export interface BytePlusVideoProviderOptions {
   draft?: boolean
 
   /**
-   * Queue priority, `[0, 9]`. Seedance 2.0 family only — 1.5-pro rejects it,
-   * and the 1.0 models accept it without acting on it.
+   * Queue priority, `[0, 9]`. Seedance 2.5 and the 2.0 family — 1.5-pro
+   * rejects it, and the 1.0 models accept it without acting on it.
    */
   priority?: number
 
+  /**
+   * Container of the generated video. Seedance 2.5 documents `mp4` (default)
+   * and `mov`; other models historically ship `mp4` only.
+   */
+  output_format?: BytePlusVideoOutputFormat
+
   /**
    * Seconds after `created_at` at which an unfinished task is abandoned and
    * marked `expired`. Documented range `[3600, 259200]`, default 172800
-   * (48 hours). The floor is enforced on Seedance 1.x but not on the 2.0
+   * (48 hours). The floor is enforced on Seedance 1.x but not on the 2.x
    * family.
    */
   execution_expires_after?: number
@@ -206,17 +226,19 @@ const BYTEPLUS_VIDEO_RATIOS: ReadonlyArray<string> = [
 ]
 
 /**
- * Resolutions each model accepts, live-probed.
+ * Resolutions each model accepts.
  *
- * Two findings here contradict the BytePlus prose docs and are worth calling
- * out: there is no 2K tier on any Seedance model (`2k`/`2K` is rejected
- * everywhere, including on the 2.0 flagship whose docs advertise "up to 4K"),
- * and `seedance-1-0-pro-fast-251015` does accept `1080p` despite being
- * documented as 480p/720p only.
+ * 2.0 / 1.x cells were live-probed; 2.5 comes from the public ModelArk docs.
+ * Two findings still contradict older prose: there is no 2K tier on any
+ * Seedance model (`2k`/`2K` is rejected everywhere), and
+ * `seedance-1-0-pro-fast-251015` does accept `1080p` despite being documented
+ * as 480p/720p only. Seedance 2.5 is 480p/720p only — it does **not** offer
+ * the 2.0 flagship's 4k tier.
  */
 const BYTEPLUS_VIDEO_RESOLUTIONS: {
   readonly [K in BytePlusVideoModel]: ReadonlyArray<BytePlusVideoResolution>
 } = {
+  'dreamina-seedance-2-5-260628': ['480p', '720p'],
   'dreamina-seedance-2-0-260128': ['480p', '720p', '1080p', '4k'],
   'dreamina-seedance-2-0-fast-260128': ['480p', '720p'],
   'dreamina-seedance-2-0-mini-260615': ['480p', '720p'],
@@ -231,6 +253,7 @@ const BYTEPLUS_VIDEO_RESOLUTIONS: {
  * models reject it with "the specified task_type r2v does not support model …".
  */
 const BYTEPLUS_VIDEO_REFERENCE_MEDIA_MODELS: ReadonlySet<string> = new Set([
+  'dreamina-seedance-2-5-260628',
   'dreamina-seedance-2-0-260128',
   'dreamina-seedance-2-0-fast-260128',
   'dreamina-seedance-2-0-mini-260615',
@@ -242,6 +265,7 @@ const BYTEPLUS_VIDEO_REFERENCE_MEDIA_MODELS: ReadonlySet<string> = new Set([
  * does text-to-video and single-first-frame image-to-video only.
  */
 const BYTEPLUS_VIDEO_LAST_FRAME_MODELS: ReadonlySet<string> = new Set([
+  'dreamina-seedance-2-5-260628',
   'dreamina-seedance-2-0-260128',
   'dreamina-seedance-2-0-fast-260128',
   'dreamina-seedance-2-0-mini-260615',
@@ -249,6 +273,15 @@ const BYTEPLUS_VIDEO_LAST_FRAME_MODELS: ReadonlySet<string> = new Set([
   'seedance-1-0-pro-250528',
 ])
 
+/**
+ * Models that accept a reference-audio input without a visual reference
+ * alongside it. Seedance 2.5 documents audio-only reference-to-video; the 2.0
+ * family rejects it with "reference_audio cannot be the only reference input".
+ */
+const BYTEPLUS_VIDEO_AUDIO_ONLY_REFERENCE_MODELS: ReadonlySet<string> = new Set(
+  ['dreamina-seedance-2-5-260628'],
+)
+
 /**
  * True when the model is *known* to support reference-media mode (reference
  * images, video and audio). An id this package has no metadata for answers
@@ -271,6 +304,16 @@ export function supportsLastFrame(model: string): boolean {
   return BYTEPLUS_VIDEO_LAST_FRAME_MODELS.has(model)
 }
 
+/**
+ * True when the model is *known* to accept a reference-audio input without a
+ * visual reference. Same unknown-id caveat as {@link supportsReferenceMedia}.
+ *
+ * @experimental Video generation is an experimental feature and may change.
+ */
+export function supportsAudioOnlyReference(model: string): boolean {
+  return BYTEPLUS_VIDEO_AUDIO_ONLY_REFERENCE_MODELS.has(model)
+}
+
 /**
  * Splits a `size` template into its Seedance request fields.
  *

package/src/video/wire-types.ts

@@ -85,8 +85,11 @@ export interface BytePlusVideoVideoContent {
 }
 
 /**
- * An audio input. Live-verified: audio can only accompany another reference
- * input — "reference_audio cannot be the only reference input".
+ * An audio input.
+ *
+ * On Seedance 2.0, audio can only accompany another reference input —
+ * "reference_audio cannot be the only reference input". Seedance 2.5
+ * documents audio-only reference-to-video.
  */
 export interface BytePlusVideoAudioContent {
   type: 'audio_url'
@@ -98,9 +101,10 @@ export interface BytePlusVideoAudioContent {
  * One entry of the `content[]` array.
  *
  * The create schema declares `maxItems: 5`, but the live API does not enforce
- * it — 7 entries (6 reference images plus text) were accepted on
- * `dreamina-seedance-2-0-260128`. The adapter therefore does not cap the array
- * locally; a genuinely over-long request gets whatever Ark decides to say.
+ * it — Seedance 2.5 accepts up to 30 reference images plus videos and audio,
+ * and 7 entries were accepted on `dreamina-seedance-2-0-260128`. The adapter
+ * therefore does not cap the array locally; a genuinely over-long request
+ * gets whatever Ark decides to say.
  */
 export type BytePlusVideoContentPart =
   | BytePlusVideoTextContent
@@ -115,14 +119,13 @@ export type BytePlusVideoContentPart =
  * model-dependent — Ark rejects an inapplicable field outright ("the
  * specified parameter `draft` is not supported for model … must be empty")
  * rather than ignoring it, so the adapter only sends what the caller asked
- * for. See `video-provider-options.ts` for the live-probed applicability
- * matrix.
+ * for. See `video-provider-options.ts` for the applicability matrix.
  */
 export interface BytePlusVideoCreateRequest {
   /** Seedance model id (or a preconfigured endpoint id). */
   model: string
 
-  /** Prompt text plus any image / video / audio inputs, max 5 entries. */
+  /** Prompt text plus any image / video / audio inputs. */
   content: Array<BytePlusVideoContentPart>
 
   /** Output aspect ratio, e.g. `16:9`. `adaptive` follows the input frame. */
@@ -131,7 +134,10 @@ export interface BytePlusVideoCreateRequest {
   /** Resolution tier, e.g. `720p`. Matched case-insensitively by the API. */
   resolution?: string
 
-  /** Whole seconds of output. `-1` lets the model choose (Seedance 2.0 / 1.5). */
+  /**
+   * Whole seconds of output. `-1` lets the model choose (Seedance 2.5 / 2.0 /
+   * 1.5-pro).
+   */
   duration?: number
 
   /** Frame count, an alternative to `duration` that allows fractional seconds. */
@@ -161,6 +167,9 @@ export interface BytePlusVideoCreateRequest {
   /** Queue priority `[0, 9]`. */
   priority?: number
 
+  /** Container of the generated video, e.g. `mp4` or `mov`. */
+  output_format?: string
+
   /** Seconds from `created_at` after which the task is marked `expired`. */
   execution_expires_after?: number