chore: sync Comfy API v2 specification and Comfy Router pages (cloud@fdf7af6)

development/comfy-router/limitations.mdx

@@ -4,50 +4,45 @@
 description: "Choose Router or a partner proxy, plan for long-running calls, and understand recovery, rate limits, and asset storage."
 ---
 
-Router supports synchronous and queued delivery. Synchronous delivery returns the finished result in one response. Queued delivery returns a request handle and is rolling out by workspace.
+Router runs a partner model through one synchronous HTTP call or through a queued request that you submit and collect later. Use it when your application can wait for a finished result or collect one later, and can handle the model's own input and output fields.
 
 ## What Router supports
 
 | Requirement | Router support | Alternative or next step |
 | --- | --- | --- |
 | Generate with one request | `POST /v2/models/{provider}/{model}` returns the finished result. | Start with the [Quickstart](/development/comfy-router/quickstart). |
-| Submit a request and collect it later | Supported through `POST /v2/models/{provider}/{model}/requests` and rolling out by workspace. | See [Queued delivery](/development/comfy-router/queue). |
-| Show progress or stream output | Queued delivery reports queue state and can include queue position, but no percentage progress, streaming output, or preview frames. | Poll the returned `status_url`, or use a supported proxy operation for provider-specific progress. |
-| Recover after a lost connection | After receiving a queued request handle, use its returned URLs. If submission is interrupted before that, retry with the same idempotency key. Synchronous calls can sometimes be collected the same way. | Preserve the idempotency key and follow [retry guidance](/development/comfy-router/api#retry-outcomes). |
+| Submit a job and collect it later | Queued delivery: `POST /v2/models/{provider}/{model}/requests` returns a `request_id` to poll and collect. No completion webhook. | Use [queued delivery](/development/comfy-router/queue). A partner proxy with submit-and-poll operations exposes the provider's own controls. |
+| Show progress or stream output | No live progress, streaming, or preview frames during the call. | Show an indeterminate state, or use a supported proxy operation. |
+| Recover after a lost connection | Same-key collection is available when Router retained a handle to an accepted generation. | Preserve the key and follow [retry guidance](/development/comfy-router/api#retry-outcomes). |
 | Reconcile Comfy charges | No universal Comfy cost or credit-balance field on the response. | Use [workspace billing](https://platform.comfy.org). |
 | Store results permanently | Asset URLs can expire, including rehosted and replayed URLs. | Download the assets; see [result assets](/development/comfy-router/reference#result-assets). |
-| Send large media inline | The request body is capped, and base64-encoded media counts against that cap. | Keep bodies under the cap; see [request body size](#request-bodies-are-capped). |
 
-## Queued delivery availability
+<span id="no-queued-submission" />
 
-Queued delivery returns a `request_id` and URLs for status, result collection, and cancellation. It is rolling out by workspace; workspaces without access receive `403` with `not_enabled`. Cancellation is best effort, and Router does not provide a completion webhook. See [Queued delivery](/development/comfy-router/queue) for examples and the full lifecycle.
+## Queued submission
 
-## Synchronous calls are cut off at a server deadline
+The synchronous route holds the connection while the model runs; for asynchronous providers, Router submits the job and polls internally. Queued delivery (submit, get a `request_id`, poll, collect) is the alternative: see [Queued delivery](/development/comfy-router/queue). It is scoped to the workspace behind the credential, so it needs a key created in your Comfy workspace. A legacy key with no workspace, a bring-your-own-key request, or a model the queue cannot run answers `403` with `not_enabled` on the submit route. Neither mode offers a callback or webhook.
+
+If your request cannot stay open long enough, queue it. Use a [partner proxy](#router-does-not-cover-every-partner-operation) when you need the provider's own submit-and-poll controls.
+
+Two models are synchronous-only for now and are refused with `403` / `not_enabled` if you submit them to the queue: `elevenlabs/eleven_sfx_v2` and `elevenlabs/eleven_v3`. They answer raw audio bytes rather than a JSON result document, which queued delivery has nowhere to store. Run them on the synchronous route, which returns those bytes normally.
+
+The LTX v1 text-to-video and image-to-video operations answer raw video bytes for the same reason, and queued delivery cannot store them either — but they are reachable only through the [partner proxy](#router-does-not-cover-every-partner-operation) at `/proxy/ltx/v1/…`, not through a Router model id: every `ltx/*` catalog model resolves to the queueable v2 submit-and-poll operation.
+
+## Calls are cut off at a server deadline
 
 Router's default deadline is **10 minutes**, configurable by the deployment. Set your client timeout above it so Router can return its error and request ID first.
 
 `504` / `deadline_exceeded` means Router stopped waiting; `504` / `provider_timeout` means the provider timed out. A timeout or lost connection does not prove that a generation was unbilled, and it does not cancel accepted provider work. Read [timeouts and collection](/development/comfy-router/api#timeouts-and-collection) before retrying.
 
 <span id="no-way-to-resume-a-call-you-lost" />
 
 ## Recovery depends on the provider
 
 Router can retain a provider handle for an accepted submit-and-poll generation. Reuse the same `Idempotency-Key` to collect it later; completed replayable responses can also come from the key record.
 
 Not every disconnected call is recoverable. Preserve the request and key before sending, then use the [retry outcome table](/development/comfy-router/api#retry-outcomes). A new key creates a new call and may incur another charge.
 
-## Request bodies are capped
-
-Router refuses a request whose body is larger than **10 MiB (10,485,760 bytes)**. The bound is on the raw bytes you send, measured before Router parses anything, so it applies to every route and to both synchronous and queued delivery.
-
-Inline media is where callers meet it. Base64 encoding inflates binary data by about 4/3, so a body carrying encoded media clears the cap at roughly **7.5 MB of actual image, audio, or video bytes**. Size the encoded string, not the file on disk, and count every input in one call: a request carrying two reference images spends the allowance on both, and the prompt, parameters, and JSON structure count too.
-
-**What the refusal looks like.** `413`, with `invalid_input` on `X-Comfy-Error-Type` and `X-Comfy-Request-Id` set as on any other response. The body is a [`RouterErrorResponse`](/development/comfy-router/reference#routererrorresponse) whose `detail` describes the bound that was exceeded. Branch on `error_type` rather than parsing `detail`, and treat what the API returns as authoritative if it and this page ever disagree about the figure. Router raises the refusal before dispatching anything, so no generation ran and nothing was charged.
-
-The cap applies to every request, whether or not it carries an `Idempotency-Key`. It is not an idempotency limit, and re-sending the same key does not change the outcome: a body that is too large is too large on every attempt.
-
-**A provider can impose a lower limit of its own.** Providers publish their own bounds on inline media, and the binding constraint is whichever is smaller. Google's models, for example, accept up to 20 MB (decimal, 20,000,000 bytes) of inline payload, and the `Size limit: 20MB` line on the Google model pages is that per-field Google bound quoted from Google's own specification, not Router's bound on the whole request body. A body that clears Router's cap but exceeds a provider's own limit is refused by the provider rather than by Router, and it comes back as a provider error rather than a `413`.
-
 ## Requests are rate limited per caller
 
 | Response | Cause | Action |
@@ -59,11 +54,11 @@
 
 Cache catalog and schema reads. Revalidate schemas with `ETag` and `If-None-Match`. See [Headers](/development/comfy-router/headers) for retry and committed-spend fields.
 
-## No live progress while a request runs
+## No progress while a call runs
 
-Synchronous delivery returns only the final response. Queued delivery exposes queue state and can include queue position, but neither mode provides streamed tokens, server-sent events, percentage updates, or intermediate preview frames. A provider's internal progress is not forwarded.
+Router returns a final response, with no streamed tokens, server-sent events, percentage updates, or intermediate preview frames. A provider's internal polling state is not forwarded during the request.
 
-Show an indeterminate progress indicator after a queued request begins running. If you need provider-specific progress or streaming, use a partner-proxy operation that exposes it.
+Show an indeterminate progress indicator. If you need progress or streaming, use a partner-proxy operation that exposes it.
 
 <span id="no-cost-or-credit-figures-on-a-response" />
 
@@ -81,7 +76,7 @@
 
 Input and output fields vary by model. Moving from a provider SDK or proxy can change both the route and how you read the result.
 
 Some assets are rehosted on Comfy storage; others are provider URLs or inline bytes. See [Result assets](/development/comfy-router/reference#result-assets) for lifetimes and replay behavior.
 
 ## Next
 

development/comfy-router/models.mdx

@@ -21,7 +21,7 @@
 - [Claude Sonnet 4.6](/development/comfy-router/models/anthropic/claude-sonnet-4-6/code): `anthropic/claude-sonnet-4-6`
 - [Claude Sonnet 5](/development/comfy-router/models/anthropic/claude-sonnet-5/code): `anthropic/claude-sonnet-5`
 
 ## Beeble
 
 - [SwitchX](/development/comfy-router/models/beeble/switchx/code): `beeble/switchx`
 
@@ -41,7 +41,7 @@
 - [Video Edit V1](/development/comfy-router/models/black-forest-labs/video-edit-v1/code): `bfl/video-edit-v1`
 - [VTO V1](/development/comfy-router/models/black-forest-labs/vto-v1/code): `bfl/vto-v1`
 
 ## Bria
 
 - [Fibo](/development/comfy-router/models/bria/fibo/code): `bria/fibo`
 - [Image Edit Erase](/development/comfy-router/models/bria/image-edit-erase/code): `bria/image-edit-erase`
@@ -65,30 +65,26 @@
 - [Seed 2.0 Pro 260328](/development/comfy-router/models/byteplus/seed-2-0-pro-260328/code): `byteplus/seed-2-0-pro-260328`
 - [Seed Audio 1.0 Multilingual](/development/comfy-router/models/byteplus/seed-audio-1-0-multilingual/code): `byteplus/seed-audio-1.0-multilingual`
 - [Seed Audio 1.0](/development/comfy-router/models/byteplus/seed-audio-1-0/code): `byteplus/seed-audio-1.0`
-- [Seedance 1.0 Lite I2V 250428](/development/comfy-router/models/byteplus/seedance-1-0-lite-i2v-250428/code): `byteplus/seedance-1-0-lite-i2v-250428`
-- [Seedance 1.0 Lite T2V 250428](/development/comfy-router/models/byteplus/seedance-1-0-lite-t2v-250428/code): `byteplus/seedance-1-0-lite-t2v-250428`
 - [Seedance 1.0 Pro 250528](/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code): `byteplus/seedance-1-0-pro-250528`
 - [Seedance 1.0 Pro Fast 251015](/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code): `byteplus/seedance-1-0-pro-fast-251015`
 - [Seedance 1.5 Pro 251215](/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code): `byteplus/seedance-1-5-pro-251215`
-- [Seededit 3.0 I2I 250628](/development/comfy-router/models/byteplus/seededit-3-0-i2i-250628/code): `byteplus/seededit-3-0-i2i-250628`
-- [Seedream 3.0 T2I 250415](/development/comfy-router/models/byteplus/seedream-3-0-t2i-250415/code): `byteplus/seedream-3-0-t2i-250415`
 - [Seedream 4.0 250828](/development/comfy-router/models/byteplus/seedream-4-0-250828/code): `byteplus/seedream-4-0-250828`
 - [Seedream 4.5 251128](/development/comfy-router/models/byteplus/seedream-4-5-251128/code): `byteplus/seedream-4-5-251128`
 - [Seedream 5.0 260128](/development/comfy-router/models/byteplus/seedream-5-0-260128/code): `byteplus/seedream-5-0-260128`
 - [Seedream 5.0 Pro 260628](/development/comfy-router/models/byteplus/seedream-5-0-pro-260628/code): `byteplus/seedream-5-0-pro-260628`
 
 ## Elevenlabs
 
 - [Eleven Sfx V2](/development/comfy-router/models/elevenlabs/eleven-sfx-v2/code): `elevenlabs/eleven_sfx_v2`
 - [Eleven V3](/development/comfy-router/models/elevenlabs/eleven-v3/code): `elevenlabs/eleven_v3`
 
 ## fal
 
 - [H3 Max Turbo](/development/comfy-router/models/fal/h3-max-turbo/code): `fal/h3-max-turbo`
 - [H3 Max](/development/comfy-router/models/fal/h3-max/code): `fal/h3-max`
 - [Patina](/development/comfy-router/models/fal/patina/code): `fal/patina`
 
 ## Freepik
 
 - [AI Image Upscaler Precision V2](/development/comfy-router/models/freepik/ai-image-upscaler-precision-v2/code): `freepik/ai-image-upscaler-precision-v2`
 - [AI Skin Enhancer Creative](/development/comfy-router/models/freepik/ai-skin-enhancer-creative/code): `freepik/ai-skin-enhancer-creative`
@@ -124,18 +120,12 @@
 - [Ideogram 4.0](/development/comfy-router/models/ideogram/ideogram-v4/code): `ideogram/ideogram-v4`
 - [P Image Ideogram](/development/comfy-router/models/ideogram/p-image-ideogram/code): `ideogram/p-image-ideogram`
 
 ## Kling
 
 - [Kling 3.0 Turbo](/development/comfy-router/models/kling/kling-3-0-turbo/code): `kling/kling-3.0-turbo`
 - [Kling Image O1](/development/comfy-router/models/kling/kling-image-o1/code): `kling/kling-image-o1`
-- [Kling V1.5](/development/comfy-router/models/kling/kling-v1-5/code): `kling/kling-v1-5`
-- [Kling V1.6](/development/comfy-router/models/kling/kling-v1-6/code): `kling/kling-v1-6`
-- [Kling V1](/development/comfy-router/models/kling/kling-v1/code): `kling/kling-v1`
-- [Kling V2.1 Master](/development/comfy-router/models/kling/kling-v2-1-master/code): `kling/kling-v2-1-master`
-- [Kling V2.1](/development/comfy-router/models/kling/kling-v2-1/code): `kling/kling-v2-1`
 - [Kling V2.5 Turbo](/development/comfy-router/models/kling/kling-v2-5-turbo/code): `kling/kling-v2-5-turbo`
 - [Kling V2.6](/development/comfy-router/models/kling/kling-v2-6/code): `kling/kling-v2-6`
-- [Kling V2 Master](/development/comfy-router/models/kling/kling-v2-master/code): `kling/kling-v2-master`
 - [Kling V3 Omni](/development/comfy-router/models/kling/kling-v3-omni/code): `kling/kling-v3-omni`
 - [Kling V3](/development/comfy-router/models/kling/kling-v3/code): `kling/kling-v3`
 - [Kling Video O1](/development/comfy-router/models/kling/kling-video-o1/code): `kling/kling-video-o1`
@@ -143,7 +133,7 @@
 - [Videos Lip Sync](/development/comfy-router/models/kling/videos-lip-sync/code): `kling/videos-lip-sync`
 - [Videos Video Extend](/development/comfy-router/models/kling/videos-video-extend/code): `kling/videos-video-extend`
 
 ## Krea
 
 - [Krea 2 Large](/development/comfy-router/models/krea/krea-2-large/code): `krea/krea-2-large`
 - [Krea 2 Medium Turbo](/development/comfy-router/models/krea/krea-2-medium-turbo/code): `krea/krea-2-medium-turbo`
@@ -155,19 +145,19 @@
 - [LTX 2.5 Fast](/development/comfy-router/models/ltx/ltx-2-5-fast/code): `ltx/ltx-2-5-fast`
 - [LTX 2.5 Pro](/development/comfy-router/models/ltx/ltx-2-5-pro/code): `ltx/ltx-2-5-pro`
 
 ## Luma
 
 - [Photon 1](/development/comfy-router/models/luma/photon-1/code): `luma/photon-1`
 - [Photon Flash 1](/development/comfy-router/models/luma/photon-flash-1/code): `luma/photon-flash-1`
 - [Ray 2](/development/comfy-router/models/luma/ray-2/code): `luma/ray-2`
 - [Ray Flash 2](/development/comfy-router/models/luma/ray-flash-2/code): `luma/ray-flash-2`
 
 ## Luma 2
 
 - [Uni 1 Max](/development/comfy-router/models/luma_2/uni-1-max/code): `luma_2/uni-1-max`
 - [Uni 1](/development/comfy-router/models/luma_2/uni-1/code): `luma_2/uni-1`
 
 ## Meshy
 
 - [Animations](/development/comfy-router/models/meshy/animations/code): `meshy/animations`
 - [Meshy 5](/development/comfy-router/models/meshy/meshy-5/code): `meshy/meshy-5`
@@ -180,7 +170,7 @@
 
 - [MiniMax H3](/development/comfy-router/models/minimax/minimax-h3/code): `minimax/minimax-h3`
 
 ## Moonvalley
 
 - [Image To Video](/development/comfy-router/models/moonvalley/image-to-video/code): `moonvalley/image-to-video`
 - [Text To Image](/development/comfy-router/models/moonvalley/text-to-image/code): `moonvalley/text-to-image`
@@ -213,16 +203,16 @@
 - [o3](/development/comfy-router/models/openai/o3/code): `openai/o3`
 - [o4-mini](/development/comfy-router/models/openai/o4-mini/code): `openai/o4-mini`
 
 ## Pruna
 
 - [P Video 2](/development/comfy-router/models/pruna/p-video-2/code): `pruna/p-video-2`
 
 ## Qwen
 
 - [Qwen Image 3.0 Pro](/development/comfy-router/models/qwen/qwen-image-3-0-pro/code): `qwen/qwen-image-3.0-pro`
 - [Qwen Image 3.0](/development/comfy-router/models/qwen/qwen-image-3-0/code): `qwen/qwen-image-3.0`
 
 ## Recraft
 
 - [Recraft V2](/development/comfy-router/models/recraft/recraftv2/code): `recraft/recraftv2`
 - [Recraft V3](/development/comfy-router/models/recraft/recraftv3/code): `recraft/recraftv3`
@@ -247,14 +237,14 @@
 - [Gen 4 Image](/development/comfy-router/models/runway/gen4-image/code): `runway/gen4_image`
 - [Gen 4 Turbo](/development/comfy-router/models/runway/gen4-turbo/code): `runway/gen4_turbo`
 
 ## Tencent
 
 - [Hunyuan 3D Part](/development/comfy-router/models/tencent/hunyuan-3d-part/code): `tencent/hunyuan-3d-part`
 - [Hunyuan 3D Smart Topology](/development/comfy-router/models/tencent/hunyuan-3d-smart-topology/code): `tencent/hunyuan-3d-smart-topology`
 - [Hunyuan 3D Texture Edit](/development/comfy-router/models/tencent/hunyuan-3d-texture-edit/code): `tencent/hunyuan-3d-texture-edit`
 - [Hunyuan 3D Uv](/development/comfy-router/models/tencent/hunyuan-3d-uv/code): `tencent/hunyuan-3d-uv`
 
 ## Veo
 
 - [Veo 2.0 Generate 001](/development/comfy-router/models/veo/veo-2-0-generate-001/code): `veo/veo-2.0-generate-001`
 - [Veo 3.0 Fast Generate 001](/development/comfy-router/models/veo/veo-3-0-fast-generate-001/code): `veo/veo-3.0-fast-generate-001`

development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx

@@ -1,5 +1,5 @@
 ---
 title: "Use Dreamina Seedance 2.0 260128 with Comfy Router"
 description: "Call byteplus/dreamina-seedance-2-0-260128 through Comfy Router: endpoint, request shape and the response Router returns."
 sidebarTitle: "Dreamina Seedance 2.0 260128"
 ---
@@ -79,7 +79,7 @@
 
 <CodeGroup>
 ```python Python
 from comfy_sdk import Comfy
 
 # Reads COMFY_API_KEY from the environment.
 # Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
@@ -176,17 +176,17 @@
 </ParamField>
 
 <ParamField body="content[].audio_url" type="object">
   Input audio object. Only Seedance 2.5, 2.0 & 2.0 fast support audio input. Seedance 2.0 & 2.0 fast cannot use audio alone - they must include at least 1 image or video; Seedance 2.5 supports audio-only input.
 </ParamField>
 
 <ParamField body="content[].audio_url.url" type="string" required>
   Audio URL, Base64 encoding, or Asset ID.
 Audio URL: Public URL of the audio (wav, mp3).
 Base64: Format data:audio/\<format>;base64,\<content>
 Asset ID: Format asset://\<ASSET_ID>
 </ParamField>
 
 <ParamField body="content[].image_url" type="object">
 
 </ParamField>
 
@@ -199,9 +199,9 @@
 
 <ParamField body="content[].role" type="string">
   The role/position of the content item.
 For images: first_frame, last_frame, or reference_image.
 For videos: reference_video (Seedance 2.5, 2.0 & 2.0 fast only).
 For audio: reference_audio (Seedance 2.5, 2.0 & 2.0 fast only).
 
   Possible values: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio`
 </ParamField>
@@ -221,6 +221,16 @@
 - --camerafixed (--cf): true/false (default: false)
 
 Example: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5"
+
+Comfy-side guardrail, not a BytePlus constraint. BytePlus publishes no
+text-length limit and accepted 40,000 characters under test (2026-09-17).
+It counts characters, not bytes, so a multi-byte prompt may be several
+times this size on the wire. It bounds this one field, not the request:
+`content` is an array, and the per-request body limit is what bounds the
+whole document. Comfy Router (/v2/models/byteplus/\{model}) is the surface
+that enforces it; on a direct v1 /proxy call BytePlus's own validator
+answers instead. Set far above real traffic so it never adjudicates a
+genuine prompt — raise it if a caller needs more.
 </ParamField>
 
 <ParamField body="content[].type" type="string" required>
@@ -230,17 +240,17 @@
 </ParamField>
 
 <ParamField body="content[].video_url" type="object">
   Input video object. Only Seedance 2.5, 2.0 & 2.0 fast support video input.
 </ParamField>
 
 <ParamField body="content[].video_url.url" type="string" required>
   Video URL or Asset ID.
 Video URL: Public URL of the video (mp4, mov).
 Asset ID: Format asset://\<ASSET_ID>
 </ParamField>
 
 <ParamField body="duration" type="`-1` | object">
   Video duration in seconds. Seedance 2.5: [4,30] or -1 (auto; video editing tasks support only -1). Seedance 2.0 & 2.0 fast: [4,15] or -1 (auto). Seedance 1.5 pro: [4,12] or -1. Seedance 1.0: [2,12].
 
   Range: `2` to `30`
 </ParamField>
@@ -252,32 +262,32 @@
 </ParamField>
 
 <ParamField body="generate_audio" type="boolean" default="true">
   Supported by Seedance 2.5, 2.0, 2.0 fast, and 1.5 pro. Whether the generated video includes audio synchronized with the visuals.
 true: The model outputs a video with synchronized audio.
 false: The model outputs a silent video.
 </ParamField>
 
 <ParamField body="model" type="string">
-  The ID of the model to call. Supported models: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, seedance-1-0-lite-t2v-250428, seedance-1-0-lite-i2v-250428, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini and dreamina-seedance-2-5-260628. A direct v1 call to POST /proxy/byteplus/api/v3/contents/generations/tasks MUST supply it — the proxy refuses any other value, and an omitted one, with a 400. It is NOT in this schema's `required` list because Comfy Router fills it from the `{model}` path segment of /v2/models/byteplus/\{model}, so a Router caller omits it.
+  The ID of the model to call. Supported models: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini and dreamina-seedance-2-5-260628. A direct v1 call to POST /proxy/byteplus/api/v3/contents/generations/tasks MUST supply it — the proxy refuses any other value, and an omitted one, with a 400. It is NOT in this schema's `required` list because Comfy Router fills it from the `{model}` path segment of /v2/models/byteplus/\{model}, so a Router caller omits it.
 </ParamField>
 
 <ParamField body="output_format" type="string" default="&quot;mp4&quot;">
   Seedance 2.5 only. Container format of the output video.
 mp4: General-purpose container (H.264/AAC, yuv420p) with broad compatibility and smaller file size.
 mov: Professional container (H.264 High 4:4:4 Predictive/PCM, yuv444p) with high color precision, suited for post-production; larger file size.
 
   Possible values: `mp4`, `mov`
 </ParamField>
 
 <ParamField body="ratio" type="string">
   Aspect ratio of the generated video. Seedance 2.0 & 2.0 fast, 1.5 pro default: adaptive.
 
   Possible values: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive`
 </ParamField>
 
 <ParamField body="resolution" type="string">
   Video resolution. Seedance 2.5, 2.0 & 2.0 fast, 1.5 pro, 1.0 lite default: 720p. Seedance 1.0 pro & pro-fast default: 1080p.
 Note: Seedance 2.0 & 2.0 fast do not support 1080p. Seedance 2.5 supports 480p, 720p, and 1080p.
 
   Possible values: `480p`, `720p`, `1080p`, `4k`
 </ParamField>
@@ -295,7 +305,7 @@
 </ParamField>
 
 <ParamField body="service_tier" type="string">
   Service tier for processing. Seedance 2.5, 2.0 & 2.0 fast do not support flex (offline inference).
 
   Possible values: `default`, `flex`
 </ParamField>
@@ -309,7 +319,7 @@
 ### Output
 
 <ResponseField name="content" type="object">
   The output after the video generation task is completed, which contains the download URL of the output video and, when BytePlus returns one, the download URL of its last frame. Both `video_url` and `last_frame_url` are RE-HOSTED onto Comfy storage; every other field here is BytePlus's own. Nullable - BytePlus clears the URLs 24 hours after the task, and a succeeded document polled after that can carry `content` absent or null.
 </ResponseField>
 
 <ResponseField name="content.last_frame_url" type="string">
@@ -317,7 +327,7 @@
 </ResponseField>
 
 <ResponseField name="content.output_format" type="string">
   Container format of the generated video (mp4 or mov), when BytePlus nests it inside `content`. Seedance models more commonly return it as a TOP-LEVEL sibling of `content` - see the top-level `output_format` field - and Router reads whichever of the two is present.
 </ResponseField>
 
 <ResponseField name="content.video_url" type="string">
@@ -353,7 +363,7 @@
 </ResponseField>
 
 <ResponseField name="output_format" type="string">
   Container format of the generated video (mp4 or mov), returned at the TOP LEVEL as a sibling of `content` - this is where the Seedance video task query returns it. BytePlus's own field, forwarded unchanged.
 </ResponseField>
 
 <ResponseField name="resolution" type="string">
@@ -385,7 +395,7 @@
 </ResponseField>
 
 <ResponseField name="usage.total_tokens" type="integer">
   For the video generation model, the number of input tokens is not calculated and defaults to 0. Therefore, total_tokens = completion_tokens.
 </ResponseField>
 
 ## Examples
@@ -411,8 +421,8 @@
 ```json
 {
   "content": {
-    "last_frame_url": "https://example.invalid/byteplus/seedance-1-0-lite-t2v-250428/last-frame",
-    "video_url": "https://example.invalid/byteplus/seedance-1-0-lite-t2v-250428/generated.mp4"
+    "last_frame_url": "https://example.invalid/byteplus/seedance-1-0-pro-250528/last-frame",
+    "video_url": "https://example.invalid/byteplus/seedance-1-0-pro-250528/generated.mp4"
   },
   "created_at": 1767225600,
   "duration": 5,

development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx

@@ -1,5 +1,5 @@
 ---
 title: "Use Dreamina Seedance 2.0 Fast 260128 with Comfy Router"
 description: "Call byteplus/dreamina-seedance-2-0-fast-260128 through Comfy Router: endpoint, request shape and the response Router returns."
 sidebarTitle: "Dreamina Seedance 2.0 Fast 260128"
 ---
@@ -79,7 +79,7 @@
 
 <CodeGroup>
 ```python Python
 from comfy_sdk import Comfy
 
 # Reads COMFY_API_KEY from the environment.
 # Each submit() call mints its own Idempotency-Key and reuses it for automatic retries.
@@ -176,17 +176,17 @@
 </ParamField>
 
 <ParamField body="content[].audio_url" type="object">
   Input audio object. Only Seedance 2.5, 2.0 & 2.0 fast support audio input. Seedance 2.0 & 2.0 fast cannot use audio alone - they must include at least 1 image or video; Seedance 2.5 supports audio-only input.
 </ParamField>
 
 <ParamField body="content[].audio_url.url" type="string" required>
   Audio URL, Base64 encoding, or Asset ID.
 Audio URL: Public URL of the audio (wav, mp3).
 Base64: Format data:audio/\<format>;base64,\<content>
 Asset ID: Format asset://\<ASSET_ID>
 </ParamField>
 
 <ParamField body="content[].image_url" type="object">
 
 </ParamField>
 
@@ -199,9 +199,9 @@
 
 <ParamField body="content[].role" type="string">
   The role/position of the content item.
 For images: first_frame, last_frame, or reference_image.
 For videos: reference_video (Seedance 2.5, 2.0 & 2.0 fast only).
 For audio: reference_audio (Seedance 2.5, 2.0 & 2.0 fast only).
 
   Possible values: `first_frame`, `last_frame`, `reference_image`, `reference_video`, `reference_audio`
 </ParamField>
@@ -221,6 +221,16 @@
 - --camerafixed (--cf): true/false (default: false)
 
 Example: "A beautiful landscape --ratio 16:9 --resolution 720p --duration 5"
+
+Comfy-side guardrail, not a BytePlus constraint. BytePlus publishes no
+text-length limit and accepted 40,000 characters under test (2026-09-17).
+It counts characters, not bytes, so a multi-byte prompt may be several
+times this size on the wire. It bounds this one field, not the request:
+`content` is an array, and the per-request body limit is what bounds the
+whole document. Comfy Router (/v2/models/byteplus/\{model}) is the surface
+that enforces it; on a direct v1 /proxy call BytePlus's own validator
+answers instead. Set far above real traffic so it never adjudicates a
+genuine prompt — raise it if a caller needs more.
 </ParamField>
 
 <ParamField body="content[].type" type="string" required>
@@ -230,17 +240,17 @@
 </ParamField>
 
 <ParamField body="content[].video_url" type="object">
   Input video object. Only Seedance 2.5, 2.0 & 2.0 fast support video input.
 </ParamField>
 
 <ParamField body="content[].video_url.url" type="string" required>
   Video URL or Asset ID.
 Video URL: Public URL of the video (mp4, mov).
 Asset ID: Format asset://\<ASSET_ID>
 </ParamField>
 
 <ParamField body="duration" type="`-1` | object">
   Video duration in seconds. Seedance 2.5: [4,30] or -1 (auto; video editing tasks support only -1). Seedance 2.0 & 2.0 fast: [4,15] or -1 (auto). Seedance 1.5 pro: [4,12] or -1. Seedance 1.0: [2,12].
 
   Range: `2` to `30`
 </ParamField>
@@ -252,32 +262,32 @@
 </ParamField>
 
 <ParamField body="generate_audio" type="boolean" default="true">
   Supported by Seedance 2.5, 2.0, 2.0 fast, and 1.5 pro. Whether the generated video includes audio synchronized with the visuals.
 true: The model outputs a video with synchronized audio.
 false: The model outputs a silent video.
 </ParamField>
 
 <ParamField body="model" type="string">
-  The ID of the model to call. Supported models: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, seedance-1-0-lite-t2v-250428, seedance-1-0-lite-i2v-250428, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini and dreamina-seedance-2-5-260628. A direct v1 call to POST /proxy/byteplus/api/v3/contents/generations/tasks MUST supply it — the proxy refuses any other value, and an omitted one, with a 400. It is NOT in this schema's `required` list because Comfy Router fills it from the `{model}` path segment of /v2/models/byteplus/\{model}, so a Router caller omits it.
+  The ID of the model to call. Supported models: seedance-1-5-pro-251215, seedance-1-0-pro-250528, seedance-1-0-pro-fast-251015, dreamina-seedance-2-0-260128, dreamina-seedance-2-0-fast-260128, dreamina-seedance-2-0-mini and dreamina-seedance-2-5-260628. A direct v1 call to POST /proxy/byteplus/api/v3/contents/generations/tasks MUST supply it — the proxy refuses any other value, and an omitted one, with a 400. It is NOT in this schema's `required` list because Comfy Router fills it from the `{model}` path segment of /v2/models/byteplus/\{model}, so a Router caller omits it.
 </ParamField>
 
 <ParamField body="output_format" type="string" default="&quot;mp4&quot;">
   Seedance 2.5 only. Container format of the output video.
 mp4: General-purpose container (H.264/AAC, yuv420p) with broad compatibility and smaller file size.
 mov: Professional container (H.264 High 4:4:4 Predictive/PCM, yuv444p) with high color precision, suited for post-production; larger file size.
 
   Possible values: `mp4`, `mov`
 </ParamField>
 
 <ParamField body="ratio" type="string">
   Aspect ratio of the generated video. Seedance 2.0 & 2.0 fast, 1.5 pro default: adaptive.
 
   Possible values: `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `9:21`, `adaptive`
 </ParamField>
 
 <ParamField body="resolution" type="string">
   Video resolution. Seedance 2.5, 2.0 & 2.0 fast, 1.5 pro, 1.0 lite default: 720p. Seedance 1.0 pro & pro-fast default: 1080p.
 Note: Seedance 2.0 & 2.0 fast do not support 1080p. Seedance 2.5 supports 480p, 720p, and 1080p.
 
   Possible values: `480p`, `720p`, `1080p`, `4k`
 </ParamField>
@@ -295,7 +305,7 @@
 </ParamField>
 
 <ParamField body="service_tier" type="string">
   Service tier for processing. Seedance 2.5, 2.0 & 2.0 fast do not support flex (offline inference).
 
   Possible values: `default`, `flex`
 </ParamField>
@@ -309,7 +319,7 @@
 ### Output
 
 <ResponseField name="content" type="object">
   The output after the video generation task is completed, which contains the download URL of the output video and, when BytePlus returns one, the download URL of its last frame. Both `video_url` and `last_frame_url` are RE-HOSTED onto Comfy storage; every other field here is BytePlus's own. Nullable - BytePlus clears the URLs 24 hours after the task, and a succeeded document polled after that can carry `content` absent or null.
 </ResponseField>
 
 <ResponseField name="content.last_frame_url" type="string">
@@ -317,7 +327,7 @@
 </ResponseField>
 
 <ResponseField name="content.output_format" type="string">
   Container format of the generated video (mp4 or mov), when BytePlus nests it inside `content`. Seedance models more commonly return it as a TOP-LEVEL sibling of `content` - see the top-level `output_format` field - and Router reads whichever of the two is present.
 </ResponseField>
 
 <ResponseField name="content.video_url" type="string">
@@ -353,7 +363,7 @@
 </ResponseField>
 
 <ResponseField name="output_format" type="string">
   Container format of the generated video (mp4 or mov), returned at the TOP LEVEL as a sibling of `content` - this is where the Seedance video task query returns it. BytePlus's own field, forwarded unchanged.
 </ResponseField>
 
 <ResponseField name="resolution" type="string">
@@ -385,7 +395,7 @@
 </ResponseField>
 
 <ResponseField name="usage.total_tokens" type="integer">
   For the video generation model, the number of input tokens is not calculated and defaults to 0. Therefore, total_tokens = completion_tokens.
 </ResponseField>
 
 ## Examples
@@ -411,8 +421,8 @@
 ```json
 {
   "content": {
-    "last_frame_url": "https://example.invalid/byteplus/seedance-1-0-lite-t2v-250428/last-frame",
-    "video_url": "https://example.invalid/byteplus/seedance-1-0-lite-t2v-250428/generated.mp4"
+    "last_frame_url": "https://example.invalid/byteplus/seedance-1-0-pro-250528/last-frame",
+    "video_url": "https://example.invalid/byteplus/seedance-1-0-pro-250528/generated.mp4"
   },
   "created_at": 1767225600,
   "duration": 5,