Clone any viral video with AI agents. Not just a script, the whole workflow: swap the face, the words, the B-roll, ship 100 variants in one command, and get your 100M views.
TypeScript agentic-aiaiai-agentsai-videocompilerdslffmpeggenerative-aillmmarkup-languagemonorepoplugin-systemprogramming-languagetext-to-videotypescriptvideovideo-automationvideo-clonevideo-editingvideo-generation
feat(seedance): add KIE Seedance 2.5 support
kashorin6893c956174f
diff --git a/docs/quickstart/generation.md b/docs/quickstart/generation.mdindex b63e68ae..ffd6db70 100644--- a/docs/quickstart/generation.md+++ b/docs/quickstart/generation.md@@ -122,9 +122,21 @@ and explicit graph inputs.## Seedance invocation shapes-Seedance exposes model capabilities, not creative usages. `standard`, `fast` and `mini` choose the-model variant independently of three invocation shapes. All shapes consume a complete ordinary-`Text` prompt and output `{id.video}`.+Seedance exposes model capabilities, not creative usages. `standard`, `fast`, `mini` and `2.5`+choose the exact model independently of three invocation shapes. All shapes consume a complete+ordinary `Text` prompt and output `{id.video}`.++Seedance 2.5 uses the same Surfaces; it is not a Runtime substitution for another model. Its exact+contract accepts 480p/720p, up to 30 image, 10 video and 10 audio references, and either `-1` for+model-selected duration or an integer from 4 through 30 seconds:++```svml+<seedance:ReferenceVideo id="long-take" model="2.5"+ prompt={long-direction} duration="30" resolution="720p">+ <seedance:Reference image={presenter-reference}/>+ <seedance:Reference audio={presenter-voice}/>+</seedance:ReferenceVideo>+```### seedance:TextVideodiff --git a/docs/zh/quickstart/generation.md b/docs/zh/quickstart/generation.mdindex 5df76e51..1dc8adb3 100644--- a/docs/zh/quickstart/generation.md+++ b/docs/zh/quickstart/generation.md@@ -114,8 +114,20 @@ speech.normal {## Seedance 三种调用形状Seedance 只暴露模型能力,不暴露“口播”“B-roll”等创作用途。`standard`、`fast`、`mini`-选择模型版本;调用形状则独立分为三种。三者都消费完整的普通 `Text` Prompt,并输出-`{id.video}`。+和 `2.5` 选择精确模型;调用形状则独立分为三种。三者都消费完整的普通 `Text` Prompt,+并输出 `{id.video}`。++Seedance 2.5 复用同样的 Surface,而不是由 Runtime 把别的模型偷偷替换成 2.5。它的精确+合同支持 480p/720p,最多 30 张参考图、10 段参考视频、10 段参考音频;时长可写 `-1`+交给模型选择,也可明确写 4–30 秒的整数:++```svml+<seedance:ReferenceVideo id="long-take" model="2.5"+ prompt={long-direction} duration="30" resolution="720p">+ <seedance:Reference image={presenter-reference}/>+ <seedance:Reference audio={presenter-voice}/>+</seedance:ReferenceVideo>+```### seedance:TextVideodiff --git a/examples/talking-film-graph-check/svml.packages.lock b/examples/talking-film-graph-check/svml.packages.lockindex 55005928..7e417c9d 100644--- a/examples/talking-film-graph-check/svml.packages.lock+++ b/examples/talking-film-graph-check/svml.packages.lock@@ -707,7 +707,7 @@{"name": "@narratage/seedance","version": "0.0.0-dev",- "digest": "sha256:72e172d81787cb632a903ab5f3f56ff7bb12daf57f3e2f927c70045db8140b88"+ "digest": "sha256:8cd24d91f174c431e3e5537423460345d33aef6bfb70b26746a7fe128c50e3aa"},{"name": "@narratage/semantic-map",@@ -945,8 +945,8 @@"name": "@narratage/seedance","version": "0.0.0-dev"},- "facetsDigest": "sha256:0832f344b8c327e316a153d8ca4559da5eba452f3e334ffb49c7e94a29f36ecf",- "closureDigest": "sha256:3ef4370d01ffcfef671cae12e1a250b1216caaa373b335246d2bfb5d11b148cf"+ "facetsDigest": "sha256:8b2ab1c897cd410e0933e8d6298be86fb9e44a302499d0070af7bf3df3ddcdeb",+ "closureDigest": "sha256:7beae6ed6f2ef099c52dee47cff81049f8f802414f00e252f528937d33854fd0"},{"specifier": "@narratage/semantic-map",@@ -1066,5 +1066,5 @@"closureDigest": "sha256:d0abf29a19cbc43aa0e0cfe239670d4e339da684f89ed5ad413b1aabea18e165"}],- "digest": "sha256:4c4ab7a6d2674b5a3a6f0078c51539c0b995852e6bff422cf57f795f8382baa0"+ "digest": "sha256:0b46a81a27f4a980120ba1979abf9a7df33f5b600e0eef0a1e82522b49d966af"}diff --git a/examples/talking-film-live/svml.packages.lock b/examples/talking-film-live/svml.packages.lockindex 4a08bb9b..ff6e6cfb 100644--- a/examples/talking-film-live/svml.packages.lock+++ b/examples/talking-film-live/svml.packages.lock@@ -713,7 +713,7 @@{"name": "@narratage/seedance","version": "0.0.0-dev",- "digest": "sha256:72e172d81787cb632a903ab5f3f56ff7bb12daf57f3e2f927c70045db8140b88"+ "digest": "sha256:8cd24d91f174c431e3e5537423460345d33aef6bfb70b26746a7fe128c50e3aa"},{"name": "@narratage/semantic-map",@@ -965,8 +965,8 @@"name": "@narratage/seedance","version": "0.0.0-dev"},- "facetsDigest": "sha256:0832f344b8c327e316a153d8ca4559da5eba452f3e334ffb49c7e94a29f36ecf",- "closureDigest": "sha256:3ef4370d01ffcfef671cae12e1a250b1216caaa373b335246d2bfb5d11b148cf"+ "facetsDigest": "sha256:8b2ab1c897cd410e0933e8d6298be86fb9e44a302499d0070af7bf3df3ddcdeb",+ "closureDigest": "sha256:7beae6ed6f2ef099c52dee47cff81049f8f802414f00e252f528937d33854fd0"},{"specifier": "@narratage/semantic-map",@@ -1086,5 +1086,5 @@"closureDigest": "sha256:d0abf29a19cbc43aa0e0cfe239670d4e339da684f89ed5ad413b1aabea18e165"}],- "digest": "sha256:ff48f6c0eaef7beb70cd23ed010836d513a4e0d678c7450d164fd792b75e5288"+ "digest": "sha256:be1c07e805c5615cfd1784e2a56998c98a54d142f85582cea3453d126921a293"}diff --git a/examples/talking-film-live/svml.runtime-packages.lock b/examples/talking-film-live/svml.runtime-packages.lockindex a1ff9af9..04c60043 100644--- a/examples/talking-film-live/svml.runtime-packages.lock+++ b/examples/talking-film-live/svml.runtime-packages.lock@@ -120,7 +120,7 @@{"name": "@narratage/local","version": "0.0.0-dev",- "digest": "sha256:27ec6ee9f102bda5515d6c25fa3a1e380e3418e5631ac1c6742b019c0f266afc"+ "digest": "sha256:163114d079dba3d23c579a49f1eb60ae2e5f62c2fee18c555c88a5c987d498f2"},{"name": "@narratage/markup",@@ -175,7 +175,7 @@{"name": "@narratage/provider-kie","version": "0.0.0-dev",- "digest": "sha256:a226af6435ff05baa90b7103696674a43842603520c2d80a96fe6e2e1e276f8d"+ "digest": "sha256:7b93718eabf4898121c56fe4b2ab8aba0c513d16a4ee0d900b34a920aa6ee3a6"},{"name": "@narratage/provider-media-local",@@ -210,7 +210,7 @@{"name": "@narratage/runtime","version": "0.0.0-dev",- "digest": "sha256:f12df62ed8f04d97afdfcca2af9f965962f5ba33f2cd018d0d853332547ff695"+ "digest": "sha256:d25d9952a4760af7e350ced56db0d10f07038f5fc293b56c8d8f133b8523f8f1"},{"name": "@narratage/semantic-map",@@ -245,7 +245,7 @@{"name": "@narratage/store-sqlite","version": "0.0.0-dev",- "digest": "sha256:9379c1bdfa3c5acea58a6e3ad14535454cbc1c86582b7be121de0dd5f89ceaba"+ "digest": "sha256:0cbc5e1918c793b0644ceda67399724804eed6c1d4ec0873ad49a93c056352d3"},{"name": "@narratage/svs",@@ -926,7 +926,7 @@"version": "0.0.0-dev"},"facetsDigest": "sha256:914018276b9218afc13940ca5c362dc95fa19d574fc07b06b6fe005c5eb30315",- "closureDigest": "sha256:80fc129e5f3bf68e6fdb77b9b5e356eb9dfed154ad2da98e1dde9c45e7bfba82"+ "closureDigest": "sha256:bf915bf8ae820f38f0f2642fe1c0d9f32c1f07f7aeba7945bbf3b471b6ce6f68"},{"specifier": "@narratage/credential-store-env",@@ -935,7 +935,7 @@"version": "0.0.0-dev"},"facetsDigest": "sha256:ee33ba638bbf2f88eee8f34a2f3179f435a0af9ccbae3fbb7d2a81bd6aeac612",- "closureDigest": "sha256:c4241c245a5fb626e588613132a74c4da10e77d0ca4bc0eb83efae3f40ef1b97"+ "closureDigest": "sha256:20daee8d8cda7bc6495f523ade48dbabe0b955ae5ed79f3eb5aff0412fb0bd71"},{"specifier": "@narratage/local",@@ -944,7 +944,7 @@"version": "0.0.0-dev"},"facetsDigest": "sha256:6689aed79b0947c7315aef65e46806ce73da01de3d73b454e1497b8d847ffa61",- "closureDigest": "sha256:c7dbb390644c0c782826ad25455aace6b63e35458cef6354312fd02aa8211b0c"+ "closureDigest": "sha256:eff19870c0d941cb7e9e6a296a622b60d40e73e930aa84ff6f5230a4b70118ae"},{"specifier": "@narratage/provider-google-vertex",@@ -953,7 +953,7 @@"version": "0.0.0-dev"},"facetsDigest": "sha256:b2636492ab0b0b500d674899ab2ff14fc61c7f2b22ef44eb8f816f141b21ec4d",- "closureDigest": "sha256:e7259c57d39c74563de3402fffaa1699489b6e9abbe1f8c6977e03e09c88e3cb"+ "closureDigest": "sha256:0416bb7e44f799300fc2eae9f7fe31ebabeb695c4782bb17610645514d37488a"},{"specifier": "@narratage/provider-hyperframes-local",@@ -962,7 +962,7 @@"version": "0.0.0-dev"},"facetsDigest": "sha256:b14b721bdc0c9d5d9ced1c345107c92a3a5878f3383dea2ecd3e310442c2a40c",- "closureDigest": "sha256:ae693238af06b4feb06c0d8e2d6c10a443d4d866bf39ce13334c6cc05125f5b1"+ "closureDigest": "sha256:8b03af29b45cbcd9aa83905c273da8f7ba631f4b89498477175ee131c09e05eb"},{"specifier": "@narratage/provider-kie",@@ -971,7 +971,7 @@"version": "0.0.0-dev"},"facetsDigest": "sha256:e61ebb911a33d4c5d0e4e4ee4fb69cdb790f4ced050ef35f7472bfbd72013d9b",- "closureDigest": "sha256:7636ff66aadd0eb88300974fd37d7990ec38c0f3ac415f52edcf9126b11d3efe"+ "closureDigest": "sha256:239b563cea714bdce1e1e0fbd0d552f2eb6717a348d02b13fcda53d6f6b194f1"},{"specifier": "@narratage/provider-media-local",@@ -980,7 +980,7 @@"version": "0.0.0-dev"},"facetsDigest": "sha256:701abcc923bf8a711c20b6e308d8cc8be27bf560f249b8c5a801e1dbd9cb3979",- "closureDigest": "sha256:e4996fbbc622d79d69c2e1a217726b203828fc1db6bbb6aafaee4a30d485cb78"+ "closureDigest": "sha256:834f59ae4d0eb662507db2c63e5fdf8fe064f4ca3653e8568a68f26591667202"},{"specifier": "@narratage/provider-whisperx-local",@@ -989,7 +989,7 @@"version": "0.0.0-dev"},"facetsDigest": "sha256:3686b84c42cc2b1bcaccf57cbdcda25a15c7d9d3778fb92d25437f9880ed8f5d",- "closureDigest": "sha256:604a1510ad0452f38a7a0a0a1beafefbd4cc9cd8325686b114320794a9fbda8c"+ "closureDigest": "sha256:ed1d71d15f31512bb6ee43227284d7e62b016b76c647fbbfbe9596452dfce98d"},{"specifier": "@narratage/store-sqlite",@@ -998,8 +998,8 @@"version": "0.0.0-dev"},"facetsDigest": "sha256:5bccf73cd953710fc31ef44672fef1bfc396fd4aa2eff4b53108e8ff87e749c3",- "closureDigest": "sha256:2c2587eb467888135741d77de271099d190d88d7544c0ce4adbb49412bcf7edd"+ "closureDigest": "sha256:bf4698c24009fbf535790ae49ee852eb6e6a006fad4e771ba9002883c16ad54e"}],- "digest": "sha256:2169c16075f921f6dd0236678d78c93051a406dd55a6249407afc43348ade212"+ "digest": "sha256:b2b076a1b21b625b43ce0779003d15323327fcc31a0513bfd8a7f9e0fda317a2"}diff --git a/examples/talking-head-aroll/svml.packages.lock b/examples/talking-head-aroll/svml.packages.lockindex 90151134..242437de 100644--- a/examples/talking-head-aroll/svml.packages.lock+++ b/examples/talking-head-aroll/svml.packages.lock@@ -710,7 +710,7 @@{"name": "@narratage/seedance","version": "0.0.0-dev",- "digest": "sha256:72e172d81787cb632a903ab5f3f56ff7bb12daf57f3e2f927c70045db8140b88"+ "digest": "sha256:8cd24d91f174c431e3e5537423460345d33aef6bfb70b26746a7fe128c50e3aa"},{"name": "@narratage/semantic-map",@@ -948,8 +948,8 @@"name": "@narratage/seedance","version": "0.0.0-dev"},- "facetsDigest": "sha256:0832f344b8c327e316a153d8ca4559da5eba452f3e334ffb49c7e94a29f36ecf",- "closureDigest": "sha256:3ef4370d01ffcfef671cae12e1a250b1216caaa373b335246d2bfb5d11b148cf"+ "facetsDigest": "sha256:8b2ab1c897cd410e0933e8d6298be86fb9e44a302499d0070af7bf3df3ddcdeb",+ "closureDigest": "sha256:7beae6ed6f2ef099c52dee47cff81049f8f802414f00e252f528937d33854fd0"},{"specifier": "@narratage/semantic-map",@@ -1051,5 +1051,5 @@"closureDigest": "sha256:d0abf29a19cbc43aa0e0cfe239670d4e339da684f89ed5ad413b1aabea18e165"}],- "digest": "sha256:c88ce3ec0a540451c5be1d4d1357d2a7ca82b036c6922c6455a55a908a8009c6"+ "digest": "sha256:601032725eab34e2ce4d87c2b19ffa7d1a176334552cb0be0131194fe8b28fa9"}diff --git a/examples/talking-head-aroll/svml.runtime-packages.lock b/examples/talking-head-aroll/svml.runtime-packages.lockindex a1ff9af9..04c60043 100644--- a/examples/talking-head-aroll/svml.runtime-packages.lock+++ b/examples/talking-head-aroll/svml.runtime-packages.lock@@ -120,7 +120,7 @@{"name": "@narratage/local","version": "0.0.0-dev",- "digest": "sha256:27ec6ee9f102bda5515d6c25fa3a1e380e3418e5631ac1c6742b019c0f266afc"+ "digest": "sha256:163114d079dba3d23c579a49f1eb60ae2e5f62c2fee18c555c88a5c987d498f2"},{"name": "@narratage/markup",@@ -175,7 +175,7 @@{"name": "@narratage/provider-kie","version": "0.0.0-dev",- "digest": "sha256:a226af6435ff05baa90b7103696674a43842603520c2d80a96fe6e2e1e276f8d"+ "digest": "sha256:7b93718eabf4898121c56fe4b2ab8aba0c513d16a4ee0d900b34a920aa6ee3a6"},{"name": "@narratage/provider-media-local",@@ -210,7 +210,7 @@{"name": "@narratage/runtime","version": "0.0.0-dev",- "digest": "sha256:f12df62ed8f04d97afdfcca2af9f965962f5ba33f2cd018d0d853332547ff695"+ "digest": "sha256:d25d9952a4760af7e350ced56db0d10f07038f5fc293b56c8d8f133b8523f8f1"},{"name": "@narratage/semantic-map",@@ -245,7 +245,7 @@{"name": "@narratage/store-sqlite","version": "0.0.0-dev",- "digest": "sha256:9379c1bdfa3c5acea58a6e3ad14535454cbc1c86582b7be121de0dd5f89ceaba"+ "digest": "sha256:0cbc5e1918c793b0644ceda67399724804eed6c1d4ec0873ad49a93c056352d3"},{"name": "@narratage/svs",@@ -926,7 +926,7 @@"version": "0.0.0-dev"},"facetsDigest": "sha256:914018276b9218afc13940ca5c362dc95fa19d574fc07b06b6fe005c5eb30315",- "closureDigest": "sha256:80fc129e5f3bf68e6fdb77b9b5e356eb9dfed154ad2da98e1dde9c45e7bfba82"+ "closureDigest": "sha256:bf915bf8ae820f38f0f2642fe1c0d9f32c1f07f7aeba7945bbf3b471b6ce6f68"},{"specifier": "@narratage/credential-store-env",@@ -935,7 +935,7 @@"version": "0.0.0-dev"},"facetsDigest": "sha256:ee33ba638bbf2f88eee8f34a2f3179f435a0af9ccbae3fbb7d2a81bd6aeac612",- "closureDigest": "sha256:c4241c245a5fb626e588613132a74c4da10e77d0ca4bc0eb83efae3f40ef1b97"+ "closureDigest": "sha256:20daee8d8cda7bc6495f523ade48dbabe0b955ae5ed79f3eb5aff0412fb0bd71"},{"specifier": "@narratage/local",@@ -944,7 +944,7 @@"version": "0.0.0-dev"},"facetsDigest": "sha256:6689aed79b0947c7315aef65e46806ce73da01de3d73b454e1497b8d847ffa61",- "closureDigest": "sha256:c7dbb390644c0c782826ad25455aace6b63e35458cef6354312fd02aa8211b0c"+ "closureDigest": "sha256:eff19870c0d941cb7e9e6a296a622b60d40e73e930aa84ff6f5230a4b70118ae"},{"specifier": "@narratage/provider-google-vertex",@@ -953,7 +953,7 @@"version": "0.0.0-dev"},"facetsDigest": "sha256:b2636492ab0b0b500d674899ab2ff14fc61c7f2b22ef44eb8f816f141b21ec4d",- "closureDigest": "sha256:e7259c57d39c74563de3402fffaa1699489b6e9abbe1f8c6977e03e09c88e3cb"+ "closureDigest": "sha256:0416bb7e44f799300fc2eae9f7fe31ebabeb695c4782bb17610645514d37488a"},{"specifier": "@narratage/provider-hyperframes-local",@@ -962,7 +962,7 @@"version": "0.0.0-dev"},"facetsDigest": "sha256:b14b721bdc0c9d5d9ced1c345107c92a3a5878f3383dea2ecd3e310442c2a40c",- "closureDigest": "sha256:ae693238af06b4feb06c0d8e2d6c10a443d4d866bf39ce13334c6cc05125f5b1"+ "closureDigest": "sha256:8b03af29b45cbcd9aa83905c273da8f7ba631f4b89498477175ee131c09e05eb"},{"specifier": "@narratage/provider-kie",@@ -971,7 +971,7 @@"version": "0.0.0-dev"},"facetsDigest": "sha256:e61ebb911a33d4c5d0e4e4ee4fb69cdb790f4ced050ef35f7472bfbd72013d9b",- "closureDigest": "sha256:7636ff66aadd0eb88300974fd37d7990ec38c0f3ac415f52edcf9126b11d3efe"+ "closureDigest": "sha256:239b563cea714bdce1e1e0fbd0d552f2eb6717a348d02b13fcda53d6f6b194f1"},{"specifier": "@narratage/provider-media-local",@@ -980,7 +980,7 @@"version": "0.0.0-dev"},"facetsDigest": "sha256:701abcc923bf8a711c20b6e308d8cc8be27bf560f249b8c5a801e1dbd9cb3979",- "closureDigest": "sha256:e4996fbbc622d79d69c2e1a217726b203828fc1db6bbb6aafaee4a30d485cb78"+ "closureDigest": "sha256:834f59ae4d0eb662507db2c63e5fdf8fe064f4ca3653e8568a68f26591667202"},{"specifier": "@narratage/provider-whisperx-local",@@ -989,7 +989,7 @@"version": "0.0.0-dev"},"facetsDigest": "sha256:3686b84c42cc2b1bcaccf57cbdcda25a15c7d9d3778fb92d25437f9880ed8f5d",- "closureDigest": "sha256:604a1510ad0452f38a7a0a0a1beafefbd4cc9cd8325686b114320794a9fbda8c"+ "closureDigest": "sha256:ed1d71d15f31512bb6ee43227284d7e62b016b76c647fbbfbe9596452dfce98d"},{"specifier": "@narratage/store-sqlite",@@ -998,8 +998,8 @@"version": "0.0.0-dev"},"facetsDigest": "sha256:5bccf73cd953710fc31ef44672fef1bfc396fd4aa2eff4b53108e8ff87e749c3",- "closureDigest": "sha256:2c2587eb467888135741d77de271099d190d88d7544c0ce4adbb49412bcf7edd"+ "closureDigest": "sha256:bf4698c24009fbf535790ae49ee852eb6e6a006fad4e771ba9002883c16ad54e"}],- "digest": "sha256:2169c16075f921f6dd0236678d78c93051a406dd55a6249407afc43348ade212"+ "digest": "sha256:b2b076a1b21b625b43ce0779003d15323327fcc31a0513bfd8a7f9e0fda317a2"}diff --git a/packages/provider-kie/README.md b/packages/provider-kie/README.mdindex 923df981..b09c34b4 100644--- a/packages/provider-kie/README.md+++ b/packages/provider-kie/README.md@@ -1,6 +1,6 @@# `@narratage/provider-kie`-Recoverable KIE Market Provider for the eleven explicitly selected exact models and one generic+Recoverable KIE Market Provider for the twelve explicitly selected exact models and one genericbackground-removal capability.This package is deployment code. Author source imports model modules such as `@narratage/seedance` or@@ -11,7 +11,7 @@ choose another model.It imports no exact-model package. Every supported Capability contributes one `KieRoute`: exactCapability, return Type, request compiler, media/count limits and result packer. All Routes share oneupload, admission, paid submission, checkpoint, polling and download state machine. Model mappings-generate eleven Routes; Background Removal contributes the twelfth. See+generate twelve Routes; Background Removal contributes the thirteenth. See[`model-input-ports.md`](../../docs/model-input-ports.md).## Supported catalog@@ -21,7 +21,7 @@ routes rather than extra Capabilities.| Author module | Exact models | KIE model slugs ||---|---|---|-| `@narratage/seedance` | `seedance-2`, `-fast`, `-mini` | `bytedance/seedance-2*` |+| `@narratage/seedance` | `seedance-2`, `-fast`, `-mini`, `seedance-2.5` | `bytedance/seedance-2*`, `bytedance/seedance-2-5` || `@narratage/minimax-h3` | `minimax-h3` | `minimax-h3/{text,image,reference}-to-video` || `@narratage/gemini-omni` | `gemini-omni-video` | `gemini-omni-video` || `@narratage/grok-imagine` | `grok-imagine-video`, `-1.5-preview` | Grok Imagine video endpoints |diff --git a/packages/provider-kie/src/mapping.ts b/packages/provider-kie/src/mapping.tsindex caed7811..73ad30a1 100644--- a/packages/provider-kie/src/mapping.ts+++ b/packages/provider-kie/src/mapping.ts@@ -178,6 +178,11 @@ export const kieModelCatalog: readonly GenerationWireMapping[] = [seedanceMapping("seedance-2", "bytedance/seedance-2"),seedanceMapping("seedance-2-fast", "bytedance/seedance-2-fast"),seedanceMapping("seedance-2-mini", "bytedance/seedance-2-mini"),+ {+ ...seedanceMapping("seedance-2.5", "bytedance/seedance-2-5"),+ // These are KIE output-envelope choices, not Seedance model inputs.+ constants: { return_last_frame: false, output_format: "mp4" },+ },minimaxMapping,geminiMapping,grokVideoMapping,diff --git a/packages/provider-kie/test/models.test.ts b/packages/provider-kie/test/models.test.tsindex 27e671af..2e75bab3 100644--- a/packages/provider-kie/test/models.test.ts+++ b/packages/provider-kie/test/models.test.ts@@ -65,7 +65,7 @@ function capabilityKey(ref: CapabilityRef): string {const upload = async (artifact: { readonly digest: string }) => `https://upload.test/${artifact.digest}`;test("the selected KIE release is seven exact model families and no Grok image capability", () => {- assert.equal(kieModelCatalog.length, 11);+ assert.equal(kieModelCatalog.length, 12);assert.equal(kieModelCatalog.some((item) => item.capability.name.startsWith("grok-") && item.result === "image"),false,@@ -195,12 +195,12 @@ test("Seedream safety policy is explicit author content and contributes to requeassert.notEqual(digestOf(unchecked), digestOf(checked));});-test("all eleven exact capabilities route to their documented KIE model slug", async () => {+test("all twelve exact capabilities route to their documented KIE model slug", async () => {const store = new MemoryArtifactStore();const image = await store.put(new Uint8Array([1]), "image/png");const video = await store.put(new Uint8Array([2]), "video/mp4");const audio = await store.put(new Uint8Array([3]), "audio/wav");- const seedance = (model: "seedance-2" | "seedance-2-fast" | "seedance-2-mini") => sealSeedanceRequest(model, {+ const seedance = (model: "seedance-2" | "seedance-2-fast" | "seedance-2-mini" | "seedance-2.5") => sealSeedanceRequest(model, {prompt: ["A studio shot."],resolution: [model === "seedance-2" ? "1080p" : "720p"],aspectRatio: ["16:9"],@@ -225,6 +225,7 @@ test("all eleven exact capabilities route to their documented KIE model slug", a["seedance-2", seedance("seedance-2"), "bytedance/seedance-2"],["seedance-2-fast", seedance("seedance-2-fast"), "bytedance/seedance-2-fast"],["seedance-2-mini", seedance("seedance-2-mini"), "bytedance/seedance-2-mini"],+ ["seedance-2.5", seedance("seedance-2.5"), "bytedance/seedance-2-5"],["minimax-h3", sealMinimaxH3Request({prompt: ["A studio shot."],duration: [6],@@ -295,6 +296,31 @@ test("all eleven exact capabilities route to their documented KIE model slug", a}});+test("Seedance 2.5 maps its exact request without leaking KIE envelope controls into the model", async () => {+ const request = sealSeedanceRequest("seedance-2.5", {+ prompt: ["A car crosses the desert."],+ resolution: ["720p"],+ aspectRatio: ["21:9"],+ duration: [30],+ generateAudio: [true],+ webSearch: [false],+ });+ const mapping = kieModelCatalog.find((item) => item.capability.name === "seedance-2.5");+ assert.ok(mapping);+ const task = await compileWireRequest(mapping, request, upload);+ assert.equal(task.model, "bytedance/seedance-2-5");+ assert.deepEqual(task.input, {+ prompt: "A car crosses the desert.",+ resolution: "720p",+ aspect_ratio: "21:9",+ duration: 30,+ generate_audio: true,+ web_search: false,+ return_last_frame: false,+ output_format: "mp4",+ });+});+test("one model reaching a service that splits it keeps the reference roles intact", async () => {const store = new MemoryArtifactStore();const image = await store.put(new Uint8Array([1]), "image/png");diff --git a/packages/provider-kie/test/provider.test.ts b/packages/provider-kie/test/provider.test.tsindex 05a46750..2ca319fa 100644--- a/packages/provider-kie/test/provider.test.ts+++ b/packages/provider-kie/test/provider.test.ts@@ -82,7 +82,7 @@ test("all KIE capabilities share one recoverable task engine and differ only byfetch: async () => { throw new Error("no request expected"); },fetchImplementationDigest: digestOf("provider-kie:route-registry-test"),});- assert.equal(provider.bindings.length, 12);+ assert.equal(provider.bindings.length, 13);const registry = new EndpointRegistry();await provider.install(registry);const seed = need(sealSeedanceRequest("seedance-2-mini", {diff --git a/packages/seedance/src/index.ts b/packages/seedance/src/index.tsindex 0ca303c6..15ef194f 100644--- a/packages/seedance/src/index.ts+++ b/packages/seedance/src/index.ts@@ -19,31 +19,33 @@ import { canonicalize, digestOf } from "@narratage/protocol";import type { Digest, ProducerRef, TypeRef, ValueSchema } from "@narratage/protocol";export const seedanceModuleRef = { name: "@narratage/seedance", version: "1" } as const;-export const seedanceModels = ["seedance-2", "seedance-2-fast", "seedance-2-mini"] as const;+export const seedanceModels = ["seedance-2", "seedance-2-fast", "seedance-2-mini", "seedance-2.5"] as const;export type SeedanceModel = typeof seedanceModels[number];const ASPECT_RATIOS = ["1:1", "4:3", "3:4", "16:9", "9:16", "21:9", "adaptive"] as const;+const SEEDANCE_25_DURATIONS = [-1, ...Array.from({ length: 27 }, (_item, index) => index + 4)] as const;+/**- * What Seedance 2 accepts is fixed when the model is trained; no service- * reselling it can widen or narrow this. Every limit below is stated identically- * by ByteDance's own launch material, KIE and fal — only the wire field names- * differ between services, and those live in each Provider's wire mapping.+ * Exact Seedance model inputs. Provider wire names are deliberately absent:+ * KIE, Volcengine or another service maps these ports independently.*- * Reference modalities are separate ports because the model gives each its own- * capacity: 9 images, 3 videos, 3 audio clips, and no more than 12 files in- * total. Only the resolution ceiling differs between the variants.+ * Seedance 2.5 is not treated as an alias for a Seedance 2 variant. Its public+ * KIE contract widens prompt/reference capacities and duration independently,+ * so it receives its own exact Capability while reusing the same three author+ * Surfaces.*/function seedancePortTable(model: SeedanceModel): GenerationPortTable {+ const is25 = model === "seedance-2.5";return sealGenerationPortTable({contract: "svml.generation-ports@1",model,result: "video",ports: [- { name: "prompt", value: { kind: "text", maxChars: 20_000 }, minItems: 1, maxItems: 1 },- { name: "referenceImage", value: { kind: "media", accepts: ["image"] }, minItems: 0, maxItems: 9 },- { name: "referenceVideo", value: { kind: "media", accepts: ["video"] }, minItems: 0, maxItems: 3 },- { name: "referenceAudio", value: { kind: "media", accepts: ["audio"] }, minItems: 0, maxItems: 3 },+ { name: "prompt", value: { kind: "text", maxChars: is25 ? 30_000 : 20_000 }, minItems: 1, maxItems: 1 },+ { name: "referenceImage", value: { kind: "media", accepts: ["image"] }, minItems: 0, maxItems: is25 ? 30 : 9 },+ { name: "referenceVideo", value: { kind: "media", accepts: ["video"] }, minItems: 0, maxItems: is25 ? 10 : 3 },+ { name: "referenceAudio", value: { kind: "media", accepts: ["audio"] }, minItems: 0, maxItems: is25 ? 10 : 3 },{ name: "firstFrame", value: { kind: "media", accepts: ["image"] }, minItems: 0, maxItems: 1 },{ name: "lastFrame", value: { kind: "media", accepts: ["image"] }, minItems: 0, maxItems: 1 },{@@ -56,7 +58,14 @@ function seedancePortTable(model: SeedanceModel): GenerationPortTable {maxItems: 1,},{ name: "aspectRatio", value: { kind: "enum", values: [...ASPECT_RATIOS] }, minItems: 1, maxItems: 1 },- { name: "duration", value: { kind: "number", integer: true, minimum: 4, maximum: 15 }, minItems: 1, maxItems: 1 },+ {+ name: "duration",+ value: is25+ ? { kind: "enum", values: [...SEEDANCE_25_DURATIONS] }+ : { kind: "number", integer: true, minimum: 4, maximum: 15 },+ minItems: 1,+ maxItems: 1,+ },{ name: "generateAudio", value: { kind: "boolean" }, minItems: 1, maxItems: 1 },{ name: "webSearch", value: { kind: "boolean" }, minItems: 1, maxItems: 1 },],@@ -67,9 +76,11 @@ function seedancePortTable(model: SeedanceModel): GenerationPortTable {{ kind: "atMostOneOf", ports: ["referenceVideo", "firstFrame"] },{ kind: "atMostOneOf", ports: ["referenceAudio", "firstFrame"] },{ kind: "requiresPresent", port: "lastFrame", needs: ["firstFrame"] },- // Reference audio cannot travel alone; it needs at least one visual reference.- { kind: "requiresAnyOf", port: "referenceAudio", anyOf: ["referenceImage", "referenceVideo"] },- { kind: "weightedTotal", weights: { referenceImage: 1, referenceVideo: 1, referenceAudio: 1 }, maximum: 12 },+ ...(is25 ? [] : [+ // Seedance 2 reference audio cannot travel alone; it needs a visual reference.+ { kind: "requiresAnyOf" as const, port: "referenceAudio", anyOf: ["referenceImage", "referenceVideo"] },+ { kind: "weightedTotal" as const, weights: { referenceImage: 1, referenceVideo: 1, referenceAudio: 1 }, maximum: 12 },+ ]),],});}@@ -78,6 +89,7 @@ export const seedancePorts: Readonly<Record<SeedanceModel, GenerationPortTable>>"seedance-2": seedancePortTable("seedance-2"),"seedance-2-fast": seedancePortTable("seedance-2-fast"),"seedance-2-mini": seedancePortTable("seedance-2-mini"),+ "seedance-2.5": seedancePortTable("seedance-2.5"),};export type SeedancePortMap = Readonly<Record<string, readonly GenerationPortValue[]>>;@@ -173,9 +185,12 @@ const seedanceBaseDefinition = defineExactModelModule({["standard", "seedance-2"],["fast", "seedance-2-fast"],["mini", "seedance-2-mini"],+ ["v25", "seedance-2.5"],] as const).map(([key, model]) => ({key,- requestTypeName: `${model.split("-").map((part) => part[0]!.toUpperCase() + part.slice(1)).join("")}Request`,+ requestTypeName: model === "seedance-2.5"+ ? "Seedance25Request"+ : `${model.split("-").map((part) => part[0]!.toUpperCase() + part.slice(1)).join("")}Request`,producerName: `request-${model}`,ports: seedancePorts[model],})),@@ -186,6 +201,7 @@ export const seedanceEndpointsByModel = {"seedance-2": seedanceEndpoints.standard!,"seedance-2-fast": seedanceEndpoints.fast!,"seedance-2-mini": seedanceEndpoints.mini!,+ "seedance-2.5": seedanceEndpoints.v25!,} as const;export const seedanceManifest = {diff --git a/packages/seedance/src/surface.ts b/packages/seedance/src/surface.tsindex 63b4f9c0..f335f763 100644--- a/packages/seedance/src/surface.ts+++ b/packages/seedance/src/surface.ts@@ -132,7 +132,10 @@ function modelSelection(element: StructuredElement) {if (requested === "mini" || requested === "seedance-2-mini") {return { endpoint: seedanceEndpoints.mini!, model: "seedance-2-mini" as const };}- throw new Error(`${element.name}.model must be standard, fast or mini`);+ if (requested === "2.5" || requested === "seedance-2.5") {+ return { endpoint: seedanceEndpoints.v25!, model: "seedance-2.5" as const };+ }+ throw new Error(`${element.name}.model must be standard, fast, mini or 2.5`);}function integerAttribute(element: StructuredElement, name: string): number {@@ -162,11 +165,18 @@ function generationSettings(): SeedancePortMap {const table = seedancePorts[model];const duration = generationPort(table, "duration");- if (duration.value.kind !== "number") throw new Error("Seedance duration port is not numeric");const durationSec = suppliedDurationSec ?? integerAttribute(element, "duration");- const { minimum = 0, maximum = Number.MAX_SAFE_INTEGER } = duration.value;- if (durationSec < minimum || durationSec > maximum) {- throw new Error(`${element.name}.duration must be between ${minimum} and ${maximum} seconds`);+ if (duration.value.kind === "number") {+ const { minimum = 0, maximum = Number.MAX_SAFE_INTEGER } = duration.value;+ if (durationSec < minimum || durationSec > maximum) {+ throw new Error(`${element.name}.duration must be between ${minimum} and ${maximum} seconds`);+ }+ } else if (duration.value.kind === "enum") {+ if (!duration.value.values.includes(durationSec)) {+ throw new Error(`${element.name}.duration must be -1 (auto) or between 4 and 30 seconds for ${model}`);+ }+ } else {+ throw new Error("Seedance duration port is not numeric");}const resolutions = enumeratedPort(table, "resolution");const resolution = optionalStringAttribute(element, "resolution") ?? "720p";diff --git a/packages/seedance/test/surface.test.ts b/packages/seedance/test/surface.test.tsindex 2f2ed411..f172cedc 100644--- a/packages/seedance/test/surface.test.ts+++ b/packages/seedance/test/surface.test.ts@@ -47,6 +47,21 @@ test("TextVideo exposes prompt-only generation without inventing a usage", asyncassert.equal(Object.keys(result.components[0]?.inputs ?? {}).some((name) => name.includes("media")), false);});+test("Seedance 2.5 is an exact model with auto or 4-30 second duration", async () => {+ const automatic = await decode(+ '<seedance:TextVideo id="motion" model="2.5" prompt={direction} duration="-1" resolution="720p" aspect-ratio="9:16"/>',+ decodeSeedanceTextVideoSurface,+ );+ assert.deepEqual(automatic.components[0]?.outputs, { video: "motion.video" });+ await assert.rejects(+ async () => await decode(+ '<seedance:TextVideo id="invalid" model="2.5" prompt={direction} duration="3"/>',+ decodeSeedanceTextVideoSurface,+ ),+ /-1 \(auto\) or between 4 and 30/u,+ );+});+test("FrameVideo exposes first-frame and optional last-frame as exact model ports", async () => {const result = await decode('<seedance:FrameVideo id="bridge" model="fast" prompt={direction} duration="5" first-frame={first.image} last-frame={last.image}/>',