教學

用 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 和其他 AI 代理中。除了 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 rig 匯入,而不是 Humanoid。

動畫可以用在商業遊戲中嗎?

可以。骨架和動畫採用 CC0 授權,你的模型仍歸你所有。

用程式碼幫模型綁骨

該體型的全部動畫,打包在一個 GLB 裡,可以從終端機、程式碼或 AI 代理發起。

取得 API 金鑰

更多教學