用程式碼幫 3D 模型自動綁骨

快速入門#

從登入到拿到綁好骨骼的模型，只需三步。需要 Node.js 18.17 或更新版本。

1. 01

   建立金鑰

   用 Google 登入你的 afk.ai 帳號，在 API keys（API 金鑰）下建立一個。它以 afk_ 開頭，只會顯示一次；隨時可以在那裡撤銷。不要把它放進網頁或讓人下載的 App 裡。

2. 02

   放進環境變數

   shell複製

   export AFK_API_KEY=afk_...   # from afk.ai/account#api

3. 03

   幫模型綁骨

   clinode.jsclaude codemcp.json複製

   npx afk-rig knight.glb --type human -o knight.rigged.glb

   綁骨在我們的 GPU 上執行，通常需要 1 到 2 分鐘；CLI 和用戶端會等它完成。使用 MCP 用戶端時，可以這樣問：「把 models/fox.glb 當作四足動物綁骨」。

從圖片生成#

還沒有 3D 模型？那就送出一張角色圖片：一次呼叫會根據圖片生成帶貼圖的 3D 模型，然後為它綁骨並加上該體型的全部動畫，都在一個 GLB 裡，約需 2 到 3 分鐘。

每個角色從你的點數中扣 25¢：包含 3D 模型、綁骨和全部動畫；失敗則退款。免費綁骨不包含角色生成。任務的 billing 會顯示扣款狀態：執行時為 held，之後是 charged 或 refunded；CLI 會印出扣了多少以及剩餘的點數。

npx afk-rig character knight.png -o knight.glb
# Done in 135 s: 593 animations, 15.2 MB, charged $0.25 from your API credits. $4.75 of credits left.

最好是一張清晰、光線充足的圖片，只有一個完整的角色，背景單純。模型的貼圖（顏色、金屬度和粗糙度）會配合圖片生成；閒置一段時間後的第一個請求可能需要最多 5 分鐘，因為 GPU 需要啟動。使用 MCP 用戶端時，可以這樣問：「用 art/knight.png 生成一個綁好骨骼的角色」。更多內容請見我們的圖片轉綁骨角色 API 教學。

體型#

用 --type 傳入其中一種。afk.ai 會套用為它打造的骨架、計算蒙皮權重，並加上為該骨架製作的全部動畫：所有體型共 933 個。afk-rig types <type> 會列出某個體型的動畫。

human593 個片段

人、機器人、殭屍，任何用兩條腿站立的角色。含手指。

fox128 個片段

狗、貓、狐狸、狼

horse22 個片段

馬、鹿、牛

bird19 個片段

翅膀加兩條腿

dragon20 個片段

翅膀加四條腿

kaiju18 個片段

直立，帶尾巴

spider18 個片段

六條或八條腿，沒有翅膀

snake15 個片段

沒有腿，一條長長的脊椎

fish16 個片段

魚、鯊魚、鯨

CLI#

用 npx afk-rig 執行，或用 npm i -g afk-rig 全域安裝。進度輸出到 stderr，寫出的檔案路徑輸出到 stdout，方便在腳本中串接使用。

選項

結束代碼

Node.js#

同一個套件也是一個帶型別定義的用戶端：import { AfkRig } from 'afk-rig'。new AfkRig() 會讀取 AFK_API_KEY，也可以傳入 { apiKey }。

逐步操作

import { AfkRig } from 'afk-rig'

const afk = new AfkRig()

const started = await afk.startRig('fox.glb', { type: 'fox', facing: 'auto' })
// { id: 'rig_…', status: 'queued', billing: { charge: 'credits', state: 'held', … } }

const done = await afk.waitForRig(started.id, {
  onUpdate: (job) => console.log(job.status, job.stage), // rigging skeleton, rigging fit, …
})

const glb = await afk.downloadRig(done.id) // Uint8Array, for 24 hours

錯誤為 AfkRigError，包含 HTTP status、來自下表的 code，以及觸發速率限制時以秒為單位的 retryAfter。

MCP 伺服器#

npx -y afk-rig mcp 會在 stdio 上以 MCP 伺服器執行，這樣 Claude Code、Cursor、Windsurf、Claude Desktop 和其他 MCP 用戶端就能幫它們生成的模型綁骨。在它的環境變數中提供 AFK_API_KEY。

claude mcp add afk-rig -e AFK_API_KEY=afk_... -- npx -y afk-rig mcp

{
  "mcpServers": {
    "afk-rig": {
      "command": "npx",
      "args": ["-y", "afk-rig", "mcp"],
      "env": { "AFK_API_KEY": "afk_..." }
    }
  }
}

工具

綁骨生命週期#

綁骨是一個非同步任務。上傳模型後會立刻取得它的 id；它會依序經過以下狀態，CLI 和用戶端會替你輪詢。

付費綁骨執行時 billing.state 為 held，檔案就緒後為 charged，失敗則為 refunded，所以失敗的綁骨不花一毛錢。billing.charge 說明付費方式：free、rerig、credits 或 character。從圖片生成的角色在進入綁骨階段之前處於 generating（正在生成它的 3D 模型）。一個已完成的任務，用 afk-rig status <id> --json 印出來是這樣的：

{
  "id": "rig_Xq3v9KfL2mTz8RbA1cWd",
  "status": "succeeded",
  "stage": null,
  "type": "human",
  "file": "knight.glb",
  "animations": "all",
  "facing": null,
  "created_at": "2026-10-26T17:02:11Z",
  "finished_at": "2026-10-26T17:03:35Z",
  "billing": { "charge": "credits", "amount_usd": "0.05", "state": "charged" },
  "error": null,
  "result": {
    "download_url": "https://…/v1/rigs/rig_Xq3v9KfL2mTz8RbA1cWd/model.glb",
    "bytes": 7412032,
    "animations": 593,
    "expires_at": "2026-10-27T17:03:35Z"
  }
}

錯誤#

被 API 拒絕的請求會回傳 HTTP 狀態碼和一個 code；這些請求不收費。

綁骨失敗時

已被接受但無法綁骨的任務，最終會以 status: "failed" 結束，並在 error.code 中給出以下之一。不收費。

限制#

價格#

每次綁骨均一價 5¢。一次綁骨就是全部產出：骨架、蒙皮權重和該體型的全部動畫。從圖片生成角色為 25¢。不依動畫數量收費，也不用訂閱。

每月花費

與其他綁骨 API 比較#

我們找到的所有綁骨 API 中，依用量計費的價格最低。以下是公開的 API 價格，點數已依各家一般方案換算成美元。如果預付一年，Ludo.ai 的單純綁骨更便宜；而一個帶十個動畫的人形角色，在這裡比我們算過的任何其他 API 都便宜。計算過程見我們的自動綁骨 API 價格比較。

價格於 2026年10月 查核，來自各家自己的頁面，僅計一般方案（不含新使用者優惠）：Ludo.ai、Meshy API、Meshy 方案、Uthana、Tripo、Anything World、Mixamo FAQ。價格會變動，做決定前請先確認。

常見問題#