Automatyczny rigging modeli 3D z kodu

Szybki start#

Od logowania do modelu z rigiem w trzech krokach. Potrzebujesz Node.js 18.17 lub nowszego.

1. 01

   Utwórz klucz

   Zaloguj się na swoje konto afk.ai przez Google i utwórz klucz w sekcji API keys. Zaczyna się od afk_ i jest pokazywany tylko raz; możesz go tam w każdej chwili unieważnić. Nie umieszczaj go na stronach internetowych ani w aplikacjach, które ludzie pobierają.

2. 02

   Dodaj go do zmiennych środowiskowych

   shellkopiuj

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

3. 03

   Zrób rig modelu

   clinode.jsclaude codemcp.jsonkopiuj

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

   Rigi działają na naszych GPU, zwykle od 1 do 2 minut; CLI i klient na nie czekają. W kliencie MCP poproś na przykład: „zrób rig models/fox.glb jako czworonoga”.

Z obrazu#

Nie masz jeszcze modelu 3D? Wyślij zamiast tego obraz postaci: jedno wywołanie robi z niego teksturowany model 3D, a potem jego rig ze wszystkimi animacjami dla danego typu ciała, w jednym GLB, w około od 2 do 3 minut.

25¢ za postać z twoich kredytów: model 3D, rig i wszystkie animacje; zwrot, jeśli się nie uda. Darmowe rigi nie obejmują postaci. Pole billing zadania to pokazuje: held w trakcie działania, potem charged albo refunded, a CLI wypisuje pobraną kwotę i pozostałe kredyty.

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.

Najlepiej sprawdza się wyraźny, dobrze oświetlony obraz jednej, całej postaci na jednolitym tle. Tekstury modelu (kolor, metaliczność i chropowatość) są dopasowywane do obrazu, a pierwsze żądanie po dłuższej przerwie może potrwać do 5 minut, bo GPU musi wystartować. W kliencie MCP poproś na przykład: „zrób postać z rigiem z art/knight.png”. Więcej w poradniku o API zamieniającym obraz w postać z rigiem.

Typy ciała#

Podaj jeden jako --type. afk.ai dopasowuje szkielet stworzony dla niego, wykonuje skinning i dodaje wszystkie animacje stworzone dla tego szkieletu: łącznie 933 we wszystkich typach. afk-rig types <type> wyświetla animacje danego typu.

humanklipy: 593

Ludzie, roboty, zombie, wszystko na dwóch nogach. Z palcami.

foxklipy: 128

Psy, koty, lisy, wilki

horseklipy: 22

Konie, jelenie, krowy

birdklipy: 19

Skrzydła i dwie nogi

dragonklipy: 20

Skrzydła i cztery nogi

kaijuklipy: 18

Wyprostowane, z ogonem

spiderklipy: 18

Sześć lub osiem nóg, bez skrzydeł

snakeklipy: 15

Bez nóg, jeden długi kręgosłup

fishklipy: 16

Ryby, rekiny, wieloryby

CLI#

Uruchom je przez npx afk-rig albo zainstaluj globalnie przez npm i -g afk-rig. Postęp trafia na stderr, a ścieżka zapisanego pliku na stdout, więc łatwo łączyć je w skryptach.

Opcje

Kody wyjścia

Node.js#

Ten sam pakiet jest typowanym klientem: import { AfkRig } from 'afk-rig'. new AfkRig() odczytuje AFK_API_KEY, albo podaj { apiKey }.

Krok po kroku

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

Błędy to obiekty AfkRigError z HTTP status, code z tabeli poniżej i, przy przekroczeniu limitu, retryAfter w sekundach.

Serwer MCP#

npx -y afk-rig mcp uruchamia go jako serwer MCP na stdio, więc Claude Code, Cursor, Windsurf, Claude Desktop i inne klienty MCP mogą robić rigi modeli, które tworzą. Przekaż mu AFK_API_KEY w środowisku.

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

Narzędzia

Cykl życia rigu#

Rig to zadanie asynchroniczne. Po wgraniu modelu od razu dostajesz jego id; zadanie przechodzi przez poniższe statusy, a CLI i klient odpytują je za ciebie.

billing.state to held, gdy trwa płatny rig, charged, gdy plik jest gotowy, i refunded, jeśli się nie uda, więc nieudany rig nic nie kosztuje. billing.charge mówi, jak zapłacono: free, rerig, credits lub character. Postać z obrazu ma status generating (powstaje jej model 3D), zanim przejdzie do riggingu. Gotowe zadanie w postaci, w jakiej wypisuje je 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"
  }
}

Błędy#

Żądania odrzucone przez API wracają ze statusem HTTP i polem code; nic za nie nie pobieramy.

Gdy rig się nie uda

Zadanie, które zostało przyjęte, ale nie dało się zrobić jego rigu, kończy się status: "failed" i jednym z tych kodów w error.code. Nie jest rozliczane.

Limity#

Cennik#

5¢ za rig, stała cena. Rig to cały wynik: szkielet, wagi skinningu i wszystkie animacje dla danego typu ciała. Postać z obrazu kosztuje 25¢. Nie ma opłat za animację ani subskrypcji.

Ile kosztuje miesiąc

Porównanie z innymi API do riggingu#

Najniższa cena w modelu płatności za użycie spośród wszystkich API do riggingu, jakie znaleźliśmy. Opublikowane ceny API, z kredytami przeliczonymi na dolary w zwykłych planach każdego dostawcy. Ludo.ai jest tańsze za sam rig, jeśli zapłacisz za rok z góry; humanoid z dziesięcioma animacjami kosztuje tu mniej niż w każdym innym sprawdzonym przez nas API. Wyliczenia są w naszym porównaniu cen API do automatycznego riggingu.

Ceny sprawdzone na stronach dostawców (stan na październik 2026), tylko zwykłe plany, bez ofert dla nowych użytkowników: Ludo.ai, API Meshy, Plany Meshy, Uthana, Tripo, Anything World, FAQ Mixamo. Zmieniają się; sprawdź przed decyzją.

FAQ#