afk.ai Auto-Rig

io.github.dyoburon由 GitHub 账号 dyoburon 发布v1.3.5更新于 Nov 5, 2026

Auto-rig 3D models (GLB, glTF, FBX) with skeleton, skin weights and 170+ animations via afk.ai.

已验证STDIO仅桌面媒体与设计AI 与机器学习

概览

AI 生成的概览

通过 afk.ai API 为 3D 模型(GLB、glTF、FBX)自动绑定骨骼,或把图片变成带骨骼和动画的角色,并可在本地检查与修复绑定。

可以做什么
  • 绑定模型与生成角色:为 3D 文件自动绑定骨骼,或从图片生成带骨骼和动画的角色,并列出体型及其动画
  • 查看账户用量:查询本月剩余免费绑定次数、API 额度和角色额度余额,以及按 id 查询绑定任务状态
  • 检查与渲染绑定:列出骨骼、网格、高度和有问题的动画,并在静止或动画某一时刻渲染模型及骨架
  • 调整与修复绑定:修改动画控制参数、修复拉伸或撕裂的蒙皮、修复指定位置的蒙皮权重,每次都会写出新文件
适用场景
适合需要为 3D 角色或模型添加骨架、蒙皮权重和现成动画的场景,也适合在用于游戏或动画流程前,调整已有绑定模型的动画并修复蒙皮撕裂或权重问题。
运行要求
以本地 npm 包通过 stdio 在桌面电脑上运行。绑定和图片转角色工具需要在 AFK_API_KEY 环境变量中提供 afk.ai API 密钥;本地检查、渲染、调整和修复工具无需密钥。绑定需要访问 afk.ai 的网络连接。
安装前请注意
绑定会消耗账户每月免费绑定次数或 API 额度,image_to_character 每次消耗 0.25 美元额度且免费绑定次数不覆盖,涉及付费。API 密钥属于机密并会发送给 afk.ai,上传的模型和图片会经过 afk.ai 的内容审核。调整和修复工具会在原文件旁写出新的 .glb 文件。

安装

在 SourceWeft 中

  1. 打开 控制台中的 afk.ai Auto-Rig,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

工具

10

rig_model

Auto-rig a 3D model file (.glb, .gltf with everything embedded, or .fbx; up to 200 MB) and write the rigged .glb with its animations. Takes about a minute. Returns where the file was written.

输入参数path必填typefacingoutputanimationskeep_arms_out

image_to_character

Make a rigged, animated 3D character from a picture (.png, .jpg or .webp of one character, whole; up to 20 MB): a 3D model made from the picture, rigged with every animation for its body type, written as a .glb. Takes about 2 to 3 minutes (up to 5 when the GPU is starting) and costs $0.25 of API credits, refunded if it fails. Returns where the file was written, what was charged and the credits left.

输入参数path必填typeoutputanimationskeep_arms_out

get_account

How many rigs the account can make (rigs_left: its free rigs this month, then its Lifetime API credit this month with afk.ai Lifetime, then its API credits), and its credit balance for characters.

无需输入参数。

list_body_types

The body types a model can be rigged as, and (with type) that type's animations.

输入参数type

rig_status

A rig's status by id (rig_model waits for its rig, so this is for rigs started elsewhere).

输入参数id必填

inspect_rig

Measure a rigged .glb: its bones (names, parents, positions), meshes, height, the animations with problems, worst first, each with the moment it's worst at to render (ground: % of height its lowest point goes below the rest floor or stays above it, and which bone; stretching: % of skin torn at worst; humans: frames with a forearm or hand through the body, and the deepest) and the animation controls adjust_animation takes. Flying, swimming and other animations that leave the floor on purpose are marked in_the_air and not judged against it. Runs on this computer, free: about a second, a few for a human's 196 animations.

输入参数file必填typelimitanimations

render_rig

Draw a rigged .glb as an image to look at: at rest, or posed at a moment of one of its animations, with its skeleton over it (blue: its left, red: its right, orange: the middle) and rulers in model units. Pinkish-red skin is the inside of the mesh showing (a tear, or a part pushed through another). Also returns every joint drawn in the image with its pixel position and, posed, how far its lowest point is from the rest floor (lowest_point_vs_floor, % of height). Runs on this computer, free.

输入参数file必填sizetimetypexrayfocusviewsjointsradiussave_toweightsanimation

adjust_animation

Change animations of a rigged .glb as afk.ai/rig's Adjust > Animation does, and write a new .glb: turn parts of the body (controls such as armsUp, posture, headUp in degrees), change how it moves (speed, motion, bounce, sway, lag, lookAhead, width, lift, part:arms...), move a hand, foot or the body (positions, the limb reaching for it), and for humans keep the arms out of the body. inspect_rig lists the controls this body type has, with their ranges. Reports each changed animation's ground [before, after] (and arms-through-body frames with keep_arms_out). Runs on this computer, free.

输入参数file必填typeoutputrangescontrolspositionsanimationskeep_arms_out

fix_stretching

Find where the skin of a rigged .glb stretches or tears across its animations and heal it (afk.ai/rig's Fix stretching), writing a new .glb. Reports torn skin [before, after] overall and per animation. Runs on this computer, free.

输入参数file必填typeoutputanimations

fix_spot

Fix the skin weights of one spot of a rigged .glb (afk.ai/rig's Fix a spot) and write a new .glb. Pick the spot with where (every given condition must hold), then: follow (it moves with the wrong part: give it to bone), smooth (pinched, jagged or creased: strength light, medium or strong) or redo (it tears or sticks to another part: its weights worked out again from the nearest bones). Reports the bones the spot follows [before, after]. Runs on this computer, free.

输入参数fix必填bonefile必填typewhere必填outputstrength

版本历史

2
  1. v1.3.5最新Nov 5, 2026
  2. v1.3.2Nov 3, 2026

评分

已满足适用检查项的 65%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分

    请声明包含 README 的 GitHub 仓库,或在 OAuth 受保护资源元数据中提供 resource_documentation。

  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。