Skip to main content
旧版 API 已弃用。 新接入必须使用 V1；旧接口仅用于迁移过渡。

​
接口映射

V1 的 3D 提取不再使用独立 /v1/avatars 或 /v1/animations 资源，而是同一角色、动作资源中的 type、vsplat/glb 属性。输出通过角色导出或动作导出获取，无需追踪旧版独立的 avatar_/anim_ 提取资源。 提取控制参数大多沿用原名，但不再公开 vsplat 模型选择（旧 model 由服务内部决定），也不再有 fp 字段。调用者仅用 render_thumbnail 决定是否生成缩略图，渲染来源和姿势由内部决定。输出改为单个 .vsplat 文件（vsplat_url），替代 bin_url/stripped_bin_url。动作提取继续支持 enable_smoothing、target_fps、task_id。角色来源使用 image、image_url 或复用的 character_id；动作来源使用 motion_video、motion_video_url 或复用的 motion_id。创建资源时使用新 type 参数，复用 ID 渲染时遵循渲染接口的参数约定。

​
响应映射

​
建议迁移顺序

  1. 更新请求路径和表单字段，包含角色、动作创建时的 type。
  2. 保存 V1 带前缀的 ID（char_、mot_、render_），避免混用 UUID 与任务 ID；3D 提取不再维护独立的旧版 avatar_/anim_ 资源。
  3. 轮询处理 ready、failed、cancelled，并移除客户端主动取消渲染的依赖。
  4. 错误处理改用 error.code（大写下划线形式）、error.retryable 和 error.remediation。
  5. 确认透明输出使用 alpha_url。
  6. 3D 下载从旧 avatar/animation 查询接口迁移到角色、动作各自的 /export 接口。