3D-modellen automatisch riggen vanuit code

Snelstart#

Van inloggen tot een gerigd model in drie stappen. Je hebt Node.js 18.17 of nieuwer nodig.

1. 01

   Maak een sleutel aan

   Log in op je afk.ai-account met Google en maak er een aan onder API keys. Hij begint met afk_ en wordt één keer getoond; je kunt hem daar altijd intrekken. Zet hem niet in webpagina's of apps die mensen downloaden.

2. 02

   Zet hem in je omgeving

   shellkopiëren

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

3. 03

   Rig een model

   clinode.jsclaude codemcp.jsonkopiëren

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

   Rigs draaien op onze GPU's, meestal in 1 tot 2 minuten; de CLI en de client wachten erop. Vraag met een MCP-client bijvoorbeeld “rig models/fox.glb als viervoeter”.

Vanuit een afbeelding#

Nog geen 3D-model? Stuur dan een afbeelding van een personage: één call maakt er een getextureerd 3D-model van en rigt het met elke animatie voor zijn lichaamstype, in één GLB, in ongeveer 2 tot 3 minuten.

25¢ per personage van je credits: het 3D-model, de rig en elke animatie; je krijgt het terug als het mislukt. Gratis rigs gelden niet voor personages. De billing van de job laat het zien: held terwijl hij loopt, daarna charged of refunded, en de CLI toont wat er is afgeschreven en hoeveel credits je nog hebt.

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.

Een duidelijke, goed belichte afbeelding van één heel personage op een effen achtergrond werkt het best. De textures van het model (kleur, metaal en ruwheid) worden afgestemd op de afbeelding, en een eerste request na een rustige periode kan tot 5 minuten duren terwijl de GPU opstart. Vraag met een MCP-client bijvoorbeeld “maak een gerigd personage van art/knight.png”. Meer in onze handleiding over de API van afbeelding naar gerigd personage.

Lichaamstypes#

Geef er een mee als --type. afk.ai plaatst een skelet dat ervoor gemaakt is, berekent de skin weights en voegt elke animatie toe die voor dat skelet gemaakt is: 933 over alle types. afk-rig types <type> toont de animaties van een type.

human593 clips

Mensen, robots, zombies, alles op twee benen. Inclusief vingers.

fox128 clips

Honden, katten, vossen, wolven

horse22 clips

Paarden, herten, koeien

bird19 clips

Vleugels en twee poten

dragon20 clips

Vleugels en vier poten

kaiju18 clips

Rechtop, met een staart

spider18 clips

Zes of acht poten, geen vleugels

snake15 clips

Geen poten, één lange wervelkolom

fish16 clips

Vissen, haaien, walvissen

CLI#

Voer hem uit met npx afk-rig, of installeer hem globaal met npm i -g afk-rig. De voortgang gaat naar stderr en het pad van het weggeschreven bestand naar stdout, dus hij past goed in scripts.

Opties

Exitcodes

Node.js#

Hetzelfde pakket is ook een getypeerde client: import { AfkRig } from 'afk-rig'. new AfkRig() leest AFK_API_KEY, of geef { apiKey } mee.

Stap voor stap

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

Fouten zijn AfkRigErrors met de HTTP-status, een code uit de tabel hieronder en, bij rate limiting, retryAfter in seconden.

MCP-server#

npx -y afk-rig mcp draait hem als MCP-server op stdio, zodat Claude Code, Cursor, Windsurf, Claude Desktop en andere MCP-clients de modellen kunnen riggen die ze maken. Geef hem AFK_API_KEY mee in zijn omgeving.

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

Tools

Levenscyclus van een rig#

Een rig is een asynchrone job. Upload het model en je krijgt meteen het id; de job doorloopt deze statussen, en de CLI en de client pollen hem voor je.

billing.state is held terwijl een betaalde rig loopt, charged zodra het bestand klaar is en refunded als hij mislukt, dus een mislukte rig kost niets. billing.charge zegt hoe er betaald is: free, rerig, credits of character. Een personage vanuit een afbeelding is eerst generating (het 3D-model wordt gemaakt) voordat het wordt gerigd. Een afgeronde job, zoals afk-rig status <id> --json hem print:

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

Fouten#

Requests die de API weigert, komen terug met een HTTP-status en een code; er wordt niets voor afgeschreven.

Als een rig mislukt

Een job die is geaccepteerd maar niet gerigd kon worden, eindigt met status: "failed" en een van deze in error.code. Er wordt niets afgeschreven.

Limieten#

Prijzen#

5¢ per rig, vast. Een rig is de hele output: skelet, skin weights en elke animatie voor het lichaamstype. Een personage vanuit een afbeelding kost 25¢. Er zijn geen kosten per animatie en er is geen abonnement.

Wat een maand kost

Vergeleken met andere rigging-API's#

De laagste prijs bij betalen naar gebruik van alle rigging-API's die we vonden. Gepubliceerde API-prijzen, met credits omgerekend naar dollars over de reguliere abonnementen van elke aanbieder. Ludo.ai is goedkoper voor een kale rig als je een jaar vooruitbetaalt; een humanoïde met tien animaties kost hier minder dan via elke andere API die we hebben bekeken. De berekening staat in onze vergelijking van prijzen van auto-rigging-API's.

Prijzen gecontroleerd in oktober 2026 op de eigen pagina's van elke aanbieder, alleen reguliere abonnementen (aanbiedingen voor nieuwe gebruikers weggelaten): Ludo.ai, Meshy-API, Abonnementen van Meshy, Uthana, Tripo, Anything World, Mixamo-FAQ. Ze veranderen; controleer ze voordat je beslist.

Veelgestelde vragen#