コードから 3D モデルを自動リギング

クイックスタート#

ログインからリギング済みモデルまで 3 ステップ。Node.js 18.17 以降が必要です。

1. 01

   キーを作成

   Google で afk.ai アカウントにログイン し、API keys の欄でキーを作成します。キーは afk_ で始まり、表示されるのは一度だけです。そこでいつでも無効化できます。Web ページや配布するアプリには含めないでください。

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 モデルがない？代わりにキャラクターの画像を送ってください。1 回の呼び出しで画像からテクスチャ付きの 3D モデルを作り、そのボディタイプの全アニメーション付きでリギングして、1 つの GLB にします。所要時間は約 2〜3 分です。

キャラクター 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.

背景が無地で、キャラクター 1 体の全身がはっきり明るく写った画像が最適です。モデルのテクスチャ（色、メタル、ラフネス）は画像に合わせて作られます。しばらく利用がなかった後の最初のリクエストは、GPU の起動のため最大 5 分かかることがあります。MCP クライアントなら「art/knight.png からリギング済みキャラクターを作って」のように頼んでください。詳しくは 画像からリギング済みキャラクターを作る API のガイドをご覧ください。

ボディタイプ#

--type に 1 つ指定します。afk.ai はそのタイプ用に作られたスケルトンをフィットさせてスキンウェイトを付け、そのスケルトン用に作られた全アニメーション（全タイプで計 933）を追加します。afk-rig types <type> で、タイプごとのアニメーションを一覧表示できます。

human593 クリップ

人間、ロボット、ゾンビなど、二足歩行のもの。指付き。

fox128 クリップ

犬、猫、キツネ、オオカミ

horse22 クリップ

馬、シカ、牛

bird19 クリップ

翼と 2 本の脚

dragon20 クリップ

翼と 4 本の脚

kaiju18 クリップ

直立し、尻尾がある

spider18 クリップ

6 本または 8 本の脚、羽なし

snake15 クリップ

脚がなく、1 本の長い背骨

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 } を渡してください。

1 ステップずつ

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 に次のいずれかが入ります。費用はかかりません。

制限#

料金#

1 リグ 5¢、一律です。1 リグには出力のすべて（スケルトン、スキンウェイト、そのボディタイプの全アニメーション）が含まれます。画像から作るキャラクターは 25¢ です。アニメーションごとの料金やサブスクリプションはありません。

1 か月の料金の目安

ほかのリギング API との比較#

調べた中で、従量課金のリギング API としては最安です。公開されている API 料金を、各社の通常プランでクレジットからドルに換算して比較しました。1 年分を前払いするなら、アニメーションなしのリグ単体では Ludo.ai のほうが安くなります。アニメーション 10 本付きの人型なら、調べたどの API よりもここが安くなります。計算の詳細は 自動リギング API の料金比較 をご覧ください。

料金は 2026年10月 に各社の公式ページで確認したもので、通常プランのみです（新規ユーザー向け特典は除外）：Ludo.ai、Meshy API、Meshy のプラン、Uthana、Tripo、Anything World、Mixamo FAQ。料金は変わるので、決める前にご確認ください。

よくある質問#