afk.ai rigleme API'si ile neler yapabilirsin
Bir 3D model gönder, vücut tipine ait tüm animasyonlarla (insansı için 594) riglenmiş bir GLB al. İnsanlar, hayvanlar, ejderhalar ve zıplayan eşyalar, koddan.
Güncelleme: 4 Kasım 2026
afk.ai API'si bir 3D modeli (GLB, glTF veya FBX) ve vücut tipini alır, iskeleti, skin ağırlıkları ve o vücut için tüm animasyonlarıyla tek bir GLB döndürür. afk.ai/rig'deki yapay zekâ rig motorunun aynısı; terminalinden, kodundan ya da bir yapay zekâ ajanından kullanılır.
$ export AFK_API_KEY=afk_...$ npx afk-rig knight.glb --type humanUploading knight.glb…Rigging: studying the shapeRigging: placing the jointsRigging: painting skin weightsRigging: adding the animationsWriting the .glb with its animationsDone in 64 s: 593 animations, 28.7 MB.~/game/knight.rigged.glbDosyada neler var

Mesh
23.293 vertex, 6 materyal ve 14 doku, yüklendiği gibi

İskelet
66 kemik, her parmak dahil; her insansıda aynı adlar

Skin ağırlıkları
Vertex başına en fazla 4 kemik; burada her kemik bir renk

593 animasyon
Vücut tipine ait her animasyon; burada 0,7 sn'de Sword_Attack
knight.rigged.glb dosyasının içi, afk-rig render ile çizildi: bir yapay zekâ ajanının render_rig aracından aldığı resimlerin aynısı.Standart bir GLB'dir, bu yüzden three.js, Babylon.js, Blender, Unity (glTFast ile), Unreal 5.1+ ve Godot'da hiçbir şey dönüştürmeden açılır. Bir vücut tipindeki her model aynı kemik ve animasyon adlarını alır, böylece tek bir animasyon kontrolcüsü hepsini yönetir.
14 vücut tipi
Çoğu otomatik rig aracı yalnızca insansıları rigler. afk.ai'de bunların her biri için bir iskelet ve bir animasyon seti var, toplamda 800'ün üzerinde. Listesini görmek için birini seç:
$ npx afk-rig types humanhuman (insanlar, robotlar, iki ayaklı her şey): 593 animasyonAngry 0.8sAttack_Ground_Pound 2.7sBackflip 2.5sBow 3.8sBow Pull Back 1.3sBow Pull Hold 0.3sBow Release 0.5sCheer_One_arm 2.2sCheering_Two_Hands 1.6sChest_Open 1.4sChop_Tree 1.0sClimb Ladder 3.6sClimb Wall 2.1sClimbUp_1m_RM 0.7sConfused 2.9sConsume 1.3sConsume Item 4.2sCrawl 1.7sCrawl RM 1.7sCrouch_Idle 3.7sCrouch_Walk 2.5sDance Charleston 2.3sDance_Simple 1.3sDeath_A 4.5sDeath_B 1.9sDeath_C 2.2sDeath_D 2.2sDefend 1.0sDodge_back 1.0sDodge_back_RM 1.0sDodge_left 0.8sDodge_left_RM 0.8sDodge_right 0.8sDodge_right_RM 0.8sDriving 2.1sFarm_Harvest 2.3sFarm_PlantSeed 2.8sFarm_Watering 3.8sFighting Idle 1.7sFighting Left Jab 0.9sFighting Right Jab 0.9sFishing_Cast 3.0sFishing_Catch 2.0sFishing_Reel 1.4sFixing_Kneeling 6.5sFlying Forward 0.5sFlying Forward Super 0.5sGolf_Drive 3.1sGolf_idle 1.8sGreeting 4.8sHead Nod 0.9sHelp_One_Arm 2.7sHelp_Two_Arms 1.6sHit_Chest 0.4sHit_Head 0.5sHit_Knockback 0.8sHit_Knockback_RM 0.6sIdle Hurt 1.7sIdle Listening 1.7sIdle_A 3.1sIdle_FoldArms 2.5sIdle_Lantern 2.5sIdle_Rail 2.5sIdle_Rail_Call 2.5sIdle_ShakeOff 2.5sIdle_Shield 2.5sIdle_Shield_Break 1.1sIdle_Subtle 2.6sIdle_Sword 2.1sIdle_Talking 3.7sIdle_TalkingPhone 2.9sIdle_Torch 1.6sInsult 2.8sInteract 2.5sJog 1.2sJump_2 1.6sJump_2_RM 1.6sJump_air 3.1sJump_Land 1.6sJump_Start 1.7sJumping Jacks 1.3sKick_Breach 1.8sKneeling Tired 0.8sLadder_Idle 2.5sLand_Three_Point 1.4sLayToIdle 1.5sLedge Hang 1.9sLevitate Entrance 2.0sLevitate Idle 2.0sMeditate 1.5sMelee_Hook 0.5sMelee_Hook_Rec 0.6sNinjaJump_Idle 2.0sNinjaJump_Land 1.3sNinjaJump_Start 1.0sOverhandThrow 1.3sPickUp_Table 1.0sPipe Climb 1.9sPistol_Aim_Down 0.2sPistol_Aim_Neutral 0.2sPistol_Aim_Up 0.2sPistol_Idle 2.1sPistol_Reload 2.1sPistol_Shoot 0.8sPower Up 0.8sPunch_Cross 1.3sPunch_Jab 1.1sPush 3.3sPushup 1.5sReject 3.8sRest Pose 0.4sRoll 1.8sRoll_RM 1.8sRun Jump 1.3sRun_Anime 0.8sRun_Female 0.8sRun_Stealth 0.5sSalute 4.4sShield_Dash_RM 1.1sShield_OneShot 0.8sShivering 0.3sSitting_Enter 1.6sSitting_Exit 1.3sSitting_Idle 2.1sSitting_Talking 3.7sSleeping 1.7sSlide 2.0sSlide_Exit 0.5sSlide_Start 0.8sSpell_Simple_Enter 0.7sSpell_Simple_Exit 0.5sSpell_Simple_Idle 2.7sSpell_Simple_Shoot 0.6sSprint 0.8sStrafe_left 1.0sStrafe_right 1.0sSwim_Fwd 1.7sSwim_Idle 4.2sSword_Attack 1.9sSword_Attack_Air_Vertical 4.8sSword_Attack_RM 1.9sSword_Block 1.3sSword_Dash_RM 1.6sSword_Regular_A 0.5sSword_Regular_A_Rec 1.0sSword_Regular_B 0.5sSword_Regular_B_Rec 1.0sSword_Regular_C 1.7sSword_Regular_C_RM 1.7sSword_Regular_Combo 3.0sThrow Object 1.9sTired Hunched 1.0sTurn_Left_180 2.1sTurn_Left_90 2.0sTurn_Right_180 1.5sTurn_Right_90 2.0sTwo-hand Blast 0.5sVictory 1.7sVictory Fist Pump 2.3sWalk 1.7sWalk_2 1.1sWalk_Backwards 1.0sWalk_Backwards_2 1.0sWalk_Carry 2.0sWalk_Carry_2 1.1sWalk_Female 1.4sWalk_Female_2 1.0sWalk_Formal 1.7sWalk_Formal_2 1.1sWalk_Large 1.4sWalk_Large_2 1.3sWalk_Stealth 1.6sYes 2.5sZombie Yell 3.7sZombie_Rise 3.4sZombie_Scratch 1.8sClap 0.8sCry 2.0sDance_Groove 2.0sFacepalm 3.0sLaugh 1.6sPoint 2.0sShrug 1.5sThumbs_Up 1.8sDance_Shuffle 4.0sHard_Landing 2.6sIdle_Lean_Wall 5.0sKick 1.4sSitting_Ground_Idle 5.0sVault 2.2sWalk_Limp 1.5sWalk_Limp_2 1.5sWall_Run 0.7sAir_Squat 1.7sAngry_Gesture 2.3sAsk_Question 2.8sAxe_Backhand 2.2sAxe_Battlecry 3.9sAxe_Block 1.8sAxe_Block_Hit 1.8sAxe_Chest_Thump 3.0sAxe_Combo 3.6sAxe_Combo_2 3.2sAxe_Downward 2.5sAxe_Horizontal 2.4sAxe_Jump_Attack 3.2sAxe_Spin 2.8sAxe_Spin_Low 2.3sBack_Away_Fear 2.1sBackward_Jump 2.2sBaseball_Pitch 2.9sBaseball_Swing 3.3sBasketball_Dribble 2.1sBelly_Dance 6.0sBicep_Curl 2.7sBig_Jump 3.1sBlock_Body 2.2sBlock_Center 1.3sBlock_Inward 1.1sBlow_Kiss 2.8sBody_Wave 4.3sBow_Aim_Idle 3.3sBow_Casual 1.5sBow_Draw 2.1sBow_Equip 2.8sBow_Formal 2.4sBow_Recoil 1.5sBow_Strafe_Left 1.1sBow_Strafe_Right 1.1sBow_Walk 1.2sBow_Walk_Back 1.3sBreakdance_Footwork 2.4sBreakdance_Freeze 4.2sBreakdance_Uprock 4.0sBurpee 3.2sCan_Can 2.9sCapoeira_Armada 1.9sCapoeira_Ginga 2.1sCar_Enter 4.7sCar_Exit 4.5sCartwheel 2.0sCatwalk 1.3sChicken 6.4sClimb_Down_Wall 1.9sClub_Combo 4.1sCocky 3.2sCover_Idle 5.5sCover_Sneak_Left 1.3sCover_Sneak_Right 1.3sCover_To_Stand 1.7sCrouch_Run 0.7sCrouch_Strafe_Left 1.5sCrouch_Strafe_Right 1.5sCrouch_To_Stand 0.9sCrouch_Walk_Back 1.3sDagger_Double_Stab 2.5sDeath_Backward 3.3sDeath_Crouching 2.5sDeath_Explosion 2.7sDeath_Flying_Back 2.4sDeath_Forward 2.9sDeath_Headshot 3.7sDeath_Left 2.8sDeath_Prone 2.8sDeath_Right 3.1sDeath_To_Knees 4.5sDefeated 5.7sDig 3.3sDisappointed 3.5sDismiss 1.9sDive_Roll 2.4sDodge_Boxing 2.3sDoor_Open_In 5.1sDoor_Open_Out 3.1sDrink 3.7sDrop_Kick 3.7sDrunk_Walk 3.7sDual_Weapon_Combo 3.9sDuck 2.1sDwarf_Walk 0.9sElbow 1.8sElectrocuted 5.0sEvade 0.8sExcited 3.7sFall_Land_Idle 1.5sFall_Land_Run 1.2sFall_Loop 1.0sFall_Over 3.1sFight_Idle_Bounce 1.3sFireball 2.8sFist_Pump 2.1sFlair 1.3sFlex 3.9sFloat 2.4sFlying_Kick 3.2sFlying_Knee_Combo 2.8sFootball_Pass 3.2sFree_Hang_Climb 2.9sFront_Flip 3.0sGS_Block 2.0sGS_Combo 4.3sGS_Death 3.1sGS_Downward 2.3sGS_Draw 1.5sGS_Hit 1.5sGS_Idle 3.2sGS_Jump_Attack 3.1sGS_Power_Slash 4.1sGS_Run 0.7sGS_Sheath 1.9sGS_Spin 2.9sGS_Strafe 1.3sGS_Walk 1.3sGaming 6.0sGangnam 7.5sGet_Up_From_Back 3.7sGet_Up_From_Stomach 3.6sGoalie_Save 2.9sGolf_Putt 2.5sGrab_And_Slam 3.5sGrenade_Run_Throw 2.0sGrenade_Toss 2.5sGuitar 3.2sHang_Drop 2.1sHang_Hop_Left 1.9sHang_Hop_Right 1.9sHang_Hop_Up 1.9sHang_Idle 4.0sHang_Shimmy 1.2sHappy 4.0sHappy_Walk 0.9sHead_Shake 1.9sHeadbutt 1.9sHeadspin 2.0sHeavy_Swing 3.2sHero_Landing 2.7sHigh_Kick 2.0sHit_Gut 2.3sHit_Head_Hook 1.9sHit_Head_Punch 1.9sHit_Large_Back 2.0sHit_Large_Front 1.9sHit_Large_Left 1.9sHit_Large_Right 1.9sHit_Legs 3.2sHit_Small_Back 1.1sHit_Small_Front 1.0sHit_Small_Left 1.0sHit_Small_Right 1.0sHokey_Pokey 8.0sHook_Lead 1.5sHouse 3.9sHurricane_Kick 2.3sIdle_Bored 7.5sIdle_Defeated 6.0sIdle_Dizzy 5.0sIdle_Drunk 8.0sIdle_Happy 4.0sIdle_Injured 7.0sIdle_Neutral 7.0sIdle_Sad 6.0sIdle_Victory 4.0sInjured_Run 0.9sInjured_Walk 1.9sJab_Cross 1.9sJog_Backward 1.7sJog_Diagonal_Left 0.8sJog_Diagonal_Right 0.8sJump_Over 2.7sJump_Rope 0.9sJump_To_Hang 2.6sKO_Punch 2.9sKip_Up 2.1sKnee 1.9sKneel_Down 2.3sKneel_Idle 6.0sKneel_Inspect 5.7sKnife_Idle 4.0sKnife_Stab 1.7sKnocked_Down 3.1sKnocked_Out 2.9sLeg_Sweep 2.1sLie_Down 3.7sLie_Idle 8.0sLift_Object 4.6sLocking 7.5sLook_Around 6.5sLook_Around_Nervous 5.5sLook_Back_Run 1.3sLow_Crawl 2.2sLow_Kick 1.5sMMA_Idle 4.0sMacarena 8.0sMagic_1H_Attack 2.1sMagic_1H_Attack_2 2.2sMagic_1H_Cast 2.0sMagic_2H_Attack 2.0sMagic_2H_Attack_2 2.4sMagic_2H_Cast 3.2sMagic_Area 2.6sMagic_Area_2 2.7sMagic_Heal 2.8sMoonwalk 1.9sMutant_Jump_Attack 3.7sMutant_Roar 3.2sMutant_Run 1.0sMutant_Swipe 2.2sMutant_Walk 1.8sNinja_Idle 5.7sNo 2.8sOld_Man_Walk 2.1sOrc_Walk 1.3sPeek_And_Aim 3.2sPet_Animal 5.0sPick_Up_Floor 2.8sPistol_Draw 1.7sPistol_Hit 1.3sPistol_Holster 2.4sPistol_Jump 1.6sPistol_Kneel_Idle 2.5sPistol_Run 0.7sPistol_Run_Back 0.8sPistol_Strafe 1.0sPistol_Walk 1.1sPlank 3.0sPray 5.3sPress_Button 2.8sProne_Crawl 1.8sProne_Roll 2.8sPull_Heavy 4.3sPull_Lever 3.7sPull_Rope 2.4sPull_Up_Ledge 3.3sPunch_Combo 2.8sPunching_Bag 3.7sPut_Down 3.7sQuad_Punch 2.1sQuick_Turn_180 1.4sRaise_Hand 3.0sRaise_Roof 4.0sReach_Out 3.2sRifle_Aim_Idle 3.0sRifle_Butt 1.9sRifle_Crouch_Walk 1.5sRifle_Death 3.6sRifle_Fire 1.5sRifle_Fire_Crouch 1.5sRifle_Fire_Run 0.7sRifle_Fire_Walk 1.2sRifle_Hit 1.5sRifle_Idle 4.0sRifle_Jump 1.5sRifle_Kneel_Idle 2.5sRifle_Kneel_To_Stand 1.3sRifle_Prone_Fire 1.1sRifle_Prone_Idle 3.0sRifle_Pull_Out 2.3sRifle_Put_Away 2.3sRifle_Reload 3.1sRifle_Run 0.7sRifle_Run_Aimed 0.7sRifle_Run_Back 0.8sRifle_Stand_To_Kneel 1.1sRifle_Strafe_Left 1.0sRifle_Strafe_Right 1.0sRifle_Turn 1.2sRifle_Walk 1.2sRoar 3.7sRobot 8.0sRope_Climb 1.6sRope_Swing 2.7sRoundhouse 2.5sRun 0.7sRun_Arc_Left 0.7sRun_Arc_Right 0.7sRun_Backward 1.3sRun_Slide 2.0sRun_Start 1.1sRun_Stop 1.5sRun_Strafe_Left 0.7sRun_Strafe_Right 0.7sRun_Turn_180 1.2sRunning_Flip 2.0sRunning_Man 4.0sSS_Block 0.6sSS_Block_Idle 1.6sSS_Combo 3.6sSS_Death 3.3sSS_Hilt_Bash 1.9sSS_Hit 1.1sSS_Jump_Attack 2.5sSS_Kick 1.7sSS_Power_Slash 2.1sSS_Run 0.7sSS_Strafe 1.2sSS_Walk 1.1sSad_Walk 1.7sSalsa 5.3sSamba 3.2sSearch_Pockets 5.2sShade_Eyes 4.4sShake_Fist 2.4sShotgun_Fire 2.3sShoulder_Throw 4.1sShoved 2.9sSide_Kick 2.1sSignal_Follow 2.5sSilly_Run 1.5sSit_Bench_Legs 4.0sSit_Cheer 6.4sSit_Clap 5.0sSit_Cross_Legged 8.0sSit_Floor_Reclined 8.0sSit_Impatient 7.5sSit_To_Stand 2.4sSitups 2.0sSkateboard 1.9sSlide_Step 4.3sSlip 3.3sSmash 2.1sSneak_Walk 2.1sSoccer_Header 1.8sSoccer_Kick 2.1sSoccer_Tackle 2.9sSpell_Wide 3.2sSpin_Back_Kick 2.4sSpin_Flip_Kick 3.7sSprint_Roll 2.0sSprint_Start 1.1sSprint_Turn 1.1sStairs_Down 1.1sStairs_Run_Up 0.6sStairs_Up 1.2sStand_To_Cover 1.4sStand_To_Crouch 1.0sStand_To_Sit 2.4sStealth_Kill 5.1sStomp 1.9sStretch_Arms 6.7sStretch_Neck 6.0sStrut_Walk 1.1sStumble_Back 2.8sStumble_Jog 2.9sSurprised 3.1sSwagger_Walk 1.5sSwim_To_Edge 4.8sSwim_Underwater 4.0sSwing 3.0sSword_Combo 4.2sSword_Draw 1.5sSword_Duel 6.2sSword_Inward 1.5sSword_Outward 1.7sSword_Run 0.7sSword_Sheath 2.5sSword_Thrust 2.7sTablet 6.0sTake_Item 4.6sTalk 5.7sTaunt_Boxing 2.1sTerrified 4.0sText_Phone 6.0sText_Walk 2.4sThankful 3.2sThriller 8.0sThrow_Generic 1.9sTired_Run 2.0sTread_Water 4.0sTrip 3.3sTyping 6.7sUppercut 1.6sVault_One_Hand 1.9sVault_Two_Hand 1.9sWalk_Arc_Left 1.1sWalk_Arc_Right 1.1sWalk_Start 1.7sWalk_Stop 2.0sWall_Jump 2.2sWarm_Up 4.8sWave 3.9sWave_Dance 4.0sWhatever 1.7sWipe_Sweat 2.8sYMCA 8.0sYawn 4.6sYell 3.7sZombie_Attack 2.6sZombie_Bite 3.7sZombie_Crawl 3.2sZombie_Death 3.2sZombie_Idle 5.7sZombie_Run 0.9sZombie_Walk 2.5sSadece hareket etmeyen, bükülen eşyalar
object tipi herhangi bir eşyanın içine 21 eklemli bir iskelet oturtur: bir omurga ve onu enine kesen üç sıra kemik. Böylece bir sandık yere düşünce ezilir, bir tabela da öylece kaymak yerine rüzgârda bükülür. afk.ai/rig üzerinde bir modelin yalnızca bir parçasını da rigleyebilirsin, örneğin bir direkteki bayrağı. Daha fazlası 3D nesneleri canlandırma rehberinde.
- Bounce
- Flag_Wave
- Float
- Pop_In
- Shake
- Spin
- Squash_Stretch
- Sway
- Wobble
- Death
- Fall_Over
- Hit
- Hop_Walk
- Look_Around
- Nod_Yes
- Shake_No
- Sleep
- Startle
Bir yapay zekâ ajanından kontrol et ve düzelt
afk-rig aynı zamanda Claude Code, Cursor ve diğer ajanlar için bir MCP sunucusudur. rig_model ve image_to_character dışında bilgisayarında çalışan araçları da var: inspect_rig yere gömülen ayakları, yırtılan skin'i ve gövdenin içinden geçen kolları bulur, render_rig o anı çizer, adjust_animation, fix_stretching ve fix_spot ise sorunu yeni bir dosyada düzeltir.
> Şövalyenin Walk animasyonunu kontrol et ve yanlış olan her şeyi düzelt
● inspect_rig (file: "knight.rigged.glb", animations: ["Walk"])
● adjust_animation (animations: ["Walk"], keep_arms_out: 1)
● render_rig (animation: "Walk", time: 1.633) × 2
● Kalkan kolu, yürüyüşün üçte birinde sol bacağın içine giriyordu. knight.rigged-v2.glb dosyasında düzeltildi.

Önce: diz kalkanın içinden geçiyor

Sonra: kalkan bacağa değmeden sarkıyor
Hızlı başvuru
export AFK_API_KEY=afk_... # from afk.ai/developersnpx afk-rig knight.glb --type human # every animation (the default)npx afk-rig wolf.glb --type fox -a Walk,Run # only thesenpx afk-rig character knight.png # a picture in, a rigged character outnpx afk-rig types fox # a body type's animationsfor f in models/*.glb; do npx afk-rig "$f" --type fox; done # 2 rigs run at oncenpx afk-rig inspect knight.rigged.glb # each animation's problems, worst firstnpx afk-rig render knight.rigged.glb --animation Walk --time 1.6 -o walk.pngnpx afk-rig adjust knight.rigged.glb -a Walk --keep-arms-out 1 # writes knight.rigged-v2.glbnpx afk-rig fix-stretching knight.rigged.glb # torn skinclaude mcp add afk-rig --env AFK_API_KEY=afk_... -- npx -y afk-rig mcp# Cursor and other clients, in mcp.json:{ "mcpServers": { "afk-rig": { "command": "npx", "args": ["-y", "afk-rig", "mcp"], "env": { "AFK_API_KEY": "afk_..." } } } }import { AfkRig } from 'afk-rig'const afk = new AfkRig() // reads AFK_API_KEYconst { job } = await afk.rig('wolf.glb', { type: 'fox', output: 'wolf.rigged.glb' })// startRig, getRig, waitForRig and downloadRig do it a step at a timeconst gltf = await new GLTFLoader().loadAsync('knight.rigged.glb')scene.add(gltf.scene)const mixer = new THREE.AnimationMixer(gltf.scene)mixer.clipAction(THREE.AnimationClip.findByName(gltf.animations, 'Walk')).play()// then mixer.update(delta) every frameİnsanların onunla yaptıkları
- Oyuncuların kendi modellerini getirdiği oyunlar: bir karakteri ya da evcil hayvanı yükleme anında rigle, bir dakika sonra ortalıkta yürüsün.
- Metinden 3D ve görselden 3D uygulamaları: üretilen mesh'ler heykel gibi değil, hareket ederek çıkar. Hiç modelin yok mu?
afk-rig characterbir resimden model yapar ve onu yaklaşık 2 ila 3 dakikada rigler. - Varlık iş akışları (asset pipeline): bütün bir klasörü CI'da rigle. CLI dosyanın yolunu yazdırır ve bir rig başarısız olursa sıfırdan farklı bir kodla çıkar.
- 3D içerik üreten yapay zekâ ajanları: riglemek, kontrol etmek ve düzeltmek birer araç çağrısıdır. Bkz. Claude Code'dan 3D modelleri riglemek.
Sorular
API hangi dosya formatlarını kabul ediyor?
GLB, her şeyi gömülü glTF ya da FBX, 200 MB'a kadar. Draco veya meshopt mesh sıkıştırması olmadan dışa aktar.
Bir rig ne kadar sürer?
Genellikle 30 saniye ile bir dakika arası. 20 MB'ın üzerindeki modeller bir iki dakika sürebilir.
Unity'de çalışır mı?
Evet, glTFast paketiyle. Yaratıkları ve nesneleri Humanoid değil Generic rig olarak içe aktar.
Animasyonları ticari bir oyunda kullanabilir miyim?
Evet. İskeletler ve animasyonlar CC0'dır ve modelin senin kalır.
Modelleri koddan rigle
Vücut tipine ait tüm animasyonlar tek bir GLB'de; terminalinden, kodundan ya da yapay zekâ ajanından.