3D-Modelle per Code automatisch riggen

Schnellstart#

Von der Anmeldung zum geriggten Modell in drei Schritten. Sie brauchen Node.js 18.17 oder neuer.

1. 01

   Schlüssel erstellen

   Melden Sie sich mit Google bei Ihrem afk.ai-Konto an und erstellen Sie unter „API-Schlüssel“ einen Schlüssel. Er beginnt mit afk_ und wird nur einmal angezeigt; Sie können ihn dort jederzeit widerrufen. Halten Sie ihn aus Webseiten und Apps heraus, die andere herunterladen.

2. 02

   In Ihre Umgebung eintragen

   shellkopieren

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

3. 03

   Ein Modell riggen

   clinode.jsclaude codemcp.jsonkopieren

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

   Rigs laufen auf unseren GPUs, meist in 1 bis 2 Minuten; CLI und Client warten darauf. Mit einem MCP-Client fragen Sie etwa: „rigge models/fox.glb als Vierbeiner“.

Aus einem Bild#

Noch kein 3D-Modell? Senden Sie stattdessen ein Bild eines Charakters: Ein Aufruf erstellt daraus ein texturiertes 3D-Modell und riggt es dann mit allen Animationen für seinen Körpertyp, in einer GLB-Datei, in etwa 2 bis 3 Minuten.

25¢ pro Charakter aus Ihren Credits: 3D-Modell, Rig und alle Animationen; bei einem Fehlschlag erstattet. Kostenlose Rigs gelten nicht für Charaktere. Das Feld billing des Jobs zeigt es an: held, solange er läuft, dann charged oder refunded, und die CLI gibt aus, was abgebucht wurde und wie viele Credits Ihnen bleiben.

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.

Am besten funktioniert ein klares, gut beleuchtetes Bild eines einzelnen, vollständigen Charakters vor einem schlichten Hintergrund. Die Texturen des Modells (Farbe, Metall und Rauheit) werden passend zum Bild erstellt, und eine erste Anfrage nach einer ruhigen Phase kann bis zu 5 Minuten dauern, während die GPU startet. Mit einem MCP-Client fragen Sie etwa: „mach aus art/knight.png einen geriggten Charakter“. Mehr in unserem Guide zur Bild-zu-Rig-Charakter-API.

Körpertypen#

Übergeben Sie einen als --type. afk.ai passt ein dafür gemachtes Skelett an, berechnet die Skin Weights und fügt alle Animationen für dieses Skelett hinzu: 933 über alle Typen. afk-rig types <type> listet die Animationen eines Typs auf.

human593 Clips

Menschen, Roboter, Zombies, alles auf zwei Beinen. Mit Fingern.

fox128 Clips

Hunde, Katzen, Füchse, Wölfe

horse22 Clips

Pferde, Hirsche, Kühe

bird19 Clips

Flügel und zwei Beine

dragon20 Clips

Flügel und vier Beine

kaiju18 Clips

Aufrecht, mit Schwanz

spider18 Clips

Sechs oder acht Beine, keine Flügel

snake15 Clips

Keine Beine, eine lange Wirbelsäule

fish16 Clips

Fische, Haie, Wale

CLI#

Starten Sie sie mit npx afk-rig oder installieren Sie sie global mit npm i -g afk-rig. Der Fortschritt geht an stderr und der Pfad der geschriebenen Datei an stdout, sie lässt sich also in Skripten kombinieren.

Optionen

Exit-Codes

Node.js#

Dasselbe Paket ist ein typisierter Client: import { AfkRig } from 'afk-rig'. new AfkRig() liest AFK_API_KEY, oder Sie übergeben { apiKey }.

Schritt für Schritt

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

Fehler sind AfkRigError-Objekte mit dem HTTP-status, einem code aus der Tabelle unten und bei Rate-Limiting retryAfter in Sekunden.

MCP-Server#

npx -y afk-rig mcp startet ihn als MCP-Server über stdio, sodass Claude Code, Cursor, Windsurf, Claude Desktop und andere MCP-Clients die Modelle riggen können, die sie erstellen. Geben Sie ihm AFK_API_KEY in seiner Umgebung mit.

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

Rig-Lebenszyklus#

Ein Rig ist ein asynchroner Job. Laden Sie das Modell hoch, und Sie bekommen sofort seine ID; der Job durchläuft diese Status, und CLI und Client fragen ihn für Sie ab.

billing.state ist held, solange ein bezahltes Rig läuft, charged, sobald die Datei fertig ist, und refunded, wenn es fehlschlägt; ein fehlgeschlagenes Rig kostet also nichts. billing.charge gibt an, wie bezahlt wurde: free, rerig, credits oder character. Ein Charakter aus einem Bild ist generating (sein 3D-Modell wird erstellt), bevor er geriggt wird. Ein fertiger Job, wie afk-rig status <id> --json ihn ausgibt:

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

Fehler#

Anfragen, die die API ablehnt, kommen mit einem HTTP-Status und einem code zurück; dafür wird nichts berechnet.

Wenn ein Rig fehlschlägt

Ein Job, der angenommen wurde, aber nicht geriggt werden konnte, endet mit status: "failed" und einem dieser Werte in error.code. Er wird nicht berechnet.

Limits#

Preise#

5¢ pro Rig, pauschal. Ein Rig ist die gesamte Ausgabe: Skelett, Skin Weights und alle Animationen für den Körpertyp. Ein Charakter aus einem Bild kostet 25¢. Es gibt keine Kosten pro Animation und kein Abo.

Was ein Monat kostet

Im Vergleich mit anderen Rigging-APIs#

Der niedrigste Pay-as-you-go-Preis aller Rigging-APIs, die wir gefunden haben. Veröffentlichte API-Preise, mit Credits in Dollar umgerechnet über die regulären Tarife jedes Anbieters. Ludo.ai ist für ein reines Rig günstiger, wenn Sie ein Jahr im Voraus zahlen; ein Humanoid mit zehn Animationen kostet hier weniger als über jede andere API, die wir verglichen haben. Die Rechnung steht in unserem Preisvergleich für Auto-Rigging-APIs.

Preise geprüft im Oktober 2026 auf den eigenen Seiten jedes Anbieters, nur reguläre Tarife (ohne Neukundenangebote): Ludo.ai, Meshy-API, Meshy-Tarife, Uthana, Tripo, Anything World, Mixamo-FAQ. Sie ändern sich; prüfen Sie sie, bevor Sie sich entscheiden.

FAQ#