diff --git a/api-reference/endpoint/video/queue.mdx b/api-reference/endpoint/video/queue.mdx
index fbee520d..e9ef252e 100644
--- a/api-reference/endpoint/video/queue.mdx
+++ b/api-reference/endpoint/video/queue.mdx
@@ -9,13 +9,13 @@ Call `/video/quote` to get a price estimate, then poll `/video/retrieve` with th
 
 Private models also return a `download_url` for the finished video. It is a short-lived delivery URL (a few retries are fine if a download drops); see the [Video Generation guide](/guides/media/video-generation#private-download-links) for details and optional `DELETE` for privacy.
 
-### Seedance 2.0
+### Seedance 2.0 & 2.5
 
-For `seedance-2-0-*` models (text-to-video, image-to-video, reference-to-video, plus the `-fast-*` variants), see the [Seedance 2.0 Guide](/guides/media/seedance-2-0) for the four-workflow model (Reference / Edit / Extend / Stitch), canonical prompt patterns, multimodal input limits, and pricing details.
+For `seedance-2-0-*-basic` and `seedance-2-5-*-basic` models (text-to-video, image-to-video, reference-to-video, plus the Seedance 2.0 `-fast-*` variants), see the [Seedance 2.0 & 2.5 Guide](/guides/media/seedance-2-0) for the four-workflow model (Reference / Edit / Extend / Stitch), family-specific multimodal limits, faces-off API behavior, and pricing details.
 
-### Seedance consent
+### Seedance faces-off API
 
-When a Seedance image- or reference-to-video request contains a human face, the API returns a `409 needs_consent` with the policy text, and you resubmit the same request with a `consents.seedance` attestation. See the [Seedance Face-Media Consent Guide](/guides/media/seedance-face-consent) for the full flow, the consent object, dedupe, and revocation.
+Public Seedance models do **not** support face-asset provisioning or face-consent attestation. Face-bearing inputs may be rejected upstream. For likeness / face-asset generation, use the Venice app or Studio. See the [Seedance guide](/guides/media/seedance-2-0) for details.
 
 ### Video upscaling
 
diff --git a/docs.json b/docs.json
index 834eed28..30f53574 100644
--- a/docs.json
+++ b/docs.json
@@ -70,6 +70,7 @@
                   "guides/media/image-editing",
                   "guides/media/image-upscaling",
                   "guides/media/video-generation",
+                  "guides/media/seedance-2-0",
                   "guides/media/reference-to-video",
                   "guides/media/music-and-sound-effects",
                   "guides/media/text-to-speech",
@@ -384,6 +385,7 @@
                   "pt-BR/guides/media/image-editing",
                   "pt-BR/guides/media/image-upscaling",
                   "pt-BR/guides/media/video-generation",
+                  "pt-BR/guides/media/seedance-2-0",
                   "pt-BR/guides/media/reference-to-video",
                   "pt-BR/guides/media/music-and-sound-effects",
                   "pt-BR/guides/media/text-to-speech",
@@ -698,6 +700,7 @@
                   "ar/guides/media/image-editing",
                   "ar/guides/media/image-upscaling",
                   "ar/guides/media/video-generation",
+                  "ar/guides/media/seedance-2-0",
                   "ar/guides/media/reference-to-video",
                   "ar/guides/media/music-and-sound-effects",
                   "ar/guides/media/text-to-speech",
@@ -1012,6 +1015,7 @@
                   "it/guides/media/image-editing",
                   "it/guides/media/image-upscaling",
                   "it/guides/media/video-generation",
+                  "it/guides/media/seedance-2-0",
                   "it/guides/media/reference-to-video",
                   "it/guides/media/music-and-sound-effects",
                   "it/guides/media/text-to-speech",
@@ -1326,6 +1330,7 @@
                   "de/guides/media/image-editing",
                   "de/guides/media/image-upscaling",
                   "de/guides/media/video-generation",
+                  "de/guides/media/seedance-2-0",
                   "de/guides/media/reference-to-video",
                   "de/guides/media/music-and-sound-effects",
                   "de/guides/media/text-to-speech",
@@ -1640,6 +1645,7 @@
                   "es/guides/media/image-editing",
                   "es/guides/media/image-upscaling",
                   "es/guides/media/video-generation",
+                  "es/guides/media/seedance-2-0",
                   "es/guides/media/reference-to-video",
                   "es/guides/media/music-and-sound-effects",
                   "es/guides/media/text-to-speech",
@@ -1954,6 +1960,7 @@
                   "fr/guides/media/image-editing",
                   "fr/guides/media/image-upscaling",
                   "fr/guides/media/video-generation",
+                  "fr/guides/media/seedance-2-0",
                   "fr/guides/media/reference-to-video",
                   "fr/guides/media/music-and-sound-effects",
                   "fr/guides/media/text-to-speech",
@@ -2268,6 +2275,7 @@
                   "zh/guides/media/image-editing",
                   "zh/guides/media/image-upscaling",
                   "zh/guides/media/video-generation",
+                  "zh/guides/media/seedance-2-0",
                   "zh/guides/media/reference-to-video",
                   "zh/guides/media/music-and-sound-effects",
                   "zh/guides/media/text-to-speech",
@@ -2582,6 +2590,7 @@
                   "ko/guides/media/image-editing",
                   "ko/guides/media/image-upscaling",
                   "ko/guides/media/video-generation",
+                  "ko/guides/media/seedance-2-0",
                   "ko/guides/media/reference-to-video",
                   "ko/guides/media/music-and-sound-effects",
                   "ko/guides/media/text-to-speech",
diff --git a/guides/integrations/venice-video-harness.mdx b/guides/integrations/venice-video-harness.mdx
index 1616218b..1b318fe1 100644
--- a/guides/integrations/venice-video-harness.mdx
+++ b/guides/integrations/venice-video-harness.mdx
@@ -124,9 +124,9 @@ The harness defaults are opinionated because consistency is the point. The curre
 
 | Role | Default model | When used |
 |---|---|---|
-| Character shots (1-2 characters) | `seedance-2-0-reference-to-video` | Default R2V with flat `reference_image_urls`, `@Image` tags, up to 15s, native stereo audio |
+| Character shots (1-2 characters) | `seedance-2-0-reference-to-video-basic` | Default R2V with flat `reference_image_urls`, `@Image` tags, up to 15s, native stereo audio |
 | Character shots (3+ characters) | `kling-o3-standard-reference-to-video` | Auto-fallback with structured `elements` for multi-character identity |
-| Establishing / mood / action | `seedance-2-0-image-to-video` | No characters; epic cinematic quality, up to 15s |
+| Establishing / mood / action | `seedance-2-0-image-to-video-basic` | No characters; epic cinematic quality, up to 15s |
 
 These are overridable per-project via `series.json → videoDefaults`. To target a non-Seedance family (e.g. accounts that lack Seedance access), set `videoDefaults` to `kling-o3-standard-reference-to-video` and `veo3.1-fast-image-to-video`.
 
diff --git a/guides/media/seedance-2-0.mdx b/guides/media/seedance-2-0.mdx
index 50014f43..ba46a9d6 100644
--- a/guides/media/seedance-2-0.mdx
+++ b/guides/media/seedance-2-0.mdx
@@ -1,37 +1,46 @@
 ---
-title: "Seedance 2.0"
-description: "Generate, edit, extend, and stitch videos with Seedance 2.0 on Venice — text, image, and reference-to-video workflows on one endpoint, with worked examples."
-'og:title': "Seedance 2.0 Guide | Venice API Docs"
-'og:description': "Generate, edit, extend and stitch videos with Seedance 2.0 via the Venice API. Workflow patterns, multimodal limits, pricing, and worked examples."
+title: "Seedance 2.0 & 2.5"
+description: "Generate, edit, extend, and stitch videos with Seedance 2.0 and 2.5 on Venice - text, image, and reference-to-video workflows, faces-off API behavior, and family-specific multimodal limits."
+'og:title': "Seedance 2.0 & 2.5 Guide | Venice API Docs"
+'og:description': "Generate, edit, extend and stitch videos with Seedance 2.0 and 2.5 via the Venice API. Workflow patterns, faces-off behavior, multimodal limits, pricing, and worked examples."
 ---
 
-Seedance 2.0 is a flagship multimodal video model exposed on Venice as a family of three variants for text-, image-, and reference-driven video generation. The **reference-to-video** variant is unusually powerful: a single endpoint and a single model ID handle **four distinct workflows** (Reference, Edit, Extend, Stitch) — the workflow is inferred from the **shape of your prompt**.
+Seedance is a flagship multimodal video family on Venice for text-, image-, and reference-driven video generation. **Seedance 2.0** (plus Fast) and **Seedance 2.5** share the same R2V prompt-routing model: a single reference-to-video endpoint handles **four distinct workflows** (Reference, Edit, Extend, Stitch) — the workflow is inferred from the **shape of your prompt**.
 
-This guide walks through the variants, the four workflows with their canonical prompts, the multimodal input limits, pricing, and complete `curl` examples.
+This guide covers variants, the four workflows, **faces-off public API behavior**, **family-specific multimodal limits**, pricing, and `curl` examples.
+
+<Warning>
+**Faces are not supported on the public Seedance API.** Venice does not run face-asset provisioning or face-consent attestation (`consents.seedance` / `needs_consent`) for public Seedance models. Face-bearing inputs may be rejected upstream as a content-policy / provider error. For likeness / face-asset generation, use the Venice app or Studio.
+</Warning>
 
 ## Variants
 
 | Model ID | Variant | Output resolutions | Notes |
 |---|---|---|---|
-| `seedance-2-0-text-to-video` | T2V | 480p / 720p / 1080p | Text prompt only |
-| `seedance-2-0-image-to-video` | I2V | 480p / 720p / 1080p | First-frame (and optionally last-frame) image grounding |
-| `seedance-2-0-reference-to-video` | R2V | 480p / 720p / 1080p | Up to 9 reference images + 3 reference videos + 3 reference audio donors. Powers Reference / Edit / Extend / Stitch |
-| `seedance-2-0-fast-text-to-video` | Fast T2V | 480p / 720p | Faster, lower-fidelity tier |
-| `seedance-2-0-fast-image-to-video` | Fast I2V | 480p / 720p | Faster, lower-fidelity tier |
-| `seedance-2-0-fast-reference-to-video` | Fast R2V | 480p / 720p | Faster, lower-fidelity tier; same workflow set |
+| `seedance-2-0-text-to-video-basic` | T2V | 480p / 720p / 1080p / **4k** | Text prompt only |
+| `seedance-2-0-image-to-video-basic` | I2V | 480p / 720p / 1080p / **4k** | First-frame (and optionally last-frame) image grounding |
+| `seedance-2-0-reference-to-video-basic` | R2V | 480p / 720p / 1080p / **4k** | Up to 9 reference images + 3 reference videos + 3 reference audio donors. Powers Reference / Edit / Extend / Stitch |
+| `seedance-2-0-fast-text-to-video-basic` | Fast T2V | 480p / 720p | Faster, lower-fidelity tier (no 1080p / 4k) |
+| `seedance-2-0-fast-image-to-video-basic` | Fast I2V | 480p / 720p | Faster, lower-fidelity tier (no 1080p / 4k) |
+| `seedance-2-0-fast-reference-to-video-basic` | Fast R2V | 480p / 720p | Faster, lower-fidelity tier (no 1080p / 4k); same workflow set |
+| `seedance-2-5-text-to-video-basic` | T2V | 480p / 720p | Up to 30s output; native audio |
+| `seedance-2-5-image-to-video-basic` | I2V | 480p / 720p | Up to 30s output; first-frame (and optionally last-frame) grounding |
+| `seedance-2-5-reference-to-video-basic` | R2V | 480p / 720p | Up to 30 images + 10 videos + 10 audio donors; same Reference / Edit / Extend / Stitch workflows |
 
 All variants are async. Submit via `POST /api/v1/video/queue`, then poll `POST /api/v1/video/retrieve` until the response body is `video/mp4`. See [Video Generation](/guides/media/video-generation) for the general queue flow.
 
+Pass `resolution` as one of: `480p`, `720p`, `1080p`, or `4k` (lowercase). Seedance **2.0** (non-Fast) accepts all four; **2.0 Fast** and **2.5** accept `480p` / `720p` only. Discover live model IDs and capabilities with `GET /models?type=video` — do not hardcode availability.
+
 ## The "one model, four workflows" model
 
-The reference-to-video variant (`seedance-2-0-reference-to-video` and its Fast sibling) is the same underlying model serving four different tasks. **The model infers the task from the prompt prefix and the shape of your inputs.** There is no `task` or `workflow` field — the prompt syntax is the routing.
+The reference-to-video variants (`seedance-2-0-reference-to-video-basic`, its Fast sibling, and `seedance-2-5-reference-to-video-basic`) use the same prompt-routing pattern. **The model infers the task from the prompt prefix and the shape of your inputs.** There is no `task` or `workflow` field — the prompt syntax is the routing.
 
 | Workflow | What it does | Prompt prefix | Inputs |
 |---|---|---|---|
-| **Reference** | Generate a new video using uploaded reference files as donors for subject / motion / style / audio | `Refer to ... in <Image\|Video\|Audio N> to generate ...` | Text + ≥1 image OR video reference (0-9 images, 0-3 videos), plus optionally up to 3 audio donors |
+| **Reference** | Generate a new video using uploaded reference files as donors for subject / motion / style / audio | `Refer to ... in <Image\|Video\|Audio N> to generate ...` | Text + ≥1 image OR video reference, plus optional audio donors (counts differ by family — see limits) |
 | **Edit** | Modify a single input video while preserving the rest | `Strictly edit <Video 1>, changing its ...` | 1 input video + text (images optional grounding) |
 | **Extend** | Forward / backward extension of one clip | `Extend <Video 1>, generate ...` | 1 input video + text |
-| **Stitch** | Stitch 2-3 clips with auto-generated transitions | `<Video 1> + <transition description> + followed by <Video 2> + ...` | 2-3 input videos + text |
+| **Stitch** | Stitch input clips with auto-generated transitions | `<Video 1> + <transition description> + followed by <Video 2> + ...` | Multiple input videos + text (clip count / duration caps differ by family) |
 
 The **prompt syntax is canonical and case-sensitive**: angle brackets, capital first letter, single space before the number — `<Video 1>`, `<Image 1>`, `<Audio 1>`.
 
@@ -110,7 +119,7 @@ Transition handling: the model automatically extracts the transition frames for
 
 ### Stitch workflow (Track Completion)
 
-Connect 2-3 input clips with AI-generated transitions. Total combined input duration must be ≤ 15 s.
+Connect input clips with AI-generated transitions. Respect the **family-specific** combined-duration and clip-count caps in [Multimodal input limits](#multimodal-input-limits) (Seedance 2.0: ≤3 clips / ≤15 s combined; Seedance 2.5: higher video caps).
 
 **Canonical prompt pattern**:
 
@@ -152,43 +161,41 @@ Layering this on top of a workflow prefix (e.g., `Strictly edit <Video 1>, chang
 
 Values below are what the Venice API accepts. Requests outside these ranges are rejected at the schema layer with a 400 before reaching inference.
 
-### Images
-
-| Constraint | Value |
-|---|---|
-| Input methods | URL (`http://`, `https://`) or Base64 data URL (`data:image/...`) |
-| Formats | `.jpeg`, `.png`, `.webp`, `.bmp`, `.tiff`, `.gif`, `.heic`, `.heif` |
-| Aspect ratio (W / H) | exclusive `(0.4, 2.5)` |
-| Minimum side | ≥ 300 px |
-| Image count: I2V first-frame | 1 |
-| Image count: I2V first + last frame | 2 |
-| **Image count: R2V (V2 / Fast)** | **1 – 9** |
+**Seedance 2.0 and Seedance 2.5 use different caps.** Always check the column for the model family you are calling.
 
-### Videos
+### Shared media floors
 
 | Constraint | Value |
 |---|---|
-| Input methods | URL (`http://`, `https://`) or Base64 data URL (`data:video/...`) |
-| Formats | `.mp4`, `.mov` |
+| Image / video / audio input methods | URL (`http://`, `https://`) or Base64 data URL |
+| Image formats | `.jpeg`, `.png`, `.webp`, `.bmp`, `.tiff`, `.gif`, `.heic`, `.heif` |
+| Image aspect ratio (W / H) | exclusive `(0.4, 2.5)` |
+| Image minimum side | ≥ 300 px |
+| Video formats | `.mp4`, `.mov` |
 | Video codecs | H.264 / AVC, H.265 / HEVC |
 | Audio codecs (in container) | AAC, MP3 |
-| **Duration per clip** | `[2, 15]` s (inclusive) |
-| **Max clip count** | 3 (R2V / Stitch / Extend) |
-| **Total combined duration** | ≤ 15 s across all clips |
-| **Per-clip size** | ≤ 50 MB |
-
-### Audio
-
-| Constraint | Value |
-|---|---|
-| Input methods | URL (`http://`, `https://`) or Base64 data URL (`data:audio/...`) |
-| Formats | `.wav`, `.mp3` |
-| **Duration per clip** | `[2, 15]` s |
-| **Max clip count** | 3 |
-| **Total combined duration** | ≤ 15 s across all clips |
-| **Per-clip size** | ≤ 15 MB |
-
-Reference audio is supported on the R2V variants only. Each entry is forwarded to the model as a `role: "reference_audio"` content item that the prompt addresses as `<Audio 1>`, `<Audio 2>`, `<Audio 3>` — the model uses each clip for vocal timbre, sound effects, or background music depending on how the prompt frames it. The legacy singular `audio_url` field maps to the same content shape and is now equivalent to passing a one-element `reference_audio_urls`.
+| Audio formats (reference audio) | `.wav`, `.mp3` |
+| Per-clip video size | ≤ 50 MB |
+| Per-clip audio size | ≤ 15 MB |
+| I2V first-frame images | 1 |
+| I2V first + last frame | 2 |
+
+### Family comparison
+
+| Constraint | Seedance 2.0 (+ Fast) | Seedance 2.5 |
+|---|---|---|
+| Output duration | 4–15 s | 4–30 s (default 10) |
+| Output resolutions | 480p / 720p / 1080p / **4k** (Fast: 480p / 720p only) | 480p / 720p only |
+| R2V reference images | 1–9 | 1–30 |
+| Max R2V reference image bytes | (shared request limits) | ≤ 30 MB per image |
+| R2V reference videos | ≤ 3 | ≤ 10 |
+| Duration per reference video | `[2, 15]` s | `[2, 30]` s |
+| Combined reference video duration | ≤ 15 s | ≤ 30 s |
+| R2V reference audio clips | ≤ 3 | ≤ 10 |
+| Duration per reference audio | `[2, 15]` s | `[2, 30]` s |
+| Combined reference audio duration | ≤ 15 s | ≤ 30 s |
+
+Reference audio is supported on the R2V variants only. Each entry is forwarded to the model as a `role: "reference_audio"` content item that the prompt addresses as `<Audio 1>`, `<Audio 2>`, … — the model uses each clip for vocal timbre, sound effects, or background music depending on how the prompt frames it. The legacy singular `audio_url` field maps to the same content shape and is now equivalent to passing a one-element `reference_audio_urls`.
 
 <Warning>
 **`reference_audio_urls` cannot be the only reference input.** The model requires at least one image or video reference alongside any audio donor. Pair `reference_audio_urls` with `reference_image_urls`, `reference_video_urls`, `image_url`, or `video_url` — audio-only submissions are rejected.
@@ -211,7 +218,7 @@ curl -X POST https://api.venice.ai/api/v1/video/quote \
   -H "Authorization: Bearer $VENICE_API_KEY" \
   -H "Content-Type: application/json" \
   -d '{
-    "model": "seedance-2-0-reference-to-video",
+    "model": "seedance-2-0-reference-to-video-basic",
     "duration": "5s",
     "resolution": "1080p",
     "aspect_ratio": "16:9",
@@ -232,7 +239,7 @@ curl -X POST https://api.venice.ai/api/v1/video/queue \
   -H "Authorization: Bearer $VENICE_API_KEY" \
   -H "Content-Type: application/json" \
   -d '{
-    "model": "seedance-2-0-text-to-video",
+    "model": "seedance-2-0-text-to-video-basic",
     "prompt": "A golden retriever frolicking through a sunlit meadow at sunset, slow camera dolly-in, shallow depth of field, warm cinematic lighting.",
     "duration": "5s",
     "aspect_ratio": "16:9",
@@ -240,6 +247,36 @@ curl -X POST https://api.venice.ai/api/v1/video/queue \
   }'
 ```
 
+### Seedance 2.0 text-to-video (4K)
+
+```bash
+curl -X POST https://api.venice.ai/api/v1/video/queue \
+  -H "Authorization: Bearer $VENICE_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "model": "seedance-2-0-text-to-video-basic",
+    "prompt": "Ultra-detailed aerial glide over a sunlit alpine lake, crystal water, distant peaks, cinematic color grade.",
+    "duration": "5s",
+    "aspect_ratio": "16:9",
+    "resolution": "4k"
+  }'
+```
+
+### Seedance 2.5 text-to-video (longer duration)
+
+```bash
+curl -X POST https://api.venice.ai/api/v1/video/queue \
+  -H "Authorization: Bearer $VENICE_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "model": "seedance-2-5-text-to-video-basic",
+    "prompt": "A slow aerial push over misty mountains at sunrise, clouds parting, soft orchestral ambience, cinematic widescreen framing.",
+    "duration": "20s",
+    "aspect_ratio": "16:9",
+    "resolution": "720p"
+  }'
+```
+
 ### Image-to-video (first frame)
 
 ```bash
@@ -247,7 +284,7 @@ curl -X POST https://api.venice.ai/api/v1/video/queue \
   -H "Authorization: Bearer $VENICE_API_KEY" \
   -H "Content-Type: application/json" \
   -d '{
-    "model": "seedance-2-0-image-to-video",
+    "model": "seedance-2-0-image-to-video-basic",
     "prompt": "The lighthouse keeper turns toward the storm, lantern raised, waves crashing against the rocks.",
     "image_url": "https://example.com/lighthouse.jpg",
     "duration": "5s",
@@ -256,7 +293,7 @@ curl -X POST https://api.venice.ai/api/v1/video/queue \
 ```
 
 <Note>
-`seedance-2-0-image-to-video` (and its Fast variant) **do not accept `aspect_ratio`** — the output aspect ratio is auto-derived from the input image's dimensions. Passing the field returns a 400 with *"This model does not support aspect_ratio"*. Use the T2V or R2V variants if you need explicit aspect-ratio control.
+Seedance I2V models (`seedance-2-0-image-to-video-basic`, its Fast variant, and `seedance-2-5-image-to-video-basic`) **do not accept `aspect_ratio`** — the output aspect ratio is auto-derived from the input image's dimensions. Passing the field returns a 400 with *"This model does not support aspect_ratio"*. Use the T2V or R2V variants if you need explicit aspect-ratio control.
 </Note>
 
 ### Reference workflow — subject donor
@@ -266,7 +303,7 @@ curl -X POST https://api.venice.ai/api/v1/video/queue \
   -H "Authorization: Bearer $VENICE_API_KEY" \
   -H "Content-Type: application/json" \
   -d '{
-    "model": "seedance-2-0-reference-to-video",
+    "model": "seedance-2-0-reference-to-video-basic",
     "prompt": "Refer to <Subject 1> in <Image 1> to generate a 5-second clip of the same character walking through a neon-lit Tokyo street at night.",
     "reference_image_urls": ["https://example.com/character.png"],
     "duration": "5s",
@@ -275,6 +312,25 @@ curl -X POST https://api.venice.ai/api/v1/video/queue \
   }'
 ```
 
+### Seedance 2.5 reference workflow — multi-image
+
+```bash
+curl -X POST https://api.venice.ai/api/v1/video/queue \
+  -H "Authorization: Bearer $VENICE_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "model": "seedance-2-5-reference-to-video-basic",
+    "prompt": "Refer to <Subject 1> in <Image 1> and the style in <Image 2> to generate a 12-second clip of the same character exploring a rainy cyberpunk alley.",
+    "reference_image_urls": [
+      "https://example.com/character.png",
+      "https://example.com/style-board.png"
+    ],
+    "duration": "12s",
+    "aspect_ratio": "9:16",
+    "resolution": "720p"
+  }'
+```
+
 ### Reference workflow — subject + audio donor
 
 ```bash
@@ -282,7 +338,7 @@ curl -X POST https://api.venice.ai/api/v1/video/queue \
   -H "Authorization: Bearer $VENICE_API_KEY" \
   -H "Content-Type: application/json" \
   -d '{
-    "model": "seedance-2-0-reference-to-video",
+    "model": "seedance-2-0-reference-to-video-basic",
     "prompt": "Refer to <Subject 1> in <Image 1> to generate a 5-second clip of the same character walking through a neon-lit Tokyo street at night. Refer to the timbre in <Audio 1> for a soft female voiceover describing the scene.",
     "reference_image_urls": ["https://example.com/character.png"],
     "reference_audio_urls": ["https://example.com/voice-sample.mp3"],
@@ -299,7 +355,7 @@ curl -X POST https://api.venice.ai/api/v1/video/queue \
   -H "Authorization: Bearer $VENICE_API_KEY" \
   -H "Content-Type: application/json" \
   -d '{
-    "model": "seedance-2-0-reference-to-video",
+    "model": "seedance-2-0-reference-to-video-basic",
     "prompt": "Strictly edit <Video 1>, changing its weather from sunny to a heavy rainstorm, with all original motions and camera work preserved.",
     "reference_video_urls": ["https://example.com/sunny-scene.mp4"],
     "reference_video_total_duration": 5,
@@ -316,7 +372,7 @@ curl -X POST https://api.venice.ai/api/v1/video/queue \
   -H "Authorization: Bearer $VENICE_API_KEY" \
   -H "Content-Type: application/json" \
   -d '{
-    "model": "seedance-2-0-reference-to-video",
+    "model": "seedance-2-0-reference-to-video-basic",
     "prompt": "Replace the perfume featured in <Video 1> with the face cream from <Image 1>, with all original motions and camera work preserved.",
     "reference_video_urls": ["https://example.com/perfume-ad.mp4"],
     "reference_image_urls": ["https://example.com/face-cream.png"],
@@ -334,7 +390,7 @@ curl -X POST https://api.venice.ai/api/v1/video/queue \
   -H "Authorization: Bearer $VENICE_API_KEY" \
   -H "Content-Type: application/json" \
   -d '{
-    "model": "seedance-2-0-reference-to-video",
+    "model": "seedance-2-0-reference-to-video-basic",
     "prompt": "Extend <Video 1>, generate a dramatic chase scene through narrow alleys at dusk, with neon signs flickering and rain on the pavement.",
     "reference_video_urls": ["https://example.com/alley-intro.mp4"],
     "reference_video_total_duration": 4,
@@ -351,7 +407,7 @@ curl -X POST https://api.venice.ai/api/v1/video/queue \
   -H "Authorization: Bearer $VENICE_API_KEY" \
   -H "Content-Type: application/json" \
   -d '{
-    "model": "seedance-2-0-reference-to-video",
+    "model": "seedance-2-0-reference-to-video-basic",
     "prompt": "<Video 1> + a wisp of smoke transforms into a flock of birds + followed by <Video 2> + a slow dolly-in + followed by <Video 3>",
     "reference_video_urls": [
       "https://example.com/clip-1.mp4",
@@ -374,7 +430,7 @@ curl -X POST https://api.venice.ai/api/v1/video/retrieve \
   -H "Authorization: Bearer $VENICE_API_KEY" \
   -H "Content-Type: application/json" \
   -d '{
-    "model": "seedance-2-0-reference-to-video",
+    "model": "seedance-2-0-reference-to-video-basic",
     "queue_id": "123e4567-e89b-12d3-a456-426614174000"
   }' \
   -o output.mp4
@@ -388,15 +444,18 @@ The response is JSON (`{ "status": "queued" | "running" | "failed", ... }`) unti
 
 ### `At least one reference is required for this model`
 
-Reference-to-video submissions must include at least one of `reference_image_urls`, `reference_video_urls`, `image_references`, or `video_references`. Pure text-only generation isn't a valid R2V workflow — use `seedance-2-0-text-to-video` instead. `reference_audio_urls` alone is not sufficient (see the Audio section above).
+Reference-to-video submissions must include at least one of `reference_image_urls`, `reference_video_urls`, `image_references`, or `video_references`. Pure text-only generation isn't a valid R2V workflow — use a text-to-video model ID instead. `reference_audio_urls` alone is not sufficient (see the Audio section above).
 
-### `reference_video_urls must have at most 3 videos`
+### Too many reference videos / images
 
-The model caps reference videos at 3. If you need more clips, run a Stitch first (3 → 1), then use the output as a reference for a follow-up.
+Seedance **2.0** caps R2V at **9 images** and **3 videos**. Seedance **2.5** raises those caps to **30 images** and **10 videos**. If you exceed the family limit, trim inputs or stitch offline first.
 
-### `Per clip must be 2–15s` / aggregate `> 15s`
+### Duration / aggregate duration errors
 
-Per-clip duration is `[2, 15]` seconds **inclusive**; the sum across all reference videos is also capped at 15 seconds. Trim clips client-side before submission.
+- **2.0:** per-clip reference video/audio `[2, 15]` s; combined video/audio ≤ 15 s; output 4–15 s.
+- **2.5:** per-clip reference video/audio `[2, 30]` s; combined video/audio ≤ 30 s; output 4–30 s.
+
+Trim clips client-side before submission.
 
 ### Prompt routes to the wrong workflow
 
@@ -408,6 +467,10 @@ Workflow is inferred from prompt syntax. Common misroutings:
 
 Use the canonical prefixes exactly as written: `Strictly edit <Video 1>, ...`, `Extend <Video 1>, ...`, `<Video 1> + ... + followed by <Video 2>`.
 
+### Face / likeness inputs rejected
+
+Public Seedance API models are **faces-off**. Do not expect a consent attestation flow. Face-bearing media may fail with a content-policy / provider error. Use the Venice app or Studio for likeness workflows.
+
 ### Quote doesn't match the queued amount
 
 If you included a reference video but didn't pass `reference_video_total_duration` to `/video/quote`, the quote and the queued amount may differ. Always pass `reference_video_total_duration` (sum of all reference clip durations, in seconds) when reference videos are present.
diff --git a/guides/media/video-generation.mdx b/guides/media/video-generation.mdx
index a4ecca8f..19514f3a 100644
--- a/guides/media/video-generation.mdx
+++ b/guides/media/video-generation.mdx
@@ -340,7 +340,7 @@ Get exact cost before generating. Send only pricing inputs (`model`, `duration`,
 Quote is in USD.
 
 <Info>
-**Quote parameters are pricing inputs only.** Fields you send to `/video/quote` — including `aspect_ratio`, `audio`, and `reference_video_total_duration` — are used purely to compute the price. They are **not** forwarded to `/video/queue` and do not affect the generated video. Sending `aspect_ratio` to quote is accepted even for models (such as `seedance-2-0-image-to-video`) that reject `aspect_ratio` at generation time, since image-to-video models derive the output aspect ratio from the input image.
+**Quote parameters are pricing inputs only.** Fields you send to `/video/quote` — including `aspect_ratio`, `audio`, and `reference_video_total_duration` — are used purely to compute the price. They are **not** forwarded to `/video/queue` and do not affect the generated video. Sending `aspect_ratio` to quote is accepted even for models (such as `seedance-2-0-image-to-video-basic`) that reject `aspect_ratio` at generation time, since image-to-video models derive the output aspect ratio from the input image.
 </Info>
 
 ### Reference-to-video pricing