POST /v1/motions 的 type=glb 模式。就绪后,通过导出 3D 动作,指定 ?download_type=mixamo(或 metahuman)获取 GLB。导出的 GLB 可用于 Mixamo、MetaHuman 以及其他兼容 Unity 的动画流程。如需可直接渲染的 2D 动作,见动作快速入门;如需直接用提示词生成 3D 动画,见文本生成动作。
设置环境变量 VIGGLE_API_KEY,并准备下方示例所需的动作视频。
准备工作
- 在 Viggle 控制台创建 API 密钥,并导出为
VIGGLE_API_KEY。
示例中的
https://assets.viggle.ai/samples/motion.mp4 是占位地址。请替换为自己的 motion_video/motion_video_url,或使用 Viggle 正式发布的示例素材。创建、轮询并导出动作
响应
GET /v1/motions/{motion_id}。当 status 为 ready 时,请求 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 提取按源视频时长计费,详见计费与保留期限。
从视频创建动作
查看全部请求和响应字段。

