Auto-rig model 3D lewat kode

Mulai cepat#

Dari masuk hingga model yang sudah di-rig dalam tiga langkah. Anda butuh Node.js 18.17 atau yang lebih baru.

1. 01

   Buat key

   Masuk ke akun afk.ai Anda dengan Google dan buat key di bagian API key. Key diawali dengan afk_ dan hanya ditampilkan sekali; Anda bisa mencabutnya di sana kapan saja. Jangan taruh key di halaman web atau aplikasi yang diunduh orang lain.

2. 02

   Simpan di environment Anda

   shellsalin

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

3. 03

   Rig model

   clinode.jsclaude codemcp.jsonsalin

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

   Rig berjalan di GPU kami, biasanya dalam 1 sampai 2 menit; CLI dan klien menunggunya untuk Anda. Dengan klien MCP, minta sesuatu seperti “rig models/fox.glb sebagai hewan berkaki empat”.

Dari gambar#

Belum punya model 3D? Kirim gambar karakter saja: satu panggilan membuat model 3D bertekstur darinya, lalu me-rig-nya dengan semua animasi untuk tipe tubuhnya, dalam satu GLB, dalam sekitar 2 sampai 3 menit.

25¢ per karakter dari kredit Anda: model 3D, rig, dan semua animasinya; dikembalikan jika gagal. Rig gratis tidak berlaku untuk karakter. billing pada job menunjukkannya: held selama berjalan, lalu charged atau refunded, dan CLI mencetak berapa yang ditagih serta sisa kredit Anda.

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.

Gambar yang jelas dan terang dari satu karakter, utuh, di latar polos memberi hasil terbaik. Tekstur model (warna, metal, dan roughness) dibuat agar sesuai dengan gambarnya, dan request pertama setelah lama tidak ada aktivitas bisa memakan waktu hingga 5 menit sementara GPU dinyalakan. Dengan klien MCP, minta sesuatu seperti “buat karakter yang sudah di-rig dari art/knight.png”. Selengkapnya di panduan API gambar ke karakter ber-rig kami.

Tipe tubuh#

Berikan salah satunya sebagai --type. afk.ai memasang kerangka yang dibuat untuk tipe itu, menghitung skin weights, dan menambahkan semua animasi yang dibuat untuk kerangka itu: 933 untuk semua tipe. afk-rig types <type> menampilkan animasi suatu tipe.

human593 klip

Manusia, robot, zombi, apa pun yang berkaki dua. Termasuk jari.

fox128 klip

Anjing, kucing, rubah, serigala

horse22 klip

Kuda, rusa, sapi

bird19 klip

Sayap dan dua kaki

dragon20 klip

Sayap dan empat kaki

kaiju18 klip

Tegak, berekor

spider18 klip

Enam atau delapan kaki, tanpa sayap

snake15 klip

Tanpa kaki, satu tulang belakang panjang

fish16 klip

Ikan, hiu, paus

CLI#

Jalankan dengan npx afk-rig, atau instal secara global dengan npm i -g afk-rig. Progres dikirim ke stderr dan path file yang ditulis ke stdout, jadi mudah dipakai dalam skrip.

Opsi

Kode keluar

Node.js#

Paket yang sama juga merupakan klien bertipe: import { AfkRig } from 'afk-rig'. new AfkRig() membaca AFK_API_KEY, atau berikan { apiKey }.

Selangkah demi selangkah

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

Error berupa AfkRigError dengan status HTTP, code dari tabel di bawah, dan, saat terkena rate limit, retryAfter dalam detik.

Server MCP#

npx -y afk-rig mcp menjalankannya sebagai server MCP di stdio, sehingga Claude Code, Cursor, Windsurf, Claude Desktop, dan klien MCP lainnya bisa me-rig model yang mereka buat. Berikan AFK_API_KEY di environment-nya.

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

Tool

Siklus rig#

Rig adalah job asinkron. Unggah model dan Anda langsung mendapat id-nya; job melewati status-status ini, dan CLI serta klien melakukan polling untuk Anda.

billing.state bernilai held selama rig berbayar berjalan, charged setelah file siap, dan refunded jika gagal, jadi rig yang gagal tidak dikenai biaya. billing.charge menunjukkan cara pembayarannya: free, rerig, credits, atau character. Karakter dari gambar berstatus generating (model 3D-nya sedang dibuat) sebelum masuk rigging. Job yang sudah selesai, seperti yang dicetak 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"
  }
}

Error#

Request yang ditolak API dikembalikan dengan status HTTP dan code; tidak ada biaya yang dikenakan.

Saat rig gagal

Job yang sudah diterima tetapi tidak bisa di-rig berakhir dengan status: "failed" dan salah satu kode berikut di error.code. Job ini tidak dikenai biaya.

Batasan#

Harga#

5¢ per rig, flat. Satu rig adalah seluruh output: kerangka, skin weights, dan semua animasi untuk tipe tubuhnya. Karakter yang dibuat dari gambar seharga 25¢. Tanpa biaya per animasi dan tanpa langganan.

Biaya per bulan

Dibandingkan dengan API rigging lain#

Harga pay-as-you-go terendah dari semua API rigging yang kami temukan. Harga API yang dipublikasikan, dengan kredit dikonversi ke dolar di seluruh paket reguler setiap penyedia. Ludo.ai lebih murah untuk rig saja jika Anda membayar setahun di muka; humanoid dengan sepuluh animasi lebih murah di sini daripada lewat API lain mana pun yang kami hitung. Perhitungannya ada di perbandingan harga API auto-rigging kami.

Harga dicek pada Oktober 2026 dari halaman masing-masing penyedia, hanya paket reguler (penawaran pengguna baru tidak dihitung): Ludo.ai, API Meshy, Paket Meshy, Uthana, Tripo, Anything World, FAQ Mixamo. Harga bisa berubah; cek sebelum Anda memutuskan.

FAQ#