SuperAPI AI 工具集

whiteboard-video

设计与创作

查看项目

更新于 10-15 21:53

技能介绍

用途:在 Codex 中本地生成白板手绘风格与故事视频,无需 Canva。该技能是独立安装的 whiteboard-video-engine Python 包的适配器,上传照片与密集插画在本地转为线稿,不用 GPT Image 2 生成最终线稿。

主要能力:脚本驱动故事视频按场景保留一组注册素材——GPT Image 2 只生成彩色分镜,本地神经提取器从同一彩色文件导出线稿。推荐栈:gpt-image-2 仅用于全彩分镜帧;Informative Drawings 本地模型(优先 anime_style)做线稿提取;Anime2Sketch 用于插画/动漫类来源或神经回退;可选 vtracer SVG 矢量化;可选 Doubao Voice 2(seed-tts-2.0)或 Edge TTS 配音。默认输出可编辑 sidecar SRT,或用 --burn-subtitles 输出带字幕 MP4。无边缘检测回退,两个神经模型都未安装时 extract-lineart 与 render-photo 必须失败。

使用方式:先安装引擎 python3 -m pip install "git+https://github.com/gnipbao/whiteboard-video-engine.git",本地开发用 python3 -m pip install -e /path/to/whiteboard-video-engine。在含 tools/lineart 的项目根目录运行,但始终用绝对路径调用已安装的 Skill wrapper;不要调用项目本地 whiteboard-video/scripts/whiteboard_cli.py。示例:MOCK=1 python3 "${CODEX_HOME:-$HOME/.codex}/skills/whiteboard-video/scripts/whiteboard_cli.py" run examples/ten-second-demo.md -o /tmp/whiteboard-demo.mp4 --scenes 2 --fps 30 --width 640 --height 360 --scene-assets direct-lineart --animation-preset block-speedpaint。另有 extract-lineart、render-photo、render-image、list-styles、recommend-styles、list-hands、doctor 等子命令。

视觉风格:引擎提供 30 个版本化媒体命名配方,稳定默认 warm-crayon-storybook,可用 WHITEBOARD_STYLE 配置。兼容组:native 15 个、adaptive 9 个、experimental 6 个。风格选择属于 plan-script 与 run;render-photo 与 render-image 不解析配方。

适用场景:脚本到故事视频、照片转白板、SVG/线稿渲染、带配音与字幕的成片。

限制:凭证通过 shell 或密钥管理器配置,不得写入脚本、提示词、project.json 或提交的 .env。图像与自动场景规划需 OPENAI_API_KEY;静音主版用 --tts-provider none;Doubao 新控制台用 DOUBAO_TTS_API_KEY,旧控制台用 DOUBAO_TTS_APP_ID 与 DOUBAO_TTS_ACCESS_KEY。--style、--custom-style、--custom-style-file 互斥。--captions 与 --no-captions 已弃用且与 --burn-subtitles 互斥。字幕由 FFmpeg/libass 在干净合成与 SRT 成功后烧录,失败时保留干净 MP4 与 SRT。其余细节暂未提供。