作者注：用 Nano Banana 定角色、用 Seedance 出绿幕动作、用 dsh-pet 素材链抠成透明背景，三步做出一只属于自己的动画桌宠。
GitHub 开源项目 dsh-pet 截至 2026-10-22 已有 3367 颗星。它让一只透明背景的 Q 版蓝发女仆住进 DeepSeek Harness（DSH）和你的桌面：待机呼吸、随机打瞌睡、点击 Q 弹、拖拽甩抛，一百多个动画无缝衔接。很多人看完的第一反应是：能不能换成我自己的角色？本文给出一条 Nano Banana 定角色 + Seedance 出绿幕动作 + 素材链抠成透明 的三步路线。
先说清楚：这不是原作者的做法。 dsh-pet 的 README 写明，原项目素材由豆包生成，全部动作都在 Premiere 里手工抠像。README 没提 Nano Banana，也没写具体的视频模型版本，原作者没用这些模型。Seedance 与豆包同属字节，路线上更贴近原作者，但我们不能说原作者用的就是 Seedance。本文的组合是我们给出的替换方案，标注「建议」的地方未经完整实测。
- 目标：做一只自己设计的角色桌宠，透明背景，在 DSH 和桌面上跑动画
- 耗时：粗估半天左右，Seedance 单段 10 秒视频的出片时间以实际为准，大部分时间花在挑选和重抽上
- 前置：DSH 桌面应用、一个 API易 令牌、Chrome / Edge / Firefox；抠像步骤另需 Python 3 和 ffmpeg
- 难度：中低。出图、出视频、装插件、调大小都是图形界面，只有抠像一步要命令行
核心价值：做完你会得到一个 pet pack，里面是自己角色的透明 webm 动画和配置文件，装进 dsh-pet 后它会在浏览器和桌面上待机、转身、走动。出图和出视频用同一个 API易（apiyi.com）Key 就能完成。
先看看原版鲸鱼娘：
点击回应：开心跃动。来源：github.com/PC2005-cloud/dsh-pet，素材禁止商用
鲸鱼吐泡泡。来源：github.com/PC2005-cloud/dsh-pet，素材禁止商用
AI 桌宠核心要点：三步工具与模型
dsh-pet 把自己定位成「三件套」：提示词（AI 生成动画的配方）、素材生成链（源视频转透明动画的管线）、插件（在 DSH 里跑的宠物）。本文只替换前半段的生成工具，提示词配方、素材链和插件全部沿用仓库原样。Seedance 是字节出品，在 API易 视频模型列表里标着「热卖中」。
| 步骤 | 工具（图形界面优先） | 模型 |
|---|---|---|
| ① 定角色 | API易 图片大师 | nano-banana-2 |
| ② 出绿幕动作（试跑） | iCover AI 浏览器页面 | doubao-seedance-2-0-mini-260615 |
| ② 出绿幕动作（进阶） | iCover AI 浏览器页面 | doubao-seedance-2-0-fast-260128 |
| ② 出绿幕动作（定稿） | iCover AI 浏览器页面 | doubao-seedance-2-0-260128（标准） |
| ② 出绿幕动作（新一代） | iCover AI 浏览器页面 | doubao-seedance-2-5-260628 |
| ③ 抠像与装宠物 | 仓库素材链脚本 / Premiere + DSH 插件管理 | 无 |
试跑用 mini，进阶用 fast，定稿用标准版，新一代是 2.5。另有一个更小的试跑规格：mini 480p、4 秒。
为什么非要绿幕加固定站位？素材链靠绿色做色相抠像，靠统一站位做归一化。只要某一段视频里角色偏了一点，切换动作时宠物就会肉眼可见地「跳位」，所以第 ① 步的绿幕站立图和第 ② 步的提示词前缀都要死守同一套位置。
AI 桌宠 3 步快速上手：定角色 → 绿幕动作 → 透明桌宠
第 ① 步：用 Nano Banana 定角色（设定图 + 绿幕站立图）
先在 API易 apiyi.com 后台新建一个令牌，计费选「按量优先」，分组同时勾选默认分组和 SeeDance2 分组。没勾 SeeDance2 分组时，调 Seedance 会报「该模型无可用渠道」；一个令牌同时勾默认和 SeeDance2，就能和 Nano Banana 共用。然后打开 API易 图片大师 imagen.apiyi.com，保存这个 Key，模型选 nano-banana-2，按钮名称以页面实际显示为准。
这一步要出两张图，思路属于编辑建议：
- 第一张：角色设定图。提示词写清角色外形（发色、服装、标志性配件），要求同一角色的正面、侧面、背面三视图并排，纯色背景。多抽几张，挑一张长相最满意的锁定下来。
- 第二张：16:9 绿幕标准正面站立图。把设定图作为参考图上传，比例选 16:9，提示词要求：单个角色标准正面站立、双手自然下垂、背景纯绿
#00FF00、无阴影无地面无道具、角色水平居中。 - 设计提醒（建议）：角色身上尽量不要用绿色，否则抠像时衣服会跟背景一起被抠掉。
第 ① 步验收标准：
- 绿幕图背景是纯
#00FF00，用系统取色工具点几处背景，色值一致、没有渐变和阴影 - 人物头顶约在画面高度 20%、脚底约在 85%，左右边缘约在 25% 与 75%
- 画面里只有一个正面站立的角色，四边至少留出 10% 空白，呆毛、尾巴、裙摆都没被裁切
如果模型给的背景不是纯 #00FF00，可以在图片大师里基于这张图继续编辑，要求「把背景改为纯 #00FF00」。能否一次到位我们没有实测，以验收结果为准。
第 ② 步：用 Seedance 出绿幕动作视频
出视频用 iCover AI（icover.ai）：在浏览器里选 Seedance，上传图片、粘贴提示词、选时长和分辨率即可，不用写代码。Seedance 的核心卖点是首尾帧：传 2 张图，分别作首帧和尾帧（role 为 first_frame / last_frame）。我们把第 ① 步那张绿幕正面站立图同时传成首帧和尾帧，视频开头和结尾就锁成同一个站姿，动画循环时能无缝衔接。页面如果有首帧、尾帧两个上传位，就都传同一张站立图，按钮名称以页面为准。
选模型和填参数时记住这几条：
- 模型：mini 是 doubao-seedance-2-0-mini-260615，fast 是 doubao-seedance-2-0-fast-260128，标准版是 doubao-seedance-2-0-260128，新一代是 doubao-seedance-2-5-260628。
- 三种模式互斥：首尾帧、只传首帧、多参考图只能选一种。我们用的是首尾帧。
- 宽高比跟首帧图走：所以第 ① 步的站立图必须是 16:9。2.5 做首尾帧时宽高比必须选 adaptive，写死比例会报 400。
- 时长：2.0 支持 4–15 秒，原配方的 10 秒直接用。不传时长时，2.0 默认 5 秒，2.5 默认由模型智能选时长，可能比预期翻倍，所以要显式选 10 秒。
- 分辨率：有 480p、720p、1080p，mini 和 fast 最高 720p。桌宠播放尺寸只有 640×360，建议 480p 试跑、720p 定稿（编辑建议）。
- 音频：默认带音频，桌宠用不到，把 generate_audio 设为 false 关掉。
提示词按 dsh-pet 仓库里 prompts/桌面宠物 10 秒动作提示词.md 的配方写：每段都带一段通用前缀，再接这个动作的按秒分解。通用前缀的约束可以对照下表速查：
| 约束 | 配方要求 | 不守的后果 |
|---|---|---|
| 位置 | 头顶约 20%、脚底约 85%，左右约 25% 与 75%，各段比例完全一致 | 切换动作时宠物跳位 |
| 绿幕 | 16:9，纯 #00FF00，无阴影、杂物、渐变、边框，各段色值一致 |
抠像残边或误抠 |
| 安全边距 | 身体部位和所有道具特效距画幅四边 ≥10% | 动画边缘被裁切 |
| 锚点 | 双脚落点恒定在画面正中，只允许原地转身、原地跳跃 | 角色漂移，归一化后错位 |
| 首尾一致 | 首帧和尾帧都传同一张标准正面站立图，最后一秒彻底恢复成同一姿态 | 循环衔接卡顿 |
| 道具 无→有→无 | 首帧无道具，魔法手势凝聚出现，结束前化为光点消散 | 首尾帧残留道具 |
| 大物件 | 大道具放角色正前方或正上方，放不下就 Q 版缩小，绝不挪人 | 角色被挤出原位 |
原配方每段就是 10 秒，Seedance 2.0 的 4–15 秒范围完全覆盖，所以按秒分解照原样用，不用重排。
原版鲸鱼娘待机，站位就是配方的标准位置。来源：github.com/PC2005-cloud/dsh-pet，素材禁止商用
站位要点：
- 头顶约在画面高度 20%，脚底约在 85%
- 左右边缘约在 25% 与 75%
- 四边都留出 10% 的空白
- 背景是纯
#00FF00 - 双脚落点始终不动
道具的「无→有→无」最容易出错，看原版是怎么做的：
魔方凭空出现、玩完消失，首尾都是干净站姿。来源：github.com/PC2005-cloud/dsh-pet，素材禁止商用
Seedance 这条路线有几处容易踩的坑，下表整理自 API易 的 Seedance 文档：
| 坑 | 文档说法 | 应对 |
|---|---|---|
| 没勾 SeeDance2 分组 | 报「该模型无可用渠道」 | 令牌同时勾选默认和 SeeDance2 分组，计费选按量优先 |
| 没显式设时长 | 不传时 2.0 默认 5 秒，2.5 智能选时长，可能翻倍 | 显式选 10 秒 |
| 2.5 首尾帧写死比例 | 宽高比必须是 adaptive，否则报 400 | 首尾帧模式下宽高比选 adaptive |
| 直链 24 小时过期 | 生成结果的下载直链只有 24 小时有效 | 状态变成 succeeded 后马上下载 |
| 默认带音频 | 不关会带一条用不到的音轨 | 用不到就把 generate_audio 设为 false |
| mini / fast 选 1080p | 这两个模型最高 720p，会报错但不扣费 | 要 1080p 换标准版或 2.5 |
| 模式混用 | 首尾帧、首帧、多参考图三种模式互斥 | 一次只用一种，本文用首尾帧 |
另外两条细节：任务失败可以重试；2.5 输出的 mov 不带透明通道，所以照样要走第 ③ 步抠像。
推荐的操作顺序：先用 mini、480p、10 秒跑一段「待机」，确认首尾都是同一个站姿、站位没漂；再把 12 个基础动作跑完，每个抽 2 次挑最好的；最后对满意的提示词换 720p 或标准版出交付素材。
第 ② 步验收标准：
- 视频首尾两帧都是标准正面站立，和传入的首帧、尾帧图姿态一致
- 全程背景是纯绿，角色没有左右平移，道具首尾都不在画面里
- 每个动作存成一个 mp4，用动作名命名，例如
待机.mp4
🚀 快速开始建议：第 ① 步和第 ② 步可以只用一个令牌完成，同时勾选默认分组和 SeeDance2 分组即可。以后想从图形界面转成脚本批量生成，OpenAI 兼容接口的 base_url 填
https://api.apiyi.com/v1；Seedance 脚本走同一域名下的POST /seedance/api/v3/contents/generations/tasks，不要用/v1/videos，那条路径的分辨率透传不全。
第 ③ 步：抠成透明 webm 并装进 dsh-pet
准备：安装插件（图形界面）。打开 DSH 桌面应用，进入「插件管理」页，在安装框里填 dsh-pet 并安装，装完必须重开桌面应用才生效。宠物默认同时出现在浏览器（右上角）和桌面，本机没有 Electron 时插件会在后台自动下载，几十秒到几分钟不等。屏幕上出现两只是正常的，在设置页「显示位置」下拉框里选仅浏览器或仅桌面即可。
装好后鲸鱼娘出现在 DeepSeek Harness 界面里。来源：github.com/PC2005-cloud/dsh-pet，素材禁止商用
装好后它会做什么：原版鲸鱼娘会跟着 DSH 的状态切换动作，下面是四个典型场景：
工作状态：思考冒泡。来源：github.com/PC2005-cloud/dsh-pet，素材禁止商用
写代码。来源：github.com/PC2005-cloud/dsh-pet，素材禁止商用
吃 Token。来源：github.com/PC2005-cloud/dsh-pet，素材禁止商用
被鼠标拖起悬空。来源：github.com/PC2005-cloud/dsh-pet，素材禁止商用
自造角色的 pet pack 配好后，也能做出同样的待机、拖拽等效果。
抠像路线 A（默认，需要命令行），命令照仓库原样，按顺序执行：
- 在终端里把仓库克隆到本地：
git clone https://github.com/PC2005-cloud/dsh-pet.git - 确认依赖齐全：README 要求 Python 3、ffmpeg、numpy、scipy；Python 包可用
pip install numpy scipy安装（编辑补充），脚本会优先用工作区.tools/下的 ffmpeg - 把第 ② 步挑好的 mp4 放进素材链约定的
video/目录，目录位置以仓库 README 为准 - 进入仓库的 scripts 目录，第 1 条，水印遮罩填充，输出到
step01/：python watermark_step01.py - 第 2 条，绿幕 HSV 色相抠像转透明，输出到
step02/：python chroma_step02.py - 第 3 条，归一化到 2160×1215、统一站立居中，输出到
step03/：python normalize_step03.py - 第 4 条，转码成 640×360 播放变体，输出到
step04/：python encode_thumbs.py
macOS 上命令可能是 python3。水印遮罩那步原本针对原项目素材，Seedance 素材能否跳过我们没有核实，建议照跑。
抠像路线 B（Premiere 手工抠像）：原作者全部动作走的就是这条。在 Premiere 里手工抠像，导出带 alpha 的透明 .mov（例如 ProRes 4444 with Alpha），文件名与动作名一致放进 pr/，然后运行 python pr_import_step02.py 覆盖自动抠像结果，再接上面第 3、4 条。路线 B 把最容易出问题的抠像换成手工，但按 README，导入、归一化、转码仍是脚本，能否完全不碰命令行我们不确定。
装进 pet pack（自造角色走这条），以种类名 xiaoju 为例：
- 建文件夹：在
$DSH_HOME/dsh-pet/下新建pet文件夹，再在pet里新建xiaoju-animation文件夹，把step04/里的 webm 全部复制进去。$DSH_HOME是 DSH 的数据目录，默认位置我们没有核实，以本机 DSH 为准。 - 建文件：在
pet里新建xiaoju-config.json，前缀必须和动画文件夹同名配对。 - 字段
pets：数组，每个元素是一只实例，填"id": "xiaoju-1"（不能和主宠物的main重复）、"size": 462、"balanceEnabled": false、"display": "both"、"position": { "corner": "top-right", "marginX": 24, "marginY": 100 }。 - 字段
animations：idle、turn、drag、clicks、moves、categories、events必须写全，值是动画名，对应同名文件，例如"idle": "待机"会去找待机.webm。 - 字段
animationWeights：也必须写全，不会回落全局；默认参考是 idle 10 / turn 5 / move 5 加分类权重。
配置与 main-config.jsonc 同构，最稳的做法是复制包内 assets/config.jsonc 的结构，只改动画名和 id。素材只查自己的目录，找不到就 404，不会借用主宠物素材。
调大小和位置：主宠物在设置页「桌宠配置」里改宽度（高度 = 宽度 × 9/16）、四角位置和边距，点「保存」即时生效。注意设置页不列出文件宠物，pet pack 的大小位置要改 xiaoju-config.json 里的 size 和 position，保存后刷新可见。
第 ③ 步验收标准：
step04/里每个动作都有一个 webm- 在 Chrome / Edge / Firefox 里看是透明而不是黑底；直接拖进标签页时部分浏览器播放页本身是深色背景，最可靠的验收是装进桌宠后宠物四周能透出下面的网页或桌面
- 宠物在动作之间切换不跳位，循环时首尾衔接不卡顿
AI 桌宠排错：常见故障与什么时候不该这么做
AI 桌宠排错表
| 现象 | 原因 | 怎么办 |
|---|---|---|
| 透明处变黑底 | Safari / WKWebView 不认 webm alpha | 换 Chrome / Edge / Firefox；macOS 原版宠物可用 Release 里 assets-mov 的 .mov，放进 main-animation/mov/ |
| 边缘残绿边、道具被抠掉 | 自动 HSV 对复杂边缘和第三方物品易残边误抠；角色身上有绿色 | 该动作改走路线 B；重新设计时避开绿色 |
| 切换动作时宠物跳位 | 各段站位或大小不一致 | 重抽偏差大的段；确认跑过 normalize_step03；前缀保持一字不差 |
| 报「该模型无可用渠道」 | 令牌没勾 SeeDance2 分组 | 在令牌设置里同时勾默认和 SeeDance2 分组 |
| 视频只有 5 秒，或长度翻倍 | 没显式设时长，2.0 默认 5 秒，2.5 智能选时长 | 显式选 10 秒 |
| 2.5 做首尾帧报 400 | 宽高比写死了固定比例 | 宽高比改选 adaptive |
| 首尾对不上，循环卡顿 | 首帧、尾帧传的不是同一张图，或没用首尾帧模式 | 两个上传位都传同一张站立图；仍不齐就重抽，失败了就重抽 |
| 下载链接打不开 | 直链 24 小时过期 | 状态变成 succeeded 就马上下载保存 |
| mini / fast 选 1080p 报错 | 这两个模型最高 720p | 改回 720p，报错不扣费 |
| 宠物不出现或素材 404 | 配置非法、缺 -animation 目录、id 与主宠物冲突、动画名和文件名不一致 | 逐项核对，看 DSH 控制台报错 |
| 余额气泡显示「当前服务商暂不支持余额查询」 | API易 不在 dsh-pet 已登记的余额服务商里 | 属正常现象，不会显示 API易 余额；不想看就关掉余额开关 |
什么时候不该这么做
自己生成角色并不总是最优解，下面几种情况建议换路线：
- 只想要一只现成的女仆桌宠：直接在插件管理里装
dsh-pet就行，不必自己生成任何素材。 - 要商用：原作者的素材、提示词和源视频禁止商用，不能拿来卖；自造角色的版权也要你自己确认，尤其是参考了现有 IP 的设计。
- 要发布二创：衍生、改版、换皮在任何介绍、展示、分发处都要附原作者 GitHub 地址
github.com/PC2005-cloud/dsh-pet。
AI 桌宠常见问题 FAQ
Q1：dsh-pet 原作者是用 Nano Banana 和 Seedance 做的吗？
不是。README 写明原项目素材由豆包生成，全部动作用 Premiere 手工抠像，没提 Nano Banana，也没写具体的视频模型版本。Seedance 与豆包同属字节，路线上更贴近原作者，但 README 没写具体版本，不能说原作者用的就是它。Nano Banana 加 Seedance 是本文给出的替换方案，提示词配方和素材链沿用仓库原样。
Q2：首帧和尾帧要传什么图？
把第 ① 步的 16:9 绿幕正面站立图同时传成首帧和尾帧，视频开头结尾就锁成同一站姿，动画能无缝衔接。首尾帧、只传首帧、多参考图三种模式互斥，一次只能用一种。宽高比跟着首帧图走，2.5 做首尾帧时宽高比必须选 adaptive，否则报 400。不建议传三视图拼图，第一帧可能出现三个角色。
Q3：Seedance 的时长要怎么选？
原配方每段是 10 秒，Seedance 2.0 支持 4–15 秒，所以直接选 10 秒就行。一定要显式设置：不传时长时，2.0 默认 5 秒，2.5 默认由模型智能选时长，可能翻倍。试跑可以先用 mini 480p。
Q4：一个 Key 能同时调 Nano Banana 和 Seedance 吗？
可以。在 API易 apiyi.com 新建一个令牌，计费选「按量优先」，分组同时勾选默认和 SeeDance2，图片大师和 iCover AI 都能用它。没勾 SeeDance2 会报「该模型无可用渠道」。建议先用 nano-banana-2 和 mini 480p 跑通流程，再决定哪些动作值得换 720p 或标准版。
Q5：完全不会命令行，能做完吗？
出图、出视频、装插件、调大小都可以纯图形界面完成。抠像可以用 Premiere 手工做（路线 B），但按 README，后续导入、归一化和转码仍是脚本。如果卡在环境上，可以先把前两步在 API易 的图形工具里做好，再找熟悉命令行的朋友帮忙跑最后四条命令。
Q6：做好的桌宠能商用吗？
dsh-pet 代码是 MIT 许可，但原作者的动画、提示词、源视频禁止商用。用 Nano Banana 和 Seedance 生成的自造角色能否商用，取决于你的角色设计和模型服务条款，需要你自行确认，我们无法替你判断。
AI 桌宠总结：Key Takeaways 与参考资料
AI 桌宠核心要点 Key Takeaways
- 路线定位：Nano Banana 加 Seedance 是替换方案，原作者用的是豆包和 Premiere，Seedance 与豆包同属字节
- 第 ① 步关键：一张 16:9 纯
#00FF00正面站立图，头顶约 20%、脚底约 85% - 第 ② 步关键：同一张站立图传成首帧和尾帧，10 秒配方直接用，首尾都是标准正面站立
- 最容易踩的坑：令牌没勾 SeeDance2 分组，以及没显式设 10 秒时长
- 第 ③ 步关键：四个脚本按顺序跑，pet pack 的 animations 和权重必须写全
- 试跑方式：mini 480p 先跑通，满意后再上 720p 或标准版
- 上手方式：一个按量优先令牌，同时勾默认和 SeeDance2 分组，搞定出图和出视频
总结
做一只自己的 AI 桌宠，本质是把 dsh-pet 的「提示词 → 素材链 → 插件」三件套里的生成工具换掉：Nano Banana 负责锁定角色和站位，Seedance 负责按配方出绿幕动作，仓库素材链负责抠成透明并归一化。整条链路里最该花心思的是站位和首尾一致，这两点做好了，后面的抠像和装配基本是体力活。
建议先拿「待机」一个动作走完全流程，确认透明、不跳位、首尾衔接都过关，再批量做剩下的动作。推荐通过 API易 apiyi.com 用 mini 480p 先试跑，验证效果后再决定交付质量。
参考资料
- dsh-pet 仓库：项目 README、提示词配方、素材链脚本
- 链接：
github.com/PC2005-cloud/dsh-pet -
说明：安装、pet pack 配置、许可条款以 README 为准，二创须附此地址
-
DeepSeek Harness：dsh-pet 的宿主应用
- 链接：
github.com/deepseek-ai/deepseek-harness -
说明：桌面应用与 dsh web 两种形态
-
API易 Seedance 2 文档：模型、首尾帧、时长、分辨率与参数规则
- 链接：
docs.apiyi.com（Seedance 2 页面） - 说明：本文 Seedance 的坑来自此文档。
作者：API易 技术团队
技术交流：生成桌宠素材时遇到接口问题，欢迎在 API易 apiyi.com 首页联系我们
