| name | polym-seedance-mini-experience-center |
| description | Batch-generate Seedance 2.0 Mini videos via the BytePlus console BFF (Mini has no public API). Covers T2V, image/video reference (I2V/R2V), first/last frame, and human portraits. Triggers: "seedance mini", "dreamina mini", "用 mini 出视频". |
Seedance 2.0 Mini — Experience Center
Mini (dreamina-seedance-2-0-mini-260615) 没有公开 OpenAPI，只能走 BytePlus
控制台「体验中心」的 BFF 接口。本 skill 把整条链路封装成本地 CLI / Python 库，
让你脱离网页批量提交。所有图片/视频/音频参考（含人像）统一走素材库（Assets API）。
这条路线是逆向 + 端到端验证过的：T2V、非人像 I2V、人像 I2V 都能出片。
详见 [[reference_seedance_mini_console_bff_api]]（auto-memory）。
三种认证 / 凭证
| 凭证 | 用途 | 来源 | 是否必须 |
|---|
| Cookie + csrfToken | mini BFF 提交/查询 | 本机 Chrome（已登录 console.byteplus.com） | 必须 |
| AK/SK | 素材库 Assets API 上传 | onboard 时 --ak/--sk，或 env ARK_AK/ARK_SK，或自带 ~/.seedance_mini/ak_sk.json | 传素材才需要（纯 T2V 不需要） |
关键设计：凭证只在 onboarding 时读一次 Chrome cookie（Mac 上触发一次 keychain 授权），
之后全部读本地缓存 ~/.seedance_mini/creds.json，绝不重复弹 keychain。
Onboarding（首次必做，只授权一次）
cd <skill>/scripts
python3 creds.py onboard
python3 creds.py onboard --ak AKLT... --sk ...
python3 creds.py status
凭证失效（调用报 InvalidCSRFToken，cookie 一般几天过期）时：
python3 creds.py refresh
前置条件：
- Python 依赖：
pip install browser-cookie3 requests（macOS 上 pip3 install ... --break-system-packages）。
- 本机 Chrome 已登录 https://console.byteplus.com/ark/。
- 首次用素材库前，需在控制台「素材库」签署数字资产承诺函（一次性）。
- AK/SK：onboard 时用
--ak/--sk 提供，或设 env ARK_AK/ARK_SK，或放 ~/.seedance_mini/ak_sk.json（仅上传素材库需要，纯 T2V 不需要）。本 skill 自包含，不读取其它 skill 的文件。
⚠️ 安全须知
~/.seedance_mini/creds.json 是明文存储完整登录 cookie（约 67 个）+ AK/SK，
权限收紧到 600（仅本人可读）。这是为了避免每次调用都弹 macOS keychain 的有意取舍，
但请注意：
- 不要把
~/.seedance_mini/ 纳入 Time Machine / 云同步 / git。
- 这等于把"登录态 + AK/SK 两个凭证"放在同一个明文文件，泄漏即双失。
- 撤销方式：控制台登出（使 cookie 失效）+ 轮换 AK/SK。
- cookie 一般几天过期，过期后
python3 creds.py refresh 重取。
用法
CLI
cd <skill>/scripts
python3 mini.py gen "金色麦田夕阳下随风起伏，镜头横移" --duration 5 --wait
python3 mini.py gen "[image1] 人物轻轻转头微笑，镜头缓缓推近" \
--image /path/to/face.jpg --wait
python3 mini.py gen "镜头从清晨推到日落" --first f0.jpg --last f1.jpg --wait
python3 mini.py upload /path/to/ref.jpg --type Image
python3 mini.py get cgt-xxxxx
python3 mini.py list
Python 库（批量任务推荐）
import sys; sys.path.insert(0, "<skill>/scripts")
import creds, mini
s = creds.bff_session()
face = mini.upload_asset("face.jpg", session=s)
bottle = mini.upload_asset("bottle.jpg", session=s)
ids = mini.generate(
"[image1] 人物看向 [image2] 香水瓶，镜头缓缓推进",
image_assets=[face, bottle], duration=5, count=2, session=s,
)
for r in mini.wait_for_tasks(ids):
print(r["Status"]["Phase"], r.get("VideoUrl"))
素材库统一上传流程（本地文件 → 可引用 asset）
upload_asset() 内部做了 4 步（已验证）：
GetBatchPreSignedUrl + PUT：本地文件 → 临时 TOS，拿 7天签名 URL（mini BFF, cookie）CreateAsset：用该 URL 注册进素材库（Assets API, AK/SK）→ asset_id- 轮询
GetAsset 到 Active
- 提交时引用：
ReferenceImages=[{AssetId, AssetUri:"asset://<id>"}]（最简结构，缺一不可）
人像必须走素材库才能过审：裸 presigned 直传的人像会被
InputImageSensitiveContentDetected.PrivacyInformation 拦；走 Assets API 注册的
资产是「可信来源」，已验证人像 I2V 能出片。
提示词规则（沿用 seedance-2-0）
- 多参考素材用
[image1]/[video1]/[audio1] 标注（与 image_assets= 等参数顺序对应）。
- 人像参考最好拆分（脸部特写 / 三视图 / 服装分开传多个 asset）——这是 BytePlus 团队的
best practice，可降低身份漂移和风控误判。
- 本 skill 只负责"Mini 的提交通道"；导演级提示词优化（6-component / 时长计算 / 多镜头）
是独立工艺，若另装了
seedance-2-0 skill 可调用它来生成更强的 prompt。
BFF 接口速查（modelark-api.console.byteplus.com/.../2024-01-29）
| 功能 | Action | 备注 |
|---|
| 上传(第一步) | GetBatchPreSignedUrl | {Biz:"experience_video", TosPathArray:[name]} → PutUrl + 7天读 Url |
| 提交 | CreateVideoGenTask | 见 mini.py payload；图片参考 ReferenceImages:[{AssetId,AssetUri}] |
| 查询 | GetVideoGenTask | {Id} → Status.Phase / VideoUrl |
| 列表 | ListVideoGenTasks | {PageSize} → Items |
⚠️ 海外版没有 UploadArkTosFile / CheckTosService / ListActiveAIGCAssetGroup
等接口（直接 404）——素材列表/管理走 Assets API（assets.py），不要走 BFF。
文件
scripts/creds.py — 凭证管理（onboard/refresh/status + 本地缓存 + BFF session 构建）scripts/mini.py — Mini BFF 客户端 + 素材库上传 + 高层 upload_asset/generate/wait_for_tasksscripts/assets.py — Assets API SigV4 客户端（vendored 自 seedance-2-0/scripts/assets.py，纯 stdlib，无第三方依赖）
维护：assets.py 是 vendored 副本
scripts/assets.py 是从 seedance-2-0 skill 复制来的本地副本（让本 skill 自包含、可独立安装）。
它不会自动跟随上游更新——若上游修了签名/接口 bug，需手动重新 vendpr：用上游
assets.py 覆盖本文件，并在 CHANGELOG.md 记一笔。文件头有 vendored 来源与日期注释。
