Skip to content

World's first open-source, agentic video production system. 12 production pipelines, 100+ tools, 700+ agent skill and production-knowledge files. Turn your AI coding assistant into a full video production studio.

fix(seedance_video): send fal reference fields for Seedance 2.0 (#759)

r4id3nzx-sys008a3a46dcab
diff --git a/tests/tools/test_new_video_model_support.py b/tests/tools/test_new_video_model_support.py
index 1b9fbf2b..bb148e6e 100644
--- a/tests/tools/test_new_video_model_support.py
+++ b/tests/tools/test_new_video_model_support.py
@@ -71,6 +71,37 @@ def test_fal_seedance_25_uses_current_endpoint_and_reference_fields(
assert payload["duration"] == "30"
+def test_fal_seedance_20_reference_to_video_uses_fal_reference_fields(
+ monkeypatch, tmp_path
+):
+ # fal's 2.0 reference-to-video endpoint reads image_urls / video_urls / audio_urls,
+ # same as 2.5; reference_*_urls is ignored and the request 422s with
+ # "At least one reference image or video is required."
+ from tools.video.seedance_video import SeedanceVideo
+
+ monkeypatch.setenv("FAL_KEY", "test")
+ calls = _queue_mocks(monkeypatch)
+ result = SeedanceVideo().execute(
+ {
+ "prompt": "Macro shot of the ball on this court",
+ "model_version": "2.0",
+ "operation": "reference_to_video",
+ "reference_image_urls": ["https://image"],
+ "reference_video_urls": ["https://motion"],
+ "reference_audio_urls": ["https://voice"],
+ "output_path": str(tmp_path / "seedance20.mp4"),
+ }
+ )
+ assert result.success, result.error
+ url, payload = calls["posts"][0]
+ assert url.endswith("/bytedance/seedance-2.0/reference-to-video")
+ assert payload["image_urls"] == ["https://image"]
+ assert payload["video_urls"] == ["https://motion"]
+ assert payload["audio_urls"] == ["https://voice"]
+ for stale in ("reference_image_urls", "reference_video_urls", "reference_audio_urls"):
+ assert stale not in payload
+
+
def test_fal_gemini_omni_and_minimax_h3_are_discovered_and_submit(
monkeypatch, tmp_path
):
diff --git a/tools/video/seedance_video.py b/tools/video/seedance_video.py
index ac5f4aab..0516327a 100644
--- a/tools/video/seedance_video.py
+++ b/tools/video/seedance_video.py
@@ -313,18 +313,15 @@ class SeedanceVideo(BaseTool):
success=False,
error=f"Seedance {model_version} reference_to_video accepts at most {max_audios} reference audio clips; got {len(ref_audio_urls)}",
)
+ # fal's 2.0 and 2.5 reference-to-video endpoints both read image_urls /
+ # video_urls / audio_urls; reference_*_urls is silently dropped and the
+ # request fails with "At least one reference image or video is required."
if ref_image_urls:
- payload[
- "image_urls" if model_version == "2.5" else "reference_image_urls"
- ] = ref_image_urls
+ payload["image_urls"] = ref_image_urls
if ref_video_urls:
- payload[
- "video_urls" if model_version == "2.5" else "reference_video_urls"
- ] = ref_video_urls
+ payload["video_urls"] = ref_video_urls
if ref_audio_urls:
- payload[
- "audio_urls" if model_version == "2.5" else "reference_audio_urls"
- ] = ref_audio_urls
+ payload["audio_urls"] = ref_audio_urls
headers = {
"Authorization": f"Key {api_key}",