AIMoCap Docs
API 概览
使用 AIMoCap 异步 API 提交视频 mocap 任务、上传源视频并获取输出结果。
API 用途
AIMoCap API 主要用于：
- 内部生产管线
- 创作者工具
- 企业集成
- 机器人动作自动化工作流
API 是异步的。典型流程如下：
- 创建 mocap 任务
- 上传源视频
- 完成上传准入
- 轮询任务状态
- 下载最终结果
输出目标
公开 API 使用 targetIds 表示单个 mocap 任务需要生成的一个或多个输出。当前支持的公开 target id 为：
defaultunitree_g1
不同 target 对应的输出格式如下：
default->fbxunitree_g1->robot_motion_json
自定义 avatar target 会在后续公开 API 版本中开放，当前不作为正式对外接口能力。
导出 FPS
可选字段 exportFps 当前支持：
243060120
如果不传 exportFps，AIMoCap 默认使用 30。
如果传入非法值，请求会在创建任务阶段直接返回：
export_fps_invalid
捕捉类型
可选字段 mocapType 当前支持：
full_bodyupper_body
如果不传 mocapType，AIMoCap 默认使用 full_body。
如果传入非法值，请求会在创建任务阶段直接返回：
mocap_type_invalid
其它能在排队前判断的问题，也会在创建任务或完成上传准入阶段直接返回：
api_duration_limit_exceededapi_file_size_limit_exceededapi_concurrency_limit_exceededapi_plan_inactiveinsufficient_api_v_credits
API Key 与计费
API 使用独立的 API Key 和独立的 v-credit 余额。
- Web credits 与 API v-credit 分开计费，不共享余额。
1 v-credit = 1 秒已准入的视频时长。- 只有当 API 账户处于激活状态并且满足计划限制时，请求才会被准入。
接下来建议阅读：