Skip to main content
GET
导出 3D 动作(用于 3D/游戏引擎)
仅适用于 type=glb/all 的动作,或通过 POST /v1/motions 的 JSON 模式从文本生成的动作。仅 render 的动作无可导出内容。本接口替代已移除的 GET /v1/animations/{animation_id} download_type 直接选择骨架(mixamometahuman),而非输出格式。不提供 fbx;两种骨架会预先生成,对同一 motion_id 切换骨架不会触发新任务或重新生成。导出的 GLB 可用于 MixamoMetaHuman 以及其他兼容 Unity 的动画流程。
选择骨架: mixamo 是通用的 50 关节骨架,适用于 Mixamo、Unity、Unreal 和多数 DCC 工具。它未绑定具体角色,需重定向到自己的角色网格才能正确播放。metahuman 与 Viggle vsplat 角色使用的 MetaHuman 兼容骨架一致,关节层级完全对应,可直接驱动角色,无需重定向,见创建角色中的 joint_set。该骨架有包含完整面部及表情动画能力的 441 关节版本,以及不含面部关节的 86 关节身体版本;请匹配角色创建时的 joint_set

请求参数

响应参数

返回 200 OK
同一动作改用 metahuman,无需重新生成:

示例

下载链接有效期较短,每次读取都会重新签名。需要时请再次指定 download_type 获取,不要长期缓存。

下一步

文本生成的动作没有 2D 渲染素材,只能使用本导出接口。视频来源的动作若具备 video_render 能力且已就绪,可将 motion_id 用于渲染视频

授权

Authorization
string
header
必填

服务端 SDK 使用项目 API 密钥,Remote MCP 使用 OAuth 访问令牌。不要在浏览器代码中暴露项目密钥。

请求头

X-Request-Id
string

可选的调用者自定义关联 ID,最长 128 字符。服务会在响应头返回实际使用的值,便于追踪和支持排查。

Required string length: 1 - 128
X-Viggle-Source
string

可选来源标签,最长 128 字符,用于识别 SDK、集成、产品入口或内部工作流。

Required string length: 1 - 128

路径参数

motion_id
string
必填

创建或列出动作时返回的公开 ID,通常以 mot_ 开头,必须属于当前调用者。

Minimum string length: 1

查询参数

download_type
enum<string>

选择预生成骨架的签名 GLB:mixamo 为 Mixamo 兼容骨架,metahuman 为 MetaHuman 兼容骨架。

可用选项:
mixamo,
metahuman

响应

请求成功。

动作 3D 提取或文本生成的下载结果。指定 download_type=mixamo 或 metahuman 后返回相应 glb_url。两种骨架预先生成,切换不会创建新任务。不支持 fbx。下载链接短期有效,每次读取重新签名,替代旧 AnimationResource 和已移除的 GET /v1/animations/{animation_id}。

id
string
必填

所请求的动作公开 ID。

Minimum string length: 1
status
enum<string>
必填

queuedprocessingreadyfailed

可用选项:
queued,
processing,
ready,
failed,
cancelled
download_type
enum<string> | null
必填

请求中选择的骨架,省略时为 null

可用选项:
mixamo,
metahuman,
null
glb_url
string | null
必填

指定 download_type 且对应骨架就绪时有值。

thumbnail_url
string | null
必填

动画没有缩略图,始终为 null

created_at
string | null
必填

ISO 8601 时间。尚未记录时可能为空字符串。

updated_at
string | null
必填

最近更新时间,ISO 8601 格式。

error
object | null
必填

失败时的结构化错误详情。