Auto-rig mô hình 3D bằng code

Bắt đầu nhanh#

Từ đăng nhập tới mô hình đã rig trong ba bước. Bạn cần Node.js 18.17 trở lên.

1. 01

   Tạo key

   Đăng nhập vào tài khoản afk.ai bằng Google và tạo một key trong mục API key. Key bắt đầu bằng afk_ và chỉ hiển thị một lần; bạn có thể thu hồi nó ở đó bất cứ lúc nào. Đừng để key trong trang web hay ứng dụng mà người khác tải về.

2. 02

   Đặt key vào biến môi trường

   shellsao chép

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

3. 03

   Rig một mô hình

   clinode.jsclaude codemcp.jsonsao chép

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

   Việc rig chạy trên GPU của chúng tôi, thường mất 1 đến 2 phút; CLI và client sẽ chờ. Với một MCP client, hãy yêu cầu kiểu như “rig models/fox.glb dưới dạng động vật bốn chân”.

Từ một bức ảnh#

Chưa có mô hình 3D? Hãy gửi ảnh một nhân vật: một lệnh gọi sẽ tạo mô hình 3D có texture từ ảnh đó, rồi rig nó kèm mọi hoạt ảnh cho kiểu cơ thể, trong một file GLB, trong khoảng 2 đến 3 phút.

25¢ mỗi nhân vật, trừ vào credit của bạn: gồm mô hình 3D, rig và mọi hoạt ảnh; được hoàn lại nếu thất bại. Lượt rig miễn phí không áp dụng cho nhân vật. Trường billing của job hiển thị điều đó: held khi đang chạy, rồi charged hoặc refunded, và CLI in ra số tiền đã trừ và số credit còn lại.

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.

Ảnh rõ, đủ sáng của một nhân vật, nguyên vẹn, trên phông nền trơn cho kết quả tốt nhất. Texture của mô hình (màu, kim loại và độ nhám) được tạo cho khớp với bức ảnh, và request đầu tiên sau một thời gian không có hoạt động có thể mất tới 5 phút trong lúc GPU khởi động. Với một MCP client, hãy yêu cầu kiểu như “tạo nhân vật đã rig từ art/knight.png”. Xem thêm trong hướng dẫn API tạo nhân vật đã rig từ ảnh của chúng tôi.

Kiểu cơ thể#

Truyền một kiểu qua --type. afk.ai khớp bộ xương làm cho kiểu đó, gán skin weights và thêm mọi hoạt ảnh làm cho bộ xương đó: tổng cộng 933 trên tất cả các kiểu. afk-rig types <type> liệt kê hoạt ảnh của một kiểu.

human593 clip

Người, robot, zombie, mọi thứ đi bằng hai chân. Có cả ngón tay.

fox128 clip

Chó, mèo, cáo, sói

horse22 clip

Ngựa, hươu, bò

bird19 clip

Cánh và hai chân

dragon20 clip

Cánh và bốn chân

kaiju18 clip

Đứng thẳng, có đuôi

spider18 clip

Sáu hoặc tám chân, không có cánh

snake15 clip

Không chân, một cột sống dài

fish16 clip

Cá, cá mập, cá voi

CLI#

Chạy bằng npx afk-rig, hoặc cài đặt toàn cục bằng npm i -g afk-rig. Tiến trình được ghi ra stderr và đường dẫn file đã ghi ra stdout, nên dễ kết hợp trong script.

Tùy chọn

Mã thoát

Node.js#

Cùng package đó cũng là một client có kiểu (typed): import { AfkRig } from 'afk-rig'. new AfkRig() đọc AFK_API_KEY, hoặc truyền { apiKey }.

Từng bước một

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

Lỗi là các AfkRigError có HTTP status, một code trong bảng bên dưới và, khi bị giới hạn tốc độ, retryAfter tính bằng giây.

MCP server#

npx -y afk-rig mcp chạy nó dưới dạng MCP server trên stdio, để Claude Code, Cursor, Windsurf, Claude Desktop và các MCP client khác rig được các mô hình chúng tạo ra. Cung cấp AFK_API_KEY trong biến môi trường của nó.

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_..." }
    }
  }
}

Tool

Vòng đời rig#

Một lần rig là một job bất đồng bộ. Tải mô hình lên và bạn nhận ngay id của nó; job đi qua các trạng thái này, và CLI cùng client sẽ poll thay bạn.

billing.state là held khi một lần rig trả phí đang chạy, charged khi file đã sẵn sàng và refunded nếu thất bại, nên một lần rig thất bại không tốn gì. billing.charge cho biết cách thanh toán: free, rerig, credits hoặc character. Một nhân vật từ ảnh ở trạng thái generating (mô hình 3D của nó đang được tạo) trước khi được rig. Một job đã xong, như afk-rig status <id> --json in ra:

{
  "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"
  }
}

Lỗi#

Các request bị API từ chối trả về một HTTP status và một code; chúng không bị tính phí.

Khi một lần rig thất bại

Một job đã được nhận nhưng không rig được sẽ kết thúc với status: "failed" và một trong các mã sau trong error.code. Job đó không bị tính phí.

Giới hạn#

Bảng giá#

5¢ một lần rig, giá cố định. Một lần rig là toàn bộ đầu ra: bộ xương, skin weights và mọi hoạt ảnh cho kiểu cơ thể. Một nhân vật tạo từ ảnh có giá 25¢. Không tính phí theo hoạt ảnh và không thuê bao.

Chi phí một tháng

So sánh với các API rigging khác#

Giá trả theo mức dùng thấp nhất trong mọi API rigging chúng tôi tìm được. Giá API được công bố, với credit quy đổi ra đô la trên các gói thông thường của từng nhà cung cấp. Ludo.ai rẻ hơn cho một lần rig không kèm hoạt ảnh nếu bạn trả trước cả năm; một nhân vật hình người với mười hoạt ảnh ở đây rẻ hơn mọi API khác mà chúng tôi đã tính giá. Cách tính có trong bài so sánh giá API rigging tự động của chúng tôi.

Giá được kiểm tra vào tháng 10 năm 2026 từ trang của chính từng nhà cung cấp, chỉ gói thông thường (không tính ưu đãi cho người dùng mới): Ludo.ai, Meshy API, Các gói Meshy, Uthana, Tripo, Anything World, Mixamo FAQ. Giá có thể thay đổi; hãy kiểm tra trước khi quyết định.

Câu hỏi thường gặp#