> ## Documentation Index
> Fetch the complete documentation index at: https://docs.viggle.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 复用角色和动作

> 创建可复用素材，用于多次 V1 渲染。

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

## 创建角色

```bash theme={null}
curl -X POST "https://apis.viggle.ai/v1/characters" \
  -H "Authorization: Bearer $VIGGLE_API_KEY" \
  -F "image=@character.png" \
  -F "name=Presenter"
```

## 创建动作

```bash theme={null}
curl -X POST "https://apis.viggle.ai/v1/motions" \
  -H "Authorization: Bearer $VIGGLE_API_KEY" \
  -F "motion_video=@dance.mp4" \
  -F "name=Dance loop"
```

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

## 使用可复用 ID 渲染

```bash theme={null}
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` 时，才能用于渲染。

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