mot_... ID 作为 motion_id 用于渲染。
所有接口均需 Authorization: Bearer YOUR_API_KEY。逐字段说明见视频创建、文本创建、导入、列表、获取、删除、导出。
从视频创建动作
POST /v1/motions
请求形式由 Content-Type 决定。multipart/form-data 从驱动视频创建动作：
glb/all 还接受 enable_smoothing、target_fps 和 task_id。缩略图由内部从源视频生成，详见从视频创建动作。
从文本创建动作
同一接口通过application/json 从提示词生成动作，固定为 type: glb，替代已移除的 POST /v1/animations/generate。每次固定 10 积分，与 duration_seconds 无关，不按视频提取的每秒价格收费。
导入动作模板
POST /v1/motions/import
使用 JSON 从 Viggle 模板导入动作，按模板时长 1 积分/秒计费，最低 1 积分。
两个模板字段同时存在时，
template_id 优先。新接入只发送 template_id。获取动作
GET /v1/motions/{motion_id}
列出动作
GET /v1/motions
返回当前账户最近创建的有效动作，从新到旧，最多 100 条，无游标。
删除动作
DELETE /v1/motions/{motion_id}
导出 3D 动画
GET /v1/motions/{motion_id}/export
仅适用于 glb/all 或文本生成动作。download_type 选择的是文件格式——glb 或 fbx——每次请求会一次性返回该格式下三种骨架的链接：mixamo_url、metahuman_url、metahuman_body_url。两种格式下的三种骨架均已预先生成，任选一种格式都无需重新生成。mixamo_url 是通用 50 关节骨架，需重定向到自己的角色；metahuman_url/metahuman_body_url 与 Viggle vsplat 角色一一对应，前者为 441 关节完整面部版，后者为 86 关节身体版，需匹配创建角色的 joint_set，无需重定向。详见导出 3D 动作。
动作响应字段
Motion 结构包含id、status、name、progress、capabilities、type、glb、created_at、completed_at 和 error。请求 3D 提取或生成时，glb 为 {status, skeletons, error}，否则为 null；skeletons 就绪前为空，就绪后为 [mixamo, metahuman]。ID 例如 mot_550e8400-e29b-41d4-a716-446655440000，请原样保存。