3D modelleri koddan otomatik rigle

Hızlı başlangıç#

Girişten riglenmiş modele üç adımda. Node.js 18.17 veya daha yenisi gerekir.

1. 01

   Bir anahtar oluştur

   Google ile afk.ai hesabına giriş yap ve API anahtarları bölümünden bir anahtar oluştur. afk_ ile başlar ve yalnızca bir kez gösterilir; istediğin zaman oradan iptal edebilirsin. Web sayfalarından ve insanların indirdiği uygulamalardan uzak tut.

2. 02

   Ortam değişkenine ekle

   shellkopyala

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

3. 03

   Bir model rigle

   clinode.jsclaude codemcp.jsonkopyala

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

   Rigler GPU'larımızda çalışır, genellikle 1 ila 2 dakikada; CLI ve istemci onları bekler. Bir MCP istemcisiyle “models/fox.glb dosyasını dört ayaklı hayvan olarak rigle” gibi bir şey iste.

Resimden#

Henüz 3D modelin yok mu? Bunun yerine bir karakter resmi gönder: tek çağrı ondan dokulu bir 3D model yapar, sonra vücut tipine ait tüm animasyonlarla rigler; tek bir GLB'de, yaklaşık 2 ila 3 dakikada.

Karakter başına 25¢, kredilerinden: 3D model, rig ve tüm animasyonlar; başarısız olursa iade edilir. Ücretsiz rigler karakterleri kapsamaz. İşin billing alanı bunu gösterir: çalışırken held, sonra charged veya refunded; CLI de ne kadar tahsil ettiğini ve kalan kredilerini yazdırır.

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.

Düz bir arka planda tek bir karakterin tamamını gösteren net, iyi aydınlatılmış bir resim en iyi sonucu verir. Modelin dokuları (renk, metal ve pürüzlülük) resme uyacak şekilde yapılır; sessiz bir dönemden sonraki ilk istek GPU başlarken 5 dakikaya kadar sürebilir. Bir MCP istemcisiyle “art/knight.png dosyasından riglenmiş bir karakter yap” gibi bir şey iste. Daha fazlası görselden riglenmiş karakter API'si rehberimizde.

Vücut tipleri#

Birini --type olarak ver. afk.ai o tip için yapılmış bir iskelet oturtur, skin ağırlıklarını hesaplar ve o iskelet için yapılmış tüm animasyonları ekler: tüm tiplerde toplam 933. afk-rig types <type> bir tipin animasyonlarını listeler.

human593 klip

İnsanlar, robotlar, zombiler, iki ayaklı her şey. Parmaklar dahil.

fox128 klip

Köpekler, kediler, tilkiler, kurtlar

horse22 klip

Atlar, geyikler, inekler

bird19 klip

Kanatlar ve iki bacak

dragon20 klip

Kanatlar ve dört bacak

kaiju18 klip

Dik duran, kuyruklu

spider18 klip

Altı veya sekiz bacak, kanatsız

snake15 klip

Bacaksız, tek uzun omurga

fish16 klip

Balıklar, köpekbalıkları, balinalar

CLI#

npx afk-rig ile çalıştır ya da npm i -g afk-rig ile global olarak kur. İlerleme stderr'e, yazılan dosyanın yolu stdout'a gider; böylece betiklerde rahatça birleştirilebilir.

Seçenekler

Çıkış kodları

Node.js#

Aynı paket tipli bir istemcidir: import { AfkRig } from 'afk-rig'. new AfkRig(), AFK_API_KEY değerini okur ya da { apiKey } ver.

Adım adım

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

Hatalar; HTTP status değeri, aşağıdaki tablodan bir code ve hız sınırına takıldığında saniye cinsinden retryAfter içeren AfkRigError nesneleridir.

MCP sunucusu#

npx -y afk-rig mcp onu stdio üzerinde bir MCP sunucusu olarak çalıştırır; böylece Claude Code, Cursor, Windsurf, Claude Desktop ve diğer MCP istemcileri yaptıkları modelleri rigleyebilir. Ortamına AFK_API_KEY ver.

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

Araçlar

Rig yaşam döngüsü#

Bir rig asenkron bir iştir. Modeli yükle, kimliğini hemen al; iş bu durumlardan geçer, CLI ve istemci de onu senin için yoklar.

billing.state, ücretli bir rig çalışırken held, dosya hazır olunca charged, başarısız olursa refunded olur; yani başarısız bir rig hiçbir şeye mal olmaz. billing.charge nasıl ödendiğini söyler: free, rerig, credits veya character. Resimden bir karakter, riglemeden önce generating durumundadır (3D modeli yapılırken). afk-rig status <id> --json komutunun yazdırdığı haliyle bitmiş bir iş:

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

Hatalar#

API'nin reddettiği istekler bir HTTP durum kodu ve bir code ile döner; bunlar için ücret alınmaz.

Bir rig başarısız olduğunda

Kabul edilen ama riglenemeyen bir iş status: "failed" ve error.code içinde bunlardan biriyle biter. Ücret alınmaz.

Limitler#

Fiyatlar#

Rig başına sabit 5¢. Bir rig çıktının tamamıdır: iskelet, skin ağırlıkları ve vücut tipine ait tüm animasyonlar. Resimden yapılan bir karakter 25¢. Animasyon başına ücret ve abonelik yok.

Bir ay ne kadar tutar

Diğer rigleme API'leriyle karşılaştırma#

Bulduğumuz rigleme API'leri arasında en düşük kullandıkça öde fiyatı. Yayınlanmış API fiyatları; krediler her sağlayıcının normal planlarında dolara çevrildi. Yıllık peşin ödersen yalın bir rig için Ludo.ai daha ucuz; on animasyonlu bir insansı ise burada, fiyatladığımız diğer tüm API'lerden daha az tutar. Hesaplar otomatik rig API fiyat karşılaştırmamızda.

Fiyatlar Ekim 2026 itibarıyla her sağlayıcının kendi sayfalarından, yalnızca normal planlar üzerinden kontrol edildi (yeni kullanıcı teklifleri hariç): Ludo.ai, Meshy API, Meshy planları, Uthana, Tripo, Anything World, Mixamo SSS. Değişebilirler; karar vermeden önce kontrol et.

SSS#