Skip to content

armgit / hypit

Public Imported from GitHub
0

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.

feat(seedance): add KIE Seedance 2.5 support

kashorin6893c956174f
diff --git a/docs/quickstart/generation.md b/docs/quickstart/generation.md
index 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:TextVideo
diff --git a/docs/zh/quickstart/generation.md b/docs/zh/quickstart/generation.md
index 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:TextVideo
diff --git a/examples/talking-film-graph-check/svml.packages.lock b/examples/talking-film-graph-check/svml.packages.lock
index 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.lock
index 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.lock
index 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.lock
index 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.lock
index 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.md
index 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 generic
background-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`: exact
Capability, return Type, request compiler, media/count limits and result packer. All Routes share one
upload, 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.ts
index 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.ts
index 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 reque
assert.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.ts
index 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 by
fetch: 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.ts
index 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.ts
index 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.ts
index 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", async
assert.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}/>',