一句话出片的 Codex 集合插件：基于 88api.ai 的 Seedance 2.5 满血版，专注单条短片与 TVC/广告片。
你只需要做两件事：装插件、填 Key。 之后一句话说想法，剩下的全部由 Codex 自动完成。
| 工作流 | 输入 | Codex 自动完成 | 产出 |
|---|---|---|---|
| ① 想法 → 成片 | 一句话想法 | 自动按规模分级：T0 单镜直接出（含 15–30 秒 TVC）· T1 多镜短片拆段生成 + concat 拼接成一条连续成片 |
单条短片 / TVC 的 MP4 |
| ② 视频 → 反推 | 一条参考视频 | ffmpeg 抽帧 → 逐帧证据观察 → 结构化还原运镜/动作/文字/声音 | 可直接生成的提示词 |
| ③ 视频 → 复刻工程包 | 一条参考视频 | ②的全部 + 素材盘点 + 人物身份路由（原片演员新身份 / 授权替换人物原图直传）+ 逐段绑定提示词 | 补齐素材即可一键生成的完整工程 |
① 自动分级：T0 一句话直接出，T1 多镜短片只在开拍前跟你确认一次拆段与总计费秒数——既保住"一句话出片"，又不让你在不知情下烧掉一条长片的钱。本插件专注单条短片与 TVC，不做多集连续短剧/剧集/电影：跨集一致性靠喂图会漂、角色配音锁不住、且持续烧钱成本高；遇到连续剧需求，它会帮你先做一条自成一体的样片/预告/TVC，成系列请换专门的制片工具链。
功能③是对"光有提示词还不够"的回答：好视频 = 提示词 × 素材绑定 × 时间结构。工程包内含素材职责表与缺失素材清单（原片每种产品形态各需一张干净图），补齐后直接进入①的生成阶段。
- 🎬 Seedance 2.5 满血版：4–30 秒、720P、同步音频、多模态参考（30 图 / 10 视频 / 10 音频）
- 🖼 gpt-image-2 生图：关键帧预审、人物/产品/场景锚定图（跨段一致性）
- 👤 授权人物直传：用户另行提供并指定的人物原图作为唯一身份权威，每张关键帧与视频请求都直接携带，避免 AI 图套 AI 图造成身份漂移和合成感
- 🔍 反推：ffmpeg 抽帧 + Codex 逐帧观察，零 API 成本，证据优先防幻觉
- 🧵 拼接：
concat命令流复制拼段（异常时--reencode） - 🛡 成本安全：dry-run、防重复提交闸、failed 任务 NO-RETRY、拆段方案先确认总计费秒数
- Codex 插件功能 + Node.js 18+
- ffmpeg（反推与拼接需要）
- 一个 88api.ai Key（
auto分组，或包含视频与生图模型分组）
打开 88api.ai 注册账号并登录。
进入“API 密钥”页面，点击“创建 API 密钥”。名称可以自定义（例如 Seedance Studio），分组建议选择 auto（自动分组），以便同时调用 Seedance 视频模型和 Image-2 关键帧模型。如需在当前分组请求失败时继续尝试下一分组，可以开启“跨分组重试”。
创建完成后，复制 Key 的完整内容。Key 只用于你自己的 Codex 配置，请勿粘贴到 Issue、公开聊天、仓库文件或截图中。
安装插件后直接向 88API-Seedance-Studio 描述视频需求。Agent 会先自动检查 Key；如果尚未配置，它会主动请你提供完整 Key。你只需把 Key 发给 Agent，Agent 会自动保存、脱敏核验并继续原任务，不需要打开 PowerShell。
Key 会保存在本机 ~/.seedance-studio/config.json。Agent 不会在回复中显示完整 Key，验证过程也不会发起付费生成任务。
仅在自己信任的 Codex 任务中提供 Key，不要把 Key 发布到 GitHub Issue、公开聊天、仓库文件或截图中。
高级用户：手动配置命令
node plugins/seedance-studio/scripts/studio.mjs --set-key "<YOUR_88API_KEY>"
node plugins/seedance-studio/scripts/studio.mjs --get-config
node plugins/seedance-studio/scripts/studio.mjs --self-test
node plugins/seedance-studio/scripts/studio.mjs --caps- 安装插件（本仓库为标准 Codex 插件市场结构）。
- 直接描述视频需求；如未配置 Key，按 Agent 提示把 Key 发给它，由 Agent 一键完成配置。
- 在 Codex 新任务里说人话：
@88API-Seedance-Studio 做一个 45 秒的竖屏治愈短片：雨夜女孩把流浪猫带回家。
@88API-Seedance-Studio 反推这条视频的提示词：D:\videos\ref.mp4
@88API-Seedance-Studio 给我这条视频的复刻工程包，我想换成我自己的产品：D:\videos\hot.mp4
node plugins/seedance-studio/scripts/studio.mjs video --prompt "雨夜东京街头，银色跑车驶过，霓虹倒影，电影级跟拍" --duration 10 --ratio 16:9
node plugins/seedance-studio/scripts/studio.mjs video --prompt "..." --image product.jpg --duration 8 --dry-run
node plugins/seedance-studio/scripts/studio.mjs video --prompt "..." --identity-image person.jpg --first-frame opening.png --duration 8 --dry-run
node plugins/seedance-studio/scripts/studio.mjs status --task task_xxx --wait
node plugins/seedance-studio/scripts/studio.mjs image --prompt "产品关键帧…" --aspect 16:9
node plugins/seedance-studio/scripts/studio.mjs image --prompt "人物关键帧…" --identity-ref person.jpg --ref scene.jpg --aspect 16:9 --dry-run
node plugins/seedance-studio/scripts/studio.mjs concat --dir seedance-projects/demo/segments --out final.mp4- API 生成面为 4–30 秒 / 720P；更长成片由插件自动拆段 + 拼接。即梦网页版专属能力（180 秒原生超长、局部编辑、绿幕、白模）不经 API；需要时插件生成可粘贴到即梦网页的提示词作为降级。
- 视频/音频参考素材需公网可直连 URL；图片参考走 base64 无此限制。
- 复刻参考视频中的原演员时生成新身份锚定图，不从原片抽帧；用户另行提供并明确指定的授权人物照片则保持为唯一身份权威，使用
--identity-ref/--identity-image直传，禁止只在第一次生图后改用 AI 锚定图。BGM 不提取原曲（版权）。 - Key 保存在本机
~/.seedance-studio/config.json，不要提交到任何仓库。
- 提示词方法论 references 改编自 allenGKC/Seedance-2.5（MIT，见 THIRD-PARTY-LICENSE-seedance25os.txt）。
- 反推与复刻方法论参考社区证据优先实践（fkyhdd、daihuo-fanpai 等项目的公开经验），正文为本项目重写。
- 插件结构参考 blackdm666/88API-image-gen；接口规格来自 88api.ai 官方文档。
非 ByteDance / 即梦 / Dreamina / 88api 官方项目。