Riggez automatiquement des modèles 3D par code

Démarrage rapide#

De la connexion au modèle riggé en trois étapes. Il vous faut Node.js 18.17 ou plus récent.

1. 01

   Créez une clé

   Connectez-vous à votre compte afk.ai avec Google et créez-en une dans la section API keys. Elle commence par afk_ et ne s'affiche qu'une fois ; vous pouvez la révoquer au même endroit à tout moment. Ne la mettez pas dans des pages web ni dans des applications que d'autres téléchargent.

2. 02

   Ajoutez-la à votre environnement

   shellcopier

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

3. 03

   Riggez un modèle

   clinode.jsclaude codemcp.jsoncopier

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

   Les rigs tournent sur nos GPU, en général en 1 à 2 minutes ; la CLI et le client les attendent. Avec un client MCP, demandez par exemple « rigge models/fox.glb comme un animal à quatre pattes ».

À partir d'une image#

Pas encore de modèle 3D ? Envoyez plutôt l'image d'un personnage : un seul appel en crée un modèle 3D texturé, puis le rigge avec toutes les animations de son type de corps, dans un seul GLB, en 2 à 3 minutes environ.

25¢ par personnage, débités de vos crédits : le modèle 3D, le rig et toutes les animations ; remboursé en cas d'échec. Les rigs gratuits ne couvrent pas les personnages. Le champ billing du job l'indique : held pendant l'exécution, puis charged ou refunded, et la CLI affiche le montant débité et les crédits qu'il vous reste.

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.

Une image nette et bien éclairée d'un seul personnage, entier, sur un fond uni donne les meilleurs résultats. Les textures du modèle (couleur, métal et rugosité) sont créées pour correspondre à l'image, et une première requête après une période calme peut prendre jusqu'à 5 minutes, le temps que le GPU démarre. Avec un client MCP, demandez par exemple « crée un personnage riggé à partir de art/knight.png ». Plus d'infos dans notre guide API image vers personnage riggé.

Types de corps#

Passez-en un avec --type. afk.ai ajuste un squelette conçu pour lui, calcule les poids de skinning et ajoute toutes les animations faites pour ce squelette : 933 tous types confondus. afk-rig types <type> liste les animations d'un type.

human593 clips

Humains, robots, zombies, tout ce qui marche sur deux jambes. Doigts compris.

fox128 clips

Chiens, chats, renards, loups

horse22 clips

Chevaux, cerfs, vaches

bird19 clips

Ailes et deux pattes

dragon20 clips

Ailes et quatre pattes

kaiju18 clips

Debout, avec une queue

spider18 clips

Six ou huit pattes, sans ailes

snake15 clips

Pas de pattes, une longue colonne

fish16 clips

Poissons, requins, baleines

CLI#

Lancez-la avec npx afk-rig, ou installez-la globalement avec npm i -g afk-rig. La progression s'affiche sur stderr et le chemin du fichier écrit sur stdout : elle s'intègre donc facilement dans des scripts.

Options

Codes de sortie

Node.js#

Le même package est un client typé : import { AfkRig } from 'afk-rig'. new AfkRig() lit AFK_API_KEY, ou passez { apiKey }.

Étape par étape

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

Les erreurs sont des AfkRigError avec le status HTTP, un code du tableau ci-dessous et, en cas de limitation de débit, retryAfter en secondes.

Serveur MCP#

npx -y afk-rig mcp le lance comme serveur MCP sur stdio : Claude Code, Cursor, Windsurf, Claude Desktop et les autres clients MCP peuvent ainsi rigger les modèles qu'ils créent. Fournissez-lui AFK_API_KEY dans son environnement.

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

Outils

Cycle de vie d'un rig#

Un rig est un job asynchrone. Importez le modèle et vous obtenez aussitôt son id ; il passe par ces statuts, et la CLI et le client l'interrogent pour vous.

billing.state vaut held pendant l'exécution d'un rig payant, charged une fois le fichier prêt et refunded en cas d'échec : un rig échoué ne coûte donc rien. billing.charge indique comment il a été payé : free, rerig, credits ou character. Un personnage créé à partir d'une image est en generating (son modèle 3D en cours de création) avant le rigging. Un job terminé, tel que afk-rig status <id> --json l'affiche :

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

Erreurs#

Les requêtes refusées par l'API reviennent avec un statut HTTP et un code ; elles ne sont pas facturées.

Quand un rig échoue

Un job accepté mais impossible à rigger se termine avec status: "failed" et l'un de ces codes dans error.code. Il n'est pas facturé.

Limites#

Tarifs#

5¢ le rig, prix fixe. Un rig, c'est tout le résultat : squelette, poids de skinning et toutes les animations du type de corps. Un personnage créé à partir d'une image coûte 25¢. Aucun frais par animation, et pas d'abonnement.

Ce que coûte un mois

Comparé aux autres API de rigging#

Le prix à l'usage le plus bas de toutes les API de rigging que nous avons trouvées. Prix d'API publiés, avec les crédits convertis en dollars sur les offres habituelles de chaque fournisseur. Ludo.ai est moins cher pour un rig seul si vous payez un an d'avance ; un humanoïde avec dix animations coûte moins cher ici que via toute autre API que nous avons chiffrée. Les calculs sont dans notre comparatif des tarifs d'API d'auto-rigging.

Prix vérifiés en octobre 2026 sur les pages de chaque fournisseur, offres habituelles uniquement (offres de bienvenue exclues) : Ludo.ai, API Meshy, Offres Meshy, Uthana, Tripo, Anything World, FAQ Mixamo. Ils évoluent ; vérifiez avant de décider.

FAQ#