Rehberler

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.

~/game
$ 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.glb
Şövalye, yüklendiği ve riglendiği hâliyle: döndürmek için sürükle. Sayfa hafif kalsın diye burada 593 animasyonundan 4'ünü oynatıyor. Şövalye: Medieval Knight (Andy Woodhead), CC BY 4.0.

Dosyada neler var

  • Mesh: afk-rig ile render edilmiş riglenmiş şövalye

    Mesh

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

  • İskelet: afk-rig ile render edilmiş riglenmiş şövalye

    İskelet

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

  • Skin ağırlıkları: afk-rig ile render edilmiş riglenmiş şövalye

    Skin ağırlıkları

    Vertex başına en fazla 4 kemik; burada her kemik bir renk

  • 593 animasyon: afk-rig ile render edilmiş riglenmiş şövalye

    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ç:

~/game
$ 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.5s

Sadece 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.

claude · ~/game

> Şövalyenin Walk animasyonunu kontrol et ve yanlış olan her şeyi düzelt

● inspect_rig (file: "knight.rigged.glb", animations: ["Walk"])

⎿
Walk: arms or hands through the body in 18 of 51 frames (deepest: hand_l into calf_l, 4.6% of its height, at 1.633 s)

● adjust_animation (animations: ["Walk"], keep_arms_out: 1)

⎿
knight.rigged-v2.glb · arms_through_body_frames [18, 0]

● render_rig (animation: "Walk", time: 1.633) × 2

⎿
önce ve sonra, sağda

● Kalkan kolu, yürüyüşün üçte birinde sol bacağın içine giriyordu. knight.rigged-v2.glb dosyasında düzeltildi.

Önce: şövalyenin 1,633 sn'deki Walk animasyonu, afk-rig ile render edildi

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

Sonra: şövalyenin 1,633 sn'deki Walk animasyonu, afk-rig ile render edildi

Sonra: kalkan bacağa değmeden sarkıyor

Yukarıdaki şövalye üzerinde gerçek bir çalıştırma. Araçlar bilgisayarında, ücretsiz ve API anahtarı olmadan çalışır ve okudukları dosyayı asla değiştirmez.

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 once

İ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 character bir 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.

API anahtarı al

Diğer rehberler