Rig automático de modelos 3D por código

Início rápido#

Do login a um modelo riggado em três passos. Você precisa do Node.js 18.17 ou mais recente.

1. 01

   Crie uma chave

   Entre na sua conta do afk.ai com o Google e crie uma na seção API keys. Ela começa com afk_ e é mostrada uma única vez; revogue-a lá quando quiser. Não a coloque em páginas web nem em apps que as pessoas baixam.

2. 02

   Coloque-a no seu ambiente

   shellcopiar

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

3. 03

   Faça o rig de um modelo

   clinode.jsclaude codemcp.jsoncopiar

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

   Os rigs rodam nas nossas GPUs, normalmente em 1 a 2 minutos; a CLI e o cliente esperam por eles. Com um cliente MCP, peça algo como “faça o rig de models/fox.glb como um animal de quatro patas”.

A partir de uma imagem#

Ainda não tem um modelo 3D? Envie uma imagem de um personagem: uma chamada cria um modelo 3D texturizado a partir dela e depois faz o rig com todas as animações do tipo de corpo, em um único GLB, em cerca de 2 a 3 minutos.

25¢ por personagem dos seus créditos: o modelo 3D, o rig e todas as animações; reembolsado se falhar. Os rigs grátis não cobrem personagens. O billing do job mostra isso: held enquanto roda, depois charged ou refunded, e a CLI mostra o valor cobrado e os créditos que restam.

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.

Uma imagem nítida e bem iluminada de um personagem, inteiro, sobre um fundo liso funciona melhor. As texturas do modelo (cor, metal e rugosidade) são feitas para combinar com a imagem, e o primeiro pedido depois de um período parado pode levar até 5 minutos enquanto a GPU inicia. Com um cliente MCP, peça algo como “crie um personagem riggado a partir de art/knight.png”. Mais no nosso guia da API de imagem para personagem riggado.

Tipos de corpo#

Passe um deles em --type. O afk.ai encaixa um esqueleto feito para ele, calcula os pesos de skin e adiciona todas as animações feitas para esse esqueleto: 933 somando todos os tipos. afk-rig types <type> lista as animações de um tipo.

human593 clipes

Pessoas, robôs, zumbis, qualquer coisa com duas pernas. Com dedos.

fox128 clipes

Cachorros, gatos, raposas, lobos

horse22 clipes

Cavalos, cervos, vacas

bird19 clipes

Asas e duas patas

dragon20 clipes

Asas e quatro patas

kaiju18 clipes

Em pé, com cauda

spider18 clipes

Seis ou oito patas, sem asas

snake15 clipes

Sem pernas, uma única coluna comprida

fish16 clipes

Peixes, tubarões, baleias

CLI#

Rode com npx afk-rig ou instale globalmente com npm i -g afk-rig. O progresso vai para o stderr e o caminho do arquivo gravado para o stdout, então dá para usar em scripts.

Opções

Códigos de saída

Node.js#

O mesmo pacote é um cliente tipado: import { AfkRig } from 'afk-rig'. new AfkRig() lê AFK_API_KEY, ou passe { apiKey }.

Um passo de cada vez

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

Os erros são AfkRigErrors com o status HTTP, um code da tabela abaixo e, quando há limite de taxa, retryAfter em segundos.

Servidor MCP#

npx -y afk-rig mcp roda como servidor MCP em stdio, para que Claude Code, Cursor, Windsurf, Claude Desktop e outros clientes MCP possam fazer o rig dos modelos que criam. Passe AFK_API_KEY no ambiente dele.

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

Ferramentas

Ciclo de vida do rig#

Um rig é um job assíncrono. Envie o modelo e você recebe o id dele na hora; ele passa por estes status, e a CLI e o cliente fazem a consulta por você.

billing.state é held enquanto um rig pago roda, charged quando o arquivo fica pronto e refunded se falhar, então um rig que falha não custa nada. billing.charge diz como foi pago: free, rerig, credits ou character. Um personagem a partir de uma imagem fica em generating (com o modelo 3D sendo criado) antes de passar ao rig. Um job pronto, como afk-rig status <id> --json o mostra:

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

Erros#

Pedidos que a API recusa voltam com um status HTTP e um code; nada é cobrado por eles.

Quando um rig falha

Um job que foi aceito mas não pôde ser riggado termina com status: "failed" e um destes em error.code. Ele não é cobrado.

Limites#

Preços#

5¢ por rig, preço fixo. Um rig é o resultado inteiro: esqueleto, pesos de skin e todas as animações do tipo de corpo. Um personagem criado a partir de uma imagem custa 25¢. Não há cobrança por animação nem assinatura.

Quanto custa um mês

Comparado com outras APIs de rigging#

O menor preço com pagamento por uso entre as APIs de rigging que encontramos. Preços de API publicados, com créditos convertidos em dólares nos planos normais de cada provedor. O Ludo.ai é mais barato para um rig sem animações se você pagar um ano adiantado; um humanoide com dez animações custa menos aqui do que em qualquer outra API que pesquisamos. As contas estão na nossa comparação de preços de APIs de rig automático.

Preços verificados em outubro de 2026 nas páginas de cada provedor, só planos normais (ofertas para novos usuários ficam de fora): Ludo.ai, Meshy API, Planos do Meshy, Uthana, Tripo, Anything World, FAQ do Mixamo. Eles mudam; confira antes de decidir.

Perguntas frequentes#