一句话出片的 Codex 集合插件：实时读取 88api.ai 当前视频模型、价格、能力与可用状态，由用户选择模型后生成单条短片或 TVC/广告片。
首次使用配置两个彼此独立的凭据：生成用 API Key，账户/价格查询用个人访问令牌。两项凭据都可以在受信任的 Codex 私人任务中直接交给 Agent 一键配置；个人访问令牌同时保留本机隐藏输入方式。插件不会替用户擅自决定视频模型。
已适配 88API 当前视频规范：NewAPI 任务插件继续通过 /v1/videos 创建与轮询。支持目录中的任务模型识别、按秒 tiered_expr 计费、各模型素材字段、本地图片上传和结果 URL 下载。Veo 支持 4/6/8 秒、720p/1080p 和显式图片模式；保留 Image 2.5 生图预设。
video --dry-run 不上传、不生成；正式创建不自动重试，查询失败可继续查询原任务。未知计价表达式会阻止付费提交。运行 node --test tests/*.test.mjs 执行离线回归；在线 models --json 与 --self-test 只读，不产生视频生成费用。完整变更和验证范围见 CHANGELOG.md。
| 工作流 | 输入 | Codex 自动完成 | 产出 |
|---|---|---|---|
| ① 想法 → 成片 | 一句话想法 | 获取实时视频模型、价格和能力 → 用户选模型 → 按该模型单段上限自动分级 → 必要时拆段并 concat |
单条短片 / TVC 的 MP4 |
| ② 视频 → 反推 | 一条参考视频 | ffmpeg 抽帧 → 逐帧证据观察 → 结构化还原运镜/动作/文字/声音 | 可直接生成的提示词 |
| ③ 视频 → 复刻工程包 | 一条参考视频 | ②的全部 + 素材盘点 + 人物身份路由（原片演员新身份 / 授权替换人物原图直传）+ 逐段绑定提示词 | 补齐素材即可一键生成的完整工程 |
插件首次被调用时会主动介绍上述三种用法，并给出可直接照着说的例子：
做一条 10 秒竖屏运动鞋广告。
反推这个视频的提示词。
把这个参考片做成可复刻工程包，我要换成自己的产品。
介绍只显示一次，随后自动继续用户刚才的任务，不要求重新描述。
首次出片会展示所有当前视频模型的模型 ID、实时单价、能力摘要和三层可用状态（目录、账户、当前 API Key），等待用户明确选择。多镜片还会确认拆段、价格版本和总估算金额。本插件专注单条短片与 TVC，不做多集连续短剧/剧集/电影。
功能③是对"光有提示词还不够"的回答：好视频 = 提示词 × 素材绑定 × 时间结构。工程包内含素材职责表与缺失素材清单（原片每种产品形态各需一张干净图），补齐后直接进入①的生成阶段。
- 🎬 动态视频目录与模型适配：从
/api/pricing获取当前视频模型、价格和能力，再按各模型的 88API 规范选择提交模型名、端点和请求参数，并与/api/user/models、/v1/models交叉验证 - 💰 账户与计费：只读查询余额，按实时计价单位显示单价，并在付费提交前计算本次估算金额
- 🎧
gemini-3.7-flash：默认用于视频音频反推，一次拆出台词、BGM 和音效时间线 - 🖼 gpt-image-2 / gpt-image-2-4k / gpt-image-2.5-flare / gpt-image-2.5-sunburst 生图：关键帧预审、人物/产品/场景锚定图（跨段一致性）
- 👤 授权人物直传：用户另行提供并指定的人物原图作为唯一身份权威，每张关键帧与视频请求都直接携带，避免 AI 图套 AI 图造成身份漂移和合成感
- 🔍 反推：ffmpeg 抽帧 + Codex 逐帧观察，零 API 成本，证据优先防幻觉
- 🧵 拼接：
concat命令流复制拼段（异常时--reencode） - 🛡 成本安全：dry-run、防重复提交闸、failed 任务 NO-RETRY、拆段方案先确认总计费秒数
- 📡 任务监控：提交后立即返回任务ID，Agent提示用户耐心等待并持续输出状态心跳，直到下载完成
- 🧾 参考图审计：图生视频必须通过
--require-image和[REFERENCE-AUDIT]，缺图时在付费前拦截
图片生成默认使用 gpt-image-2。明确点名时可传 --model gpt-image-2.5-flare 或 --model gpt-image-2.5-sunburst；两个新模型使用插件 2K 预设，不代表上游仅支持 2K。用户未指定其它模型而明确要求4K时使用 gpt-image-2-4k；只有明确点名 Nano Banana/Gemini 时才转到 Gemini 图片插件。
插件在询问凭据前会运行程序级 preflight。它能识别 Seedance 自身配置，也会复用本机 88api-image-gen 或 88api-nano-banana 已保存的88API Key；预检显示有效时不会重复索要。
- Codex 插件功能 + Node.js 18+
- ffmpeg（反推与拼接需要）
- 一个 88api.ai API Key（建议
auto分组，用于生成） - 一个 88api.ai 个人访问令牌（用于只读查询余额、价格、能力和状态）
打开 88api.ai 注册账号并登录。
进入“API 密钥”页面，点击“创建 API 密钥”。名称可以自定义（例如 Seedance Studio），分组建议选择 auto（自动分组），以便同时调用 Seedance 视频模型和 Image-2 关键帧模型。如需在当前分组请求失败时继续尝试下一分组，可以开启“跨分组重试”。
进入 “个人资料 → 安全”，创建系统访问令牌。该令牌用于 /api/* 账户接口，与生成 API Key 不同；插件会通过 /api/user/self 自动识别用户 ID。
创建完成后，分别复制 API Key 和个人访问令牌的完整内容。两者都只用于你自己的 Codex 配置，请勿粘贴到 Issue、公开聊天、仓库文件或截图中。
安装插件后直接向 88API-Seedance-Studio 描述视频需求。Agent 会先介绍插件用法并检查两项凭据。推荐把 API Key 和个人访问令牌直接交给当前受信任任务中的 Agent，它会自动保存、脱敏验证、查询余额并显示实时模型列表；验证通过后不会要求撤销或重新创建凭据。你不愿在聊天中发送个人访问令牌时，再改用隐藏输入助手。
聊天配置的 API Key、个人访问令牌与模型选择保存在本机权限受限的 ~/.seedance-studio/config.json；隐藏输入方式则把访问令牌保存到 SEEDANCE_STUDIO_ACCESS_TOKEN Windows 用户环境变量。Agent 不会在回复中显示完整凭据；账户、目录和自检不会发起付费生成。
仅在自己信任的 Codex 任务中提供凭据，不要把 API Key 或个人访问令牌发布到 GitHub Issue、公开聊天、仓库文件或截图中。
高级用户：手动配置命令
node plugins/seedance-studio/scripts/studio.mjs --set-key "<YOUR_88API_KEY>"
node plugins/seedance-studio/scripts/studio.mjs --set-access-token "<YOUR_88API_ACCESS_TOKEN>"
node plugins/seedance-studio/scripts/studio.mjs --configure-access-token
node plugins/seedance-studio/scripts/studio.mjs intro
node plugins/seedance-studio/scripts/studio.mjs preflight --scope image --json
node plugins/seedance-studio/scripts/studio.mjs account
node plugins/seedance-studio/scripts/studio.mjs models
node plugins/seedance-studio/scripts/studio.mjs --set-video-model "<EXACT_MODEL_ID>"
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 插件市场结构）。
- 直接描述视频需求；按 Agent 提示配置 API Key 和个人访问令牌。
- 从实时列表中明确选择视频模型。
- 在 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 account --json
node plugins/seedance-studio/scripts/studio.mjs models --json
node plugins/seedance-studio/scripts/studio.mjs --set-video-model "Seedance-2.5-720p官方版"
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 --require-image --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- 时长、分辨率、画幅、参考素材和声音能力以用户所选模型的实时目录说明为准，不得把 Seedance 能力套到其它模型。
- 当前 CLI 只允许目录端点类型含
openai-video或video-generation的模型走/v1/videos；其它视频模型会展示为“端点不兼容”。 available表示目录、账户和 API Key 三层检查通过，不保证上游永远有容量；临时熔断仍可能发生。- 所选模型支持视频/音频参考时，素材必须是公网可直连 URL；本地图片参考走 base64。
- 复刻参考视频中的原演员时生成新身份锚定图，不从原片抽帧；用户另行提供并明确指定的授权人物照片则保持为唯一身份权威，使用
--identity-ref/--identity-image直传，禁止只在第一次生图后改用 AI 锚定图。BGM 不提取原曲（版权）。 - 两项凭据均为敏感信息；不要提交配置文件、粘贴到 Issue 或放进截图。
- 提示词方法论 references 改编自 allenGKC/Seedance-2.5（MIT，见 THIRD-PARTY-LICENSE-seedance25os.txt）。
- 反推与复刻方法论参考社区证据优先实践（fkyhdd、daihuo-fanpai 等项目的公开经验），正文为本项目重写。
- 插件结构参考 blackdm666/88API-image-gen；接口规格来自 88api.ai 官方文档。
非 ByteDance / 即梦 / Dreamina / 88api 官方项目。