Rigging automatico di modelli 3D da codice

Guida rapida#

Dall'accesso a un modello riggato in tre passaggi. Serve Node.js 18.17 o successivo.

1. 01

   Crea una chiave

   Accedi al tuo account afk.ai con Google e creane una nella sezione API keys. Inizia con afk_ e viene mostrata una sola volta; puoi revocarla lì in qualsiasi momento. Non inserirla in pagine web o in app che le persone scaricano.

2. 02

   Mettila nel tuo ambiente

   shellcopia

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

3. 03

   Rigga un modello

   clinode.jsclaude codemcp.jsoncopia

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

   I rig girano sulle nostre GPU, di solito in 1-2 minuti; la CLI e il client li aspettano. Con un client MCP, chiedi qualcosa come “rigga models/fox.glb come animale a quattro zampe”.

Da un'immagine#

Non hai ancora un modello 3D? Invia invece l'immagine di un personaggio: una chiamata ne ricava un modello 3D texturizzato, poi lo rigga con tutte le animazioni per il suo tipo di corpo, in un unico GLB, in circa 2-3 minuti.

25¢ a personaggio dai tuoi crediti: il modello 3D, il rig e tutte le animazioni; rimborsato se non va a buon fine. I rig gratuiti non coprono i personaggi. Il campo billing del job lo mostra: held mentre è in corso, poi charged o refunded, e la CLI stampa quanto ha addebitato e i crediti che ti restano.

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.

Funziona meglio un'immagine nitida e ben illuminata di un solo personaggio, intero, su uno sfondo uniforme. Le texture del modello (colore, metallo e rugosità) vengono create in base all'immagine, e una prima richiesta dopo un periodo di inattività può richiedere fino a 5 minuti mentre si avvia la GPU. Con un client MCP, chiedi qualcosa come “crea un personaggio riggato da art/knight.png”. Trovi altro nella nostra guida all'API da immagine a personaggio riggato.

Tipi di corpo#

Passane uno come --type. afk.ai adatta uno scheletro fatto per quel tipo, calcola i pesi di skinning e aggiunge tutte le animazioni create per quello scheletro: 933 in tutto. afk-rig types <type> elenca le animazioni di un tipo.

human593 clip

Persone, robot, zombie, qualsiasi cosa su due gambe. Dita incluse.

fox128 clip

Cani, gatti, volpi, lupi

horse22 clip

Cavalli, cervi, mucche

bird19 clip

Ali e due zampe

dragon20 clip

Ali e quattro zampe

kaiju18 clip

In posizione eretta, con la coda

spider18 clip

Sei o otto zampe, senza ali

snake15 clip

Senza zampe, un'unica lunga colonna

fish16 clip

Pesci, squali, balene

CLI#

Eseguila con npx afk-rig, oppure installala globalmente con npm i -g afk-rig. L'avanzamento va su stderr e il percorso del file scritto su stdout, quindi si integra negli script.

Opzioni

Codici di uscita

Node.js#

Lo stesso pacchetto è un client tipizzato: import { AfkRig } from 'afk-rig'. new AfkRig() legge AFK_API_KEY, oppure passa { apiKey }.

Un passaggio alla volta

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

Gli errori sono AfkRigError con lo status HTTP, un code dalla tabella qui sotto e, in caso di limite di frequenza, retryAfter in secondi.

Server MCP#

npx -y afk-rig mcp lo avvia come server MCP su stdio, così Claude Code, Cursor, Windsurf, Claude Desktop e altri client MCP possono riggare i modelli che creano. Passagli AFK_API_KEY nel suo ambiente.

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

Strumenti

Ciclo di vita del rig#

Un rig è un job asincrono. Carichi il modello e ricevi subito il suo id; passa attraverso questi stati, e la CLI e il client lo interrogano al posto tuo.

billing.state è held mentre un rig a pagamento è in corso, charged quando il file è pronto e refunded se fallisce, quindi un rig fallito non costa nulla. billing.charge indica come è stato pagato: free, rerig, credits o character. Un personaggio da un'immagine è generating (si sta creando il suo modello 3D) prima del rigging. Un job completato, come lo stampa 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"
  }
}

Errori#

Le richieste che l'API rifiuta tornano con uno status HTTP e un code; non vengono addebitate.

Quando un rig fallisce

Un job accettato ma che non è stato possibile riggare termina con status: "failed" e uno di questi valori in error.code. Non viene addebitato.

Limiti#

Prezzi#

5¢ a rig, prezzo fisso. Un rig è l'intero output: scheletro, pesi di skinning e tutte le animazioni per il tipo di corpo. Un personaggio creato da un'immagine costa 25¢. Non ci sono costi per animazione né abbonamenti.

Quanto costa un mese

Confronto con altre API di rigging#

Il prezzo a consumo più basso tra tutte le API di rigging che abbiamo trovato. Prezzi API pubblicati, con i crediti convertiti in dollari sui piani normali di ciascun fornitore. Ludo.ai costa meno per un rig semplice se paghi un anno in anticipo; un umanoide con dieci animazioni costa meno qui che con qualsiasi altra API di cui abbiamo verificato i prezzi. I calcoli sono nel nostro confronto dei prezzi delle API di rigging automatico.

Prezzi verificati a ottobre 2026 sulle pagine di ciascun fornitore, solo piani normali (offerte per nuovi utenti escluse): Ludo.ai, API di Meshy, Piani di Meshy, Uthana, Tripo, Anything World, FAQ di Mixamo. Cambiano; controlla prima di decidere.

Domande frequenti#