Co możesz zbudować z API do riggingu afk.ai
Wyślij model 3D, odbierz GLB z rigiem i wszystkimi animacjami dla jego typu ciała, 594 dla humanoida. Ludzie, zwierzęta, smoki i rekwizyty, z kodu lub od agenta AI.
Zaktualizowano 4 listopada 2026
API afk.ai przyjmuje model 3D (GLB, glTF lub FBX) i jego typ ciała, a zwraca jeden plik GLB ze szkieletem, wagami skinningu i wszystkimi animacjami dla tego ciała. To rigger AI z afk.ai/rig, sterowany z terminala, z twojego kodu albo przez agenta AI.
$ 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.glbCo jest w pliku

Siatka
23 293 wierzchołki, 6 materiałów i 14 tekstur, tak jak po wgraniu

Szkielet
66 kości, łącznie z każdym palcem, z tymi samymi nazwami na każdym humanoidzie

Wagi skinningu
Do 4 kości na wierzchołek, tu jeden kolor na każdą kość

Animacje: 593
Wszystkie dla danego typu ciała; tu Sword_Attack w 0,7 s
knight.rigged.glb, narysowana przez afk-rig render: te same obrazy, które agent AI dostaje od render_rig.To standardowy GLB, więc wczytasz go w three.js, Babylon.js, Blenderze, Unity (przez glTFast), Unreal 5.1+ i Godot bez żadnej konwersji. Każdy model danego typu ciała dostaje te same nazwy kości i animacji, więc jeden kontroler animacji obsłuży je wszystkie.
14 typów ciała
Większość auto-riggerów obsługuje tylko humanoidy. afk.ai ma szkielet i zestaw animacji dla każdego z tych typów, łącznie ponad 800. Wybierz jeden, żeby zobaczyć jego listę:
$ npx afk-rig types humanhuman (ludzie, roboty, wszystko na dwóch nogach) – animacje: 593Angry 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.5sRekwizyty, które się wyginają, a nie tylko przesuwają
Typ object dopasowuje szkielet z 21 kości wewnątrz dowolnego rekwizytu, kręgosłup z trzema rzędami kości w poprzek, więc skrzynia spłaszcza się przy lądowaniu, a szyld wygina się na wietrze, zamiast tylko się przesuwać. Na afk.ai/rig możesz też zrobić rig tylko części modelu, np. flagi na maszcie. Więcej w poradniku o animacji obiektów 3D.
- 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
Sprawdzaj i poprawiaj przez agenta AI
afk-rig to też serwer MCP dla Claude Code, Cursora i innych agentów. Oprócz rig_model i image_to_character ma narzędzia działające na twoim komputerze: inspect_rig znajduje stopy w podłodze, rozdartą skórę i ręce przechodzące przez ciało, render_rig rysuje dany moment, a adjust_animation, fix_stretching i fix_spot zapisują poprawki do nowego pliku.
> Sprawdź Walk rycerza i popraw wszystko, co jest nie tak
● inspect_rig (file: "knight.rigged.glb", animations: ["Walk"])
● adjust_animation (animations: ["Walk"], keep_arms_out: 1)
● render_rig (animation: "Walk", time: 1.633) × 2
● Ramię z tarczą wcinało się w lewą nogę przez jedną trzecią chodu. Poprawione w knight.rigged-v2.glb.

Przed: kolano przechodzi przez tarczę

Po: tarcza wisi z dala od nogi
Ściąga
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 frameCo ludzie z nim budują
- Gry, w których gracze przynoszą własne modele: zrób rig postaci albo zwierzaka przy wgrywaniu, a minutę później model już chodzi.
- Aplikacje text-to-3D i image-to-3D: wygenerowane siatki wychodzą w ruchu, a nie jako posągi. Nie masz w ogóle modelu?
afk-rig charactertworzy go z obrazka i robi mu rig w około 2 do 3 minut. - Pipeline'y assetów: zrób rig całego folderu w CI. CLI wypisuje ścieżkę pliku i kończy się kodem różnym od zera, jeśli rig się nie uda.
- Agenci AI tworzący treści 3D: rig, sprawdzanie i poprawki jako wywołania narzędzi. Zobacz rigging modeli 3D z Claude Code.
Najczęstsze pytania
Jakie formaty plików przyjmuje API?
GLB, glTF ze wszystkim osadzonym w pliku lub FBX, do 200 MB. Eksportuj bez kompresji siatki Draco ani meshopt.
Jak szybko powstaje rig?
Zwykle od 30 sekund do minuty. Modele powyżej 20 MB mogą zająć minutę lub dwie.
Czy to działa w Unity?
Tak, przez pakiet glTFast. Importuj stwory i obiekty jako rig Generic, nie Humanoid.
Czy mogę użyć animacji w grze komercyjnej?
Tak. Szkielety i animacje są na licencji CC0, a twój model pozostaje twój.
Rigging modeli z kodu
Wszystkie animacje dla danego typu ciała w jednym pliku GLB, z terminala, z twojego kodu albo od agenta AI.