byteplus/seedance-1-0-pro-250528, served by Comfy Router from BytePlus.
Input: Text, Image · Output: Video
Quick start
Create a key in your Comfy workspace and export it asCOMFY_API_KEY. The Python and TypeScript snippets use the Comfy SDKs (pip install comfy-sdk and npm install @comfyorg/sdk); the cURL snippet is the same call over raw HTTP.
Model ID: byteplus/seedance-1-0-pro-250528
Endpoint: POST https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-250528
- Wait for the result
- Queue and collect later
The same body, sent to
POST https://api.comfy.org/v2/models/byteplus/seedance-1-0-pro-250528/requests. Router answers 201 with a request_id as soon as the run is admitted, and the result is collected once it is ready, from this process or another one. Queued delivery walks through status, cancellation and collection.Schema
Input
Ignored. Accepted for compatibility with the BytePlus request shape, but removed before the task is submitted, so no callback is ever sent; poll the task status route for the result instead.Format:
uriInput audio object. Only Seedance 2.5, 2.0, 2.0 fast & 2.0 mini support audio input. Seedance 2.0, 2.0 fast & 2.0 mini cannot use audio alone - they must include at least 1 image or video; Seedance 2.5 supports audio-only input.
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>
Seedance 2.5 only. The Draft task to render as the final video. It must be the only content item.
The final video reuses the Draft task’s prompt, input assets, duration, ratio, seed, generate_audio and omni_reference_task_type; do not send them again. Set resolution on this request for the final’s output tier, including 4k; when it is omitted the final is 1080p.
Image content for image-to-video generation (when type is “image_url”)
Image URL: Make sure that the image URL is accessible.
Base64-encoded content: Format must be data:image/<format>;base64,<content>
Asset ID: Format asset://<ASSET_ID>
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 & 2.0 mini only).
For audio: reference_audio (Seedance 2.5, 2.0, 2.0 fast & 2.0 mini only).Possible values:
first_frame, last_frame, reference_image, reference_video, reference_audioThe input text information for the model. Includes text prompt and optional parameters.Text prompt (required): Description of the video to be generated using Chinese and English characters.Parameters (optional): Add —[parameters] after the text prompt to control video specifications:
- —resolution (—rs): 480p, 720p, 1080p (default: 720p)
- —ratio (—rt): 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, 9:21, adaptive (default: 16:9 or adaptive)
- —duration (—dur): 3-12 seconds (default: 5)
- —framepersecond (—fps): 24 (default: 24)
- —watermark (—wm): true/false (default: false)
- —seed (—seed): -1 to 2^32-1 (default: -1)
- —camerafixed (—cf): true/false (default: false)
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.The type of the input contentPossible values:
text, image_url, video_url, audio_url, draft_taskVideo URL or Asset ID.
Video URL: Public URL of the video (mp4, mov).
Asset ID: Format asset://<ASSET_ID>
Seedance 2.5 only. Generates a 480p Draft video; resolution must be 480p.
Pass the returned task ID in a
draft_task content item to render the final video. That request sets the final’s resolution, including 4k; when resolution is omitted the final is 1080p. The Draft task ID stays valid for 7 days.Video duration in seconds. Seedance 1.0 pro and 1.0 pro fast: [2,12].Possible values:
2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12Task timeout threshold in seconds. Default 172800 (48h). Range: [3600, 259200].Range:
3600 to 259200Supported by Seedance 2.5, 2.0, 2.0 fast, 2.0 mini, 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.
On models that support it, the generated audio track is content-checked by the provider separately from the video; a refusal there is reported as
content_policy_violation and, because the audio differs each run, can be intermittent for an input the provider otherwise accepts. Send false for a silent video if that happens; this helps only when the audio was the refused modality, which a synchronous Router response names as refusal_subject: output_audio (a queued request does not identify it yet). A Seedance 2.5 final render inherits generate_audio from its Draft task, so recreate the Draft with false instead.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.Seedance 2.5 only. The task the reference media is used for. Omitted means auto: the model infers the task from the prompt and the reference media, and a setting that conflicts with its reading (such as
duration or ratio on what it reads as an edit) is resolved only after generation has started, which is billed.
reference: Generates a new video of the requested duration, guided by the reference images, videos and audio.
edit: Changes the connected reference video. The output keeps the source clip’s own length and aspect ratio, so send duration: -1 and omit ratio (or send adaptive).
extend: Continues the reference video. The output is only the newly generated segment, of the requested duration; its aspect ratio follows the clip.
An explicit value is validated by the provider at submit (InvalidParameter.TaskTypeConstraint / TaskTypeMismatch), so a value that does not fit the request fails before generation starts and is not billed; auto has no such check. That check runs on the native BytePlus leg only: an alternate provider leg (on fallback, or picked with model_provider) has no task-type field, drops the value, and that provider infers the task itself, as with auto. The drop is disclosed in X-Comfy-Router-Dropped-Params, on the synchronous run route’s response and on the queued submit’s 201. The queued route has no fallback, so it reaches an alternate leg only through model_provider.Possible values: reference, edit, extendSeedance 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, movAspect ratio of the generated video. Seedance 2.0, 2.0 fast & 2.0 mini, 1.5 pro default: adaptive.
Seedance 2.5 first-frame / first-last-frame generation: the output follows the first frame’s aspect ratio, so only
adaptive (or omitting the field) is accepted; a concrete ratio is refused with a 400 before dispatch. Seedance 2.0 accepts a concrete ratio in those modes.Possible values: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, 9:21, adaptiveVideo resolution. Seedance 2.5, 2.0, 2.0 fast & 2.0 mini, 1.5 pro, 1.0 lite default: 720p. Seedance 1.0 pro & pro-fast default: 1080p.
Note: Seedance 2.0, 2.0 fast & 2.0 mini do not support 1080p. Seedance 2.5 supports 480p, 720p, 1080p, and 4k.Possible values:
480p, 720p, 1080p, 4kWhether to return the last frame image of the generated video.
true: Returns the last frame image of the generated video. After setting this parameter to true, you can obtain the last frame image by calling the Querying the information about a video generation task. The last frame image is in PNG format, with its pixel width and height consistent with those of the generated video, and it contains no watermarks. Using this parameter allows the generation of multiple consecutive videos: the last frame of the previously generated video is used as the first frame of the next video task, enabling quick generation of multiple consecutive videos.
false: Does not return the last frame image of the generated video.
Seed integer for controlling randomness. Range: [-1, 2^32-1]. -1 uses a random seed.Range:
-1 to 4294967295Service tier for processing. Seedance 2.5, 2.0 & 2.0 fast do not support flex (offline inference).Possible values:
default, flexGET /v2/models/byteplus/seedance-1-0-pro-250528/openapi.json, the same document it validates a call against before the request reaches the provider.
Output
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.Download URL for the last frame of the generated video, returned when the request set
return_last_frame. Do not infer the image format from this URL: BytePlus documents the last frame as PNG on the request side, Router re-hosts whatever bytes it is served and types them from the upstream Content-Type or a content sniff, and image/jpeg is only the last-resort fallback when both fail. Router re-hosts the last frame onto Comfy storage and rewrites this field, so it is normally a Comfy-signed URL valid for up to 24 hours - signed for 24 hours when minted and replayed from a 23-hour memo, so a later poll can hand back one with as little as an hour left. When the re-host could not be performed the field keeps BytePlus’s own URL instead, which BytePlus clears 24 hours after the task. Either way the link expires, so download the frame rather than storing the URL.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.RFC 3339 time the upstream URLs stop working: the earliest signing time plus validity the URLs themselves carry, never later than the task’s
updated_at plus 24 hours (BytePlus’s documented URL life) when updated_at is present; otherwise the task’s updated_at plus 24 hours. Present only when upstream_video_url or upstream_last_frame_url is, and omitted when neither source gives a time. Unrelated to the lifetime of the re-hosted video_url / last_frame_url.Format: date-timeBytePlus’s own download URL for the last frame, returned byte for byte beside the re-hosted
last_frame_url on the same terms as upstream_video_url: opted-in workspaces only, Seedance 2.x only, absent once BytePlus clears it, and a bearer credential until upstream_expires_at.BytePlus’s own download URL for the output video, returned byte for byte beside the re-hosted
video_url. Present ONLY for Seedance 2.x tasks polled by a workspace Comfy has opted in server-side (there is no request parameter); absent for everyone else, including a credential that resolves to no workspace (such as a legacy API key not scoped to one), and absent once BytePlus clears its URLs 24 hours after generation. It is a presigned object-storage URL and therefore a bearer credential: anyone holding it can download the video until it expires, so treat it like a secret. It expires at upstream_expires_at, and on Seedance 2.5 BytePlus caps it at 100 downloads, one of which Router’s own re-host consumes.Download URL for the output video. Router re-hosts the video onto Comfy storage and rewrites this field, so it is normally a Comfy-signed URL valid for up to 24 hours - signed for 24 hours when minted and replayed from a 23-hour memo, so a later poll can hand back one with as little as an hour left. When the re-host could not be performed the field keeps BytePlus’s own URL instead, which BytePlus clears 24 hours after the task and caps at 100 downloads on some models. Either way the link expires, so download the video rather than storing the URL.
The duration of the generated video in seconds. Declared as a number rather than an integer because BytePlus is not consistent about it - video tasks have been observed returning whole seconds and sibling BytePlus surfaces report fractional durations - so a client must not assume an integral value. BytePlus’s own field, returned on succeeded video tasks and forwarded unchanged.
The error information. If the task succeeds, null is returned. If the task fails, the error information is returned.
Upstream ModelArk error code. SensitiveContentDetected, InputTextSensitiveContentDetected, InputImageSensitiveContentDetected, InputVideoSensitiveContentDetected, InputAudioSensitiveContentDetected, OutputTextSensitiveContentDetected, OutputImageSensitiveContentDetected, OutputVideoSensitiveContentDetected and OutputAudioSensitiveContentDetected identify content-policy refusals. A family may have a dot-separated reason, such as InputImageSensitiveContentDetected.PrivacyInformation, OutputVideoSensitiveContentDetected.PolicyViolation or OutputImageSensitiveContentDetected.DeepFake. This is an open string, not an enum: other codes describe validation and provider failures. Router recognizes policy families in HTTP 400 error envelopes and HTTP 200 failed-task responses without overriding transport failures.
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.The resolution of the generated video, for example
1080p. BytePlus’s own field, returned on succeeded video tasks and forwarded unchanged.The generation seed actually used for the task. BytePlus’s own field, returned on succeeded video tasks and forwarded unchanged.Format:
int64For the video generation model, the number of input tokens is not calculated and defaults to 0. Therefore, total_tokens = completion_tokens.
Examples
Input
Output
Before you ship
The SDKs create anIdempotency-Key and reuse it for automatic retries. For manual retries, reuse the original key. Router can hold the connection for up to 10 minutes.
When a request fails, Router sends an X-Comfy-Error-Type response header explaining why. A 422 means Router rejected the input before calling the provider, and a 413 means the request body was larger than Router accepts. Download generated assets promptly because result URLs can expire.
Any size limit named in a field description above is the provider’s own bound on that field, quoted from the provider’s specification. Router applies a separate cap to the whole request body, which base64-encoded media counts against: see request body size.
This page documents one partner model called through Comfy Router. The same comfy-sdk / @comfyorg/sdk package also ships a second client, for running a whole ComfyUI workflow graph on Comfy Cloud: Comfy(api_key=...) / new Comfy({ apiKey }), with client.workflows, client.assets and client.jobs. See Comfy SDKs.
Headers
Authentication, idempotency, request IDs, error buckets, retry pacing, spend limits.
Using the Router API
Model discovery, validation errors, retries, and billing.
Limitations
What Router does not do today, and what to use instead.