Skip to main content
**3D 动作(Motion 3D)**从驱动视频中提取 3D 骨骼动画,使用 POST /v1/motionstype=glb 模式。就绪后,通过导出 3D 动作,指定 ?download_type=mixamo(或 metahuman)获取 GLB。导出的 GLB 可用于 MixamoMetaHuman 以及其他兼容 Unity 的动画流程。如需可直接渲染的 2D 动作,见动作快速入门;如需直接用提示词生成 3D 动画,见文本生成动作 设置环境变量 VIGGLE_API_KEY,并准备下方示例所需的动作视频。

准备工作

示例中的 https://assets.viggle.ai/samples/motion.mp4 是占位地址。请替换为自己的 motion_video/motion_video_url,或使用 Viggle 正式发布的示例素材。

创建、轮询并导出动作

响应

每 5 秒轮询 GET /v1/motions/{motion_id}。当 statusready 时,请求 GET /v1/motions/{motion_id}/export?download_type=mixamo。返回的 glb_url 指向生成的动画;签名链接有效期为 1 小时,每次调用都会重新签名。对同一 motion_id 使用 download_type=metahuman 即可获取另一种骨架。两种骨架会预先生成,因此切换时无需等待新的处理任务。不提供 fbx 输出。 mixamo 是通用的 50 关节骨架,需要重定向到自己的角色;metahuman 与 Viggle vsplat 角色的骨架一一对应,无需重定向。完整对比见导出 3D 动作,其中也说明了 metahuman 的 441 关节(含面部)与 86 关节(仅身体)版本。 glb 提取按源视频时长计费,详见计费与保留期限

从视频创建动作

查看全部请求和响应字段。