跳至正文
所有教學

PhotoCraft MCP

PhotoCraft MCP 聯動 AnimGen:把角色 PNG 做成跳躍動畫

用 PhotoCraft MCP 擴展角色畫布,再通過 AnimGen MCP 產生跳躍,最後回到 PhotoCraft 清理匯出影格。附真實影片、操作參數和 24 FPS 透明素材。

AnimGen更新於 11 分鐘閱讀
橙色機器人跳躍,展示 PhotoCraft MCP 與 AnimGen 聯動製作動畫的流程
本文目錄

站立時剛好放得下的角色,一跳起來就可能頂到畫面邊緣。我們用 PhotoCraft MCP 給橙色機器人增加上方透明留白,再把這張 PNG 交給 AnimGen MCP 產生動作。匯出後有兩個影格出現少量殘色,也回到 PhotoCraft 中做了清理。

下面保留了完整的一次跳躍,包括落地和恢復站姿,仍按原來的 24 FPS 播放。淺色背景只是為了方便觀看,下載的 WebM 和 PNG 影格仍然透明。

本次 MCP 案例的完整單次跳躍:77 影格、24 FPS,約 3.21 秒,包含落地和起身動作。

把 PhotoCraft MCP 接到本地素材目錄

這次使用官方 PhotoCraft 0.9.0 CLI,實測日期為 2026 年 10 月 14 日,系統為 macOS。CLI 可以啟動無介面的 MCP 服務,本文的圖片操作不需要開啟編輯器視窗。桌面版的安裝方式見 PhotoCraft 下載指南。

準備一個工作目錄和其中的 output 子目錄,然後讓 MCP 客戶端按下面的參數啟動下載好的程式。範例路徑需要換成你自己的絕對路徑:

bash
photocraft-cli mcp \
  --automation-read-root /absolute/path/robot-project \
  --automation-write-root /absolute/path/robot-project/output

這兩個目錄限定服務可以讀寫的位置。doc_open 的路徑相對於讀取目錄,doc_save 的路徑相對於寫入目錄。連線後先開啟 PNG,再通過 command_list 查詢需要的命令。官方 MCP 文件說明了無介面模式、命令發現,以及供 UI 工具使用的 bridge 模式。

AnimGen 按 MCP 客戶端接入指南連線。它是使用 OAuth 的遠端服務,地址為 https://api.animgen.com/mcp;本案例中的 PhotoCraft 則執行在本機。

給機器人上方留出空間,不縮放角色

原始機器人 PNG為 1254 × 1254。我們先複製文件,再把畫布擴為 2160 × 1620,錨點設為底部居中,擴展區域保持透明。

查詢到 image.canvasSize 後,傳給 command_run 的參數如下:

json
{
  "id": "image.canvasSize",
  "params": {
    "width": 2160,
    "height": 1620,
    "relative": false,
    "anchor": "bottom",
    "extensionColor": "transparent"
  }
}

同一顯示比例下的原始方形 PNG 與 PhotoCraft 擴展畫布,機器人上方增加了留白

原圖在新畫布中的位置為 x=453、y=366,原區域的 RGBA 像素保持一致,新增區域的 Alpha 全為零。圖中的灰色面板用於展示畫布範圍,沒有寫進 PNG。可以下載實際用於產生的圖片檢查。

我們同時儲存了 .pcraft 工程和 PNG。由於 PhotoCraft 已經準備好留白,本次沒有再開啟 AnimGen 的 Expand Canvas。

把 PNG 的實際內容上傳到 AnimGen

本地 PhotoCraft 檔案路徑不能直接當成遠端服務的輸入。客戶端先呼叫 prepare_image_upload,按返回的方法和請求頭傳輸檔案位元組,再呼叫 complete_image_upload。取得的 file_id 才用於產生請求。這次上傳完成後返回的檔案大小和 SHA-256 與 PhotoCraft 匯出檔案一致。

可以把下面這段英文任務說明交給同時連線了兩個 MCP 的助手。它是可複用的任務模板,不是逐條工具呼叫記錄:

text
Use PhotoCraft MCP to open my transparent robot PNG and duplicate it.
Expand the canvas to 2160 x 1620, bottom-centred, with transparent margins.
Save a new PNG without resizing the character.

Use AnimGen MCP to upload that PNG's actual bytes. Discover the available
models and quote a 4-second, 480p, 4:3 jump with automatic Alpha Key.
Show me the model and credit quote, and wait for approval before generation.

Keep the camera fixed and the whole robot in frame. Ask for a crouch,
an in-place jump and a landing. Save the task ID and wait for completion.
Reuse that source video for transparent exports; do not generate again
when selecting frames. Preserve 24 FPS and check the exported alpha.

上傳、報價和任務輪詢的詳細說明,可以繼續看 AnimGen MCP 實測教程。

批准一次產生,保留同一份來源影片

本次批准的設定為 Seedance 2.0 Fast、4 秒、480p、4:3 和自動 Alpha Key。產生實扣 36 點數,透明匯出的報價和實扣均為 0 點數,沒有再次產生動作。

項目 本次結果
返回影片 752 × 560、24 FPS、97 影格
實測時長 約 4.04 秒
動作 連續跳躍兩次,再恢復準備姿勢
最終產生扣費/退款 36/0 點數
匯出扣費 0 點數

雖然請求寫的是單次跳躍,模型實際做了兩次。第一段仍然可以選出來使用。這些費用對應本次實測,自己的模型和參數應重新獲取報價,具體見定價頁。

目前 FPS 匯出模式接受精靈圖及其 JSON 配套輸出。我們按 24 FPS 匯出這兩項,再根據完整影片的 97 影格另行匯出透明影片與 PNG 序列。兩組請求都複用同一影片資產,並設定了零點數上限。

用 PhotoCraft 清理兩張落地影格

檢查最初匯出的 97 影格序列時,在淺色和深色背景上能看到來源影格 48、49 的頭部附近有少量偏綠色殘影,時間在第一次落地附近。這種局部問題可以直接修整影格,不必重新產生影片。

我們在 PhotoCraft 中開啟受影響 PNG 的副本,通過 select.rect 和 edit.clear 清除殘色所在的小塊空白區域,再儲存 PNG。像素核對確認,選區之外的像素沒有變化,其餘 95 影格也與原版完全一致。

同一比例和深色背景下,來源影格 48 在 PhotoCraft MCP 清理前後的對比

這些對比圖由真實匯出影格排版而成,圖內標籤為英文,沒有仿造編輯器介面。清理保留了原畫布尺寸和地面陰影。如果殘色已經覆蓋角色本身,應先按照透明動畫邊緣處理指南檢查,不要直接刪掉角色像素。

保留一次跳躍,仍然按 24 FPS 播放

最終片段共 77 影格、24 FPS,約 3.21 秒,保留了下蹲、起跳、騰空、落地和起身。整理素材時使用完整 WebM 中的全部影格,沒有補影格,也沒有改變速度。

角色恢復準備姿勢後片段才結束,可以播放一次後切換到下一動作,沒有把它做成無縫迴圈。揮劍動作案例介紹了類似的單次動作播放,行走動畫教學則討論迴圈處理。

下面把同一段完整跳躍放在淺色和深色背景上,方便檢查輪廓:

左右兩邊都是同一段 77 影格、約 3.21 秒的完整跳躍,保持 24 FPS。淺色與深色背景僅用於預覽。

下載素材,在自己的專案裡檢查

檔案 內容
處理後的角色 PNG 實際用於產生的 2160 × 1620 PhotoCraft 輸出
透明跳躍 WebM 完整的 77 影格跳躍,752 × 560、24 FPS;VP9 壓縮後約 436 KB
PNG 序列 ZIP 77 張透明圖片,編號對應完整 WebM 內的第 0–76 影格
精靈圖與 JSON 相同的 77 影格,圖集 6016 × 5600,包含逐影格時長
素材記錄 尺寸、費用、清理選區和檔案雜湊

精靈圖保留了原始影格解析度,匯入前需要確認目標環境能接收 6016 像素寬的紋理。也可以下載 PNG 序列,按目標環境重新縮放和拼合。保留統一的逐影格畫布,才能保留角色真實的跳躍高度。

PhotoCraft MCP 常見問題

PhotoCraft MCP 負責產生 AI 動畫嗎?

本流程中,PhotoCraft 編輯輸入畫布和匯出像素;AnimGen 產生動作並提供初始透明匯出。客戶端協調兩個服務,並在它們之間傳遞檔案。

整個流程都是免費的嗎?

本地 PhotoCraft 編輯沒有消耗產生點數。本次 AnimGen 產生費用為 36 點數,匯出為 0 點數。MCP 客戶端使用的 AI 模型還可能有單獨費用。

能換成自己的角色嗎?

可以。使用真正帶 Alpha 的 PNG,在運動方向留出空間,再檢查下蹲、騰空最高點和落地姿勢。如果希望直接在瀏覽器中操作,可以從透明動畫製作工具開始,同樣按這些關鍵姿勢檢查結果。

查看圖片細節