复用角色和动作 - Viggle API

当同一角色或动作需要用于多个渲染任务时，只需创建一次 Character 或 Motion。V1 将它们保存为独立、可复用的资源。下方两种创建调用的完整可运行示例见角色和动作快速入门。

创建角色

curl -X POST "https://apis.viggle.ai/v1/characters" \
  -H "Authorization: Bearer $VIGGLE_API_KEY" \
  -F "[email protected]" \
  -F "name=Presenter"

创建动作

curl -X POST "https://apis.viggle.ai/v1/motions" \
  -H "Authorization: Bearer $VIGGLE_API_KEY" \
  -F "[email protected]" \
  -F "name=Dance loop"

两种操作都会返回异步资源。请等待各资源的 status 为 ready 后，再用于渲染。

使用可复用 ID 渲染

curl -X POST "https://apis.viggle.ai/v1/renders" \
  -H "Authorization: Bearer $VIGGLE_API_KEY" \
  -F "character_id=char_123abc" \
  -F "motion_id=mot_456def"

素材就绪条件

角色和动作均提供 capabilities 数组。只有当素材的 status 为 ready，且 capabilities 包含 video_render 时，才能用于渲染。

一次性任务可直接提交输入文件。同一角色或动作需要用于多次渲染时，使用可复用素材。