코드로 3D 모델 자동 리깅

빠른 시작#

로그인부터 리깅된 모델까지 세 단계. Node.js 18.17 이상이 필요합니다.

1. 01

   키 만들기

   Google로 afk.ai 계정에 로그인해 API 키 항목에서 키를 만드세요. 키는 afk_로 시작하며 한 번만 표시되고, 언제든 그곳에서 폐기할 수 있습니다. 웹 페이지나 사람들이 다운로드하는 앱에는 넣지 마세요.

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 모델을 만들고, 체형에 맞는 모든 애니메이션과 함께 리깅해 약 2~3분 만에 GLB 하나로 돌려줍니다.

캐릭터 1개당 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.

캐릭터 하나의 전신이 단색 배경 위에 선명하고 밝게 나온 그림이 가장 좋습니다. 모델의 텍스처(색상, 메탈, 러프니스)는 그림에 맞게 만들어지며, 한동안 요청이 없다가 들어온 첫 요청은 GPU가 시작되는 동안 최대 5분이 걸릴 수 있습니다. MCP 클라이언트에서는 “art/knight.png로 리깅된 캐릭터를 만들어 줘”처럼 요청하세요. 자세한 내용은 이미지→리깅 캐릭터 API 가이드를 참고하세요.

체형#

--type으로 하나를 넘기세요. afk.ai가 그 체형용으로 만든 스켈레톤을 맞추고, 스킨 웨이트를 입히고, 그 스켈레톤용으로 만든 모든 애니메이션을 추가합니다. 전체 체형을 합쳐 933개입니다. afk-rig types <type>로 한 체형의 애니메이션 목록을 볼 수 있습니다.

human클립 593개

사람, 로봇, 좀비 등 두 발로 서는 모든 것. 손가락 포함.

fox클립 128개

개, 고양이, 여우, 늑대

horse클립 22개

말, 사슴, 소

bird클립 19개

날개와 두 다리

dragon클립 20개

날개와 네 다리

kaiju클립 18개

직립, 꼬리 있음

spider클립 18개

다리 6개 또는 8개, 날개 없음

snake클립 15개

다리 없이 길게 이어진 척추 하나

fish클립 16개

물고기, 상어, 고래

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

오류는 HTTP status, 아래 표의 code, 그리고 속도 제한에 걸렸을 때는 초 단위의 retryAfter를 가진 AfkRigError입니다.

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 가격을 기준으로, 각 서비스의 일반 플랜에서 크레딧을 달러로 환산했습니다. 1년을 선결제하면 기본 리깅만은 Ludo.ai가 더 저렴하지만, 애니메이션 10개를 갖춘 휴머노이드는 저희가 가격을 조사한 어떤 API보다 여기가 저렴합니다. 계산 과정은 자동 리깅 API 가격 비교에 있습니다.

가격은 2026년 10월에 각 서비스의 공식 페이지에서 일반 플랜 기준으로 확인했습니다(신규 사용자 혜택 제외): Ludo.ai, Meshy API, Meshy 플랜, Uthana, Tripo, Anything World, Mixamo FAQ. 가격은 바뀔 수 있으니 결정하기 전에 확인하세요.

자주 묻는 질문#