Skip to main content
用文字描述动作,以 JSON 提交请求,再轮询返回的动作资源,直到生成的 GLB 就绪。本流程无需源视频,按请求收取固定费用;3D 动作glb 提取流程则按源视频时长计费。 设置 VIGGLE_API_KEY 后即可运行下方示例,无需其他输入素材。

准备工作

  • Viggle 控制台创建 API 密钥,并导出为 VIGGLE_API_KEY
  • 长度为 1–400 个字符的动作提示词。

创建、轮询并导出动作

创建请求会立即返回动作资源,status 通常为 queued。每 5 秒轮询 GET /v1/motions/{motion_id},直到状态变为 readyfailed;动作资源没有 cancelled 状态。 就绪后,调用 GET /v1/motions/{motion_id}/export?download_type=mixamo 获取 Mixamo 骨架,也可改用 download_type=metahuman。两种版本会一起生成,不提供 fbx 输出。glb_url 是签名链接,有效期为 1 小时,每次调用都会重新签名。导出的 GLB 可用于 MixamoMetaHuman 以及其他兼容 Unity 的动画流程。 mixamo 是通用的 50 关节骨架,需要重定向到自己的角色;metahuman 与 Viggle vsplat 角色的骨架一一对应,无需重定向。完整对比见导出 3D 动作,其中也说明了 metahuman 的 441 关节(含面部)与 86 关节(仅身体)版本。 费用见计费与保留期限:文本生成动作每次请求固定收取 $0.10(10 积分),与 duration_seconds 无关。

从文本创建动作

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