{"record":{"id":"c735e58f8027d9d7","repo":"Comfy-Org/ComfyUI","slug":"too-many-reference-audios-total-audios-audios","errorCode":null,"errorMessage":"Too many reference audios: {total_audios} (audios={len(reference_audios)}, audio assets={len(reference_audio_assets)}). Maximum is {limits['max_audios']}.","messagePattern":"Too many reference audios: (.+?) \\(audios=(.+?), audio assets=(.+?)\\)\\. Maximum is (.+?)\\.","errorType":"validation","errorClass":"ValueError","httpStatus":null,"severity":"error","filePath":"comfy_api_nodes/nodes_bytedance.py","lineNumber":2766,"sourceCode":"                raise ValueError(\"At least one reference image or video or asset is required.\")\n\n        total_images = len(reference_images) + len(reference_image_assets)\n        if total_images > limits[\"max_images\"]:\n            raise ValueError(\n                f\"Too many reference images: {total_images} \"\n                f\"(images={len(reference_images)}, image assets={len(reference_image_assets)}). \"\n                f\"Maximum is {limits['max_images']}.\"\n            )\n        total_videos = len(reference_videos) + len(reference_video_assets)\n        if total_videos > limits[\"max_videos\"]:\n            raise ValueError(\n                f\"Too many reference videos: {total_videos} \"\n                f\"(videos={len(reference_videos)}, video assets={len(reference_video_assets)}). \"\n                f\"Maximum is {limits['max_videos']}.\"\n            )\n        total_audios = len(reference_audios) + len(reference_audio_assets)\n        if total_audios > limits[\"max_audios\"]:\n            raise ValueError(\n                f\"Too many reference audios: {total_audios} \"\n                f\"(audios={len(reference_audios)}, audio assets={len(reference_audio_assets)}). \"\n                f\"Maximum is {limits['max_audios']}.\"\n            )\n\n        for key in reference_images:\n            reference_images[key] = _prepare_seedance_image(reference_images[key])\n\n        has_video_input = total_videos > 0\n\n        if model.get(\"auto_downscale\") and reference_videos:\n            max_px = SEEDANCE2_REF_VIDEO_PIXEL_LIMITS.get(model_id, {}).get(model[\"resolution\"], {}).get(\"max\")\n            if max_px:\n                for key in reference_videos:\n                    reference_videos[key] = downscale_video_to_max_pixels(reference_videos[key], max_px)\n\n        if model.get(\"auto_upscale\") and reference_videos:\n            min_px = SEEDANCE2_REF_VIDEO_PIXEL_LIMITS.get(model_id, {}).get(model[\"resolution\"], {}).get(\"min\")","sourceCodeStart":2748,"sourceCodeEnd":2784,"githubUrl":"https://github.com/Comfy-Org/ComfyUI/blob/1c6d8d45b3693bfbb32385b410d813a7fd6be216/comfy_api_nodes/nodes_bytedance.py#L2748-L2784","documentation":"Client-side cap on reference audios (Seedance 2.5 feature): direct reference_audios plus resolved audio assets must not exceed limits[\"max_audios\"] (10). Audio references are used for voice/timbre transfer, and the provider rejects more than the cap, so the node enforces it locally with a breakdown of both sources.","triggerScenarios":"Connecting more reference_audio inputs than max_audios, or combining reference_audios with audio asset ids above the cap, on the Seedance 2.5 reference node.","commonSituations":"Trying to blend many voice samples; mixing preset workflows that carry asset ids with newly connected audio clips.","solutions":["Reduce the number of audio references (direct + assets) to the stated maximum.","Pick the one or two cleanest voice samples; more samples rarely improve timbre."],"exampleFix":null,"handlingStrategy":"validation","validationCode":"total = len(reference_audios) + len(reference_audio_assets)\nassert total <= seedance2_reference_limits(model_id)[\"max_audios\"]","typeGuard":null,"tryCatchPattern":null,"preventionTips":["One or two clean voice samples are usually enough for timbre transfer.","Count clips and audio asset ids together against the cap."],"tags":["bytedance","seedance","audio","validation","limits","api-nodes"],"backgroundTag":null,"analyzedSha":"1c6d8d45b3693bfbb32385b410d813a7fd6be216","analyzedAt":"2026-08-14T19:37:18.893Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}