教程

用 afk.ai 绑骨 API 能做什么

发送一个 3D 模型，拿回一个绑好骨骼的 GLB，附带该体型的全部动画，人形有 594 个。人、动物、龙、恐龙、蜘蛛、鱼，以及会弹跳、旋转和晃动的道具，都能从终端、代码或 AI 智能体发起。

更新于 2026年11月4日

afk.ai API 接收一个 3D 模型（GLB、glTF 或 FBX）和它的体型，返回一个 GLB，里面有骨架、蒙皮权重和为该体型制作的全部动画。它就是 afk.ai/rig 上的 AI 绑骨引擎，只不过改由你的终端、代码或 AI 智能体来驱动。

~/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
骑士上传时和绑骨后的样子：拖动可以旋转。为了让页面保持轻快，这里只播放它 593 个动画中的 4 个。 骑士：Medieval Knight，作者 Andy Woodhead，CC BY 4.0。

文件里有什么

  • 网格：绑好骨骼的骑士，由 afk-rig 渲染

    网格

    23,293 个顶点、6 个材质和 14 张纹理，保持上传时的原样

  • 骨架：绑好骨骼的骑士，由 afk-rig 渲染

    骨架

    66 根骨骼，每根手指都有，所有人形角色的骨骼名称都相同

  • 蒙皮权重：绑好骨骼的骑士，由 afk-rig 渲染

    蒙皮权重

    每个顶点最多受 4 根骨骼影响，这里每根骨骼一种颜色

  • 593 个动画：绑好骨骼的骑士，由 afk-rig 渲染

    593 个动画

    该体型的全部动画；这是 Sword_Attack 的第 0.7 秒

knight.rigged.glb 里面的内容，由 afk-rig render 绘制：和 AI 智能体从 render_rig 拿到的图片一样。

它是一个标准 GLB，所以无需任何转换，就能在 three.js、Babylon.js、Blender、Unity（借助 glTFast）、Unreal 5.1+ 和 Godot 中加载。同一体型的每个模型都有相同的骨骼名和动画名，所以一个动画控制器就能驱动所有模型。

14 种体型

大多数自动绑骨工具只能处理人形。afk.ai 为以下每种体型都准备了一套骨架和一组动画，总共超过 800 个。选一个看看它的动画列表：

~/game
$ npx afk-rig types humanhuman（人、机器人，任何用两条腿站立的角色）：593 个动画Angry 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

道具不只会移动，还会弯曲

object 类型会在任意道具内部匹配一套 21 个关节的骨架：中间一条脊柱，加上横跨脊柱的三排骨骼。这样宝箱落地时会被压扁，路牌会被风吹弯，而不只是四处滑动。在 afk.ai/rig 上，你还可以只给模型的一部分绑骨，比如旗杆上的旗帜。更多内容请看给 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

用 AI 智能体检查和修复

afk-rig 也是一个 MCP 服务器，可以用在 Claude Code、Cursor 和其他智能体中。除了 rig_model 和 image_to_character，它还有在你电脑上运行的工具：inspect_rig 找出陷进地面的脚、撕裂的蒙皮和穿进身体的手臂，render_rig 画出那一刻，adjust_animation、fix_stretching 和 fix_spot 则把修复结果写进一个新文件。

claude · ~/game

> 检查骑士的 Walk，修好有问题的地方

● 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

⎿
修复前后对比，见右侧

● 在约三分之一的行走过程中，持盾的手臂穿进了左腿。已修复，见 knight.rigged-v2.glb。

修复前：骑士 Walk 动画的第 1.633 秒，由 afk-rig 渲染

修复前: 膝盖穿过了盾牌

修复后：骑士 Walk 动画的第 1.633 秒，由 afk-rig 渲染

修复后: 盾牌垂在腿外，不再穿模

在上面那个骑士上的一次真实运行。这些工具在你的电脑上运行，免费，不需要 API 密钥，也从不修改它们读取的文件。

速查

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

大家用它做什么

  • 玩家自带模型的游戏：玩家上传角色或宠物时就给它绑骨，一分钟后它就能四处走动了。
  • 文生 3D 和图生 3D 应用：生成的网格出来就能动，而不是一尊尊雕像。连模型都没有？afk-rig character 能用一张图片生成模型并绑骨，大约需要 2 到 3 分钟。
  • 资源管线：在 CI 中一次给整个文件夹绑骨。CLI 会打印文件路径，绑骨失败时以非零状态码退出。
  • 制作 3D 内容的 AI 智能体：绑骨、检查和修复都是工具调用。请看在 Claude Code 中给 3D 模型绑骨。

常见问题

API 支持哪些文件格式？

GLB、内嵌所有资源的 glTF，或 FBX，最大 200 MB。导出时请不要使用 Draco 或 meshopt 网格压缩。

绑一次骨要多久？

通常 30 秒到 1 分钟。超过 20 MB 的模型可能需要一两分钟。

能在 Unity 中使用吗？

能，借助 glTFast 包。生物和物体要以 Generic（通用）类型导入，而不是 Humanoid。

动画可以用在商业游戏中吗？

可以。骨架和动画采用 CC0 授权，你的模型仍归你所有。

用代码给模型绑骨

该体型的全部动画，打包在一个 GLB 里，可以从终端、代码或 AI 智能体发起。

获取 API 密钥

更多教程

在 Claude Code 中给 3D 模型绑骨和做动画：给智能体一个绑骨工具，而不是 Blender 脚本

别让你的 AI 编程智能体手搓骨骼和蒙皮权重。添加 afk-rig MCP 服务器后，Claude Code 一次工具调用就能给角色、动物或道具绑骨，附带该体型的全部动画，再在你的电脑上检查和修复。

VRM 转 FBX、GLB 转 FBX 及反向转换：保留动画的 3D 格式转换工具

把 VRM、GLB、glTF、FBX、OBJ、STL、PLY 或 USDZ 转换为 GLB、FBX、USDZ、OBJ 或 STL。骨架、蒙皮权重和每个关键帧都会保留，VRM 的表情变成面部形状，头发物理也会烘焙进去。

动画重定向：给已经绑好骨骼的模型添加动画

afk.ai 把自家的动画重定向到任何已绑骨角色自己的骨架上，保留它的蒙皮权重、头发和布料物理，以及原有的动画。