作者注：用 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 首頁聯繫我們
