# Viggle API: Chinese

## Chinese

### V1

#### 文档

##### 快速入门

- [快速入门：参考素材生成视频](https://docs.viggle.ai/zh/v1/guides/quickstart-reference-to-video.md): 结合参考视频或图片与文本提示词生成视频。
- [快速入门：视频重混](https://docs.viggle.ai/zh/v1/guides/quickstart-mix.md): 将角色图片和动作视频合成为成品视频。
- [快速入门：角色](https://docs.viggle.ai/zh/v1/guides/quickstart-character.md): 从图片创建可复用的角色。
- [快速入门：动作](https://docs.viggle.ai/zh/v1/guides/quickstart-motion.md): 从驱动视频创建可复用的动作。
- [快速入门：3D 角色](https://docs.viggle.ai/zh/v1/guides/quickstart-character-3d.md): 从角色图片提取可下载的 3D 高斯泼溅模型。
- [快速入门：3D 动作](https://docs.viggle.ai/zh/v1/guides/quickstart-mocap.md): 从动作视频提取可下载的 3D 动画。
- [快速入门：文本生成动作](https://docs.viggle.ai/zh/v1/guides/quickstart-text-to-motion.md): 通过文本提示词生成可下载的 3D 动画。
- [快速入门：文本生成视频](https://docs.viggle.ai/zh/v1/guides/quickstart-text-to-video.md): 仅通过文本提示词生成 MiniMax H3 视频。
- [快速入门：首帧生成视频](https://docs.viggle.ai/zh/v1/guides/quickstart-first-frame-to-video.md): 上传首帧图片或提供图片 URL，为 MiniMax H3 视频指定起始画面。
- [快速入门：首尾帧生成视频](https://docs.viggle.ai/zh/v1/guides/quickstart-first-last-frame-to-video.md): 为 MiniMax H3 视频同时指定起始画面与结束画面。
- [快速入门：Viggle Image](https://docs.viggle.ai/zh/v1/guides/quickstart-image.md): 用文字描述生成 PNG 图片，可选参考图引导。
- [身份验证](https://docs.viggle.ai/zh/v1/authentication.md): 验证 V1 请求身份，并使用请求 ID 追踪调用。
- [计费与保留期限](https://docs.viggle.ai/zh/v1/pricing.md): 了解 V1 的费用、积分结算及结果可用性。
- [Viggle API V1](https://docs.viggle.ai/zh/v1/introduction.md): 使用 Viggle API V1 创建可控的角色动作视频。
- [代码示例](https://docs.viggle.ai/zh/v1/api-reference/code-examples.md): 各 V1 接口的 Go、JavaScript、Python 和 cURL 示例。

##### 使用指南

- [复用角色和动作](https://docs.viggle.ai/zh/v1/guides/reuse-assets.md): 创建可复用素材，用于多次 V1 渲染。
- [透明背景输出](https://docs.viggle.ai/zh/v1/guides/transparent-output.md): 生成用于视频合成的 Alpha 输出。
- [Unity Quickstart](https://docs.viggle.ai/lplugin/unity-quickstart.md): Install Viggle Splat Engine, run the sample, and load characters and animations.

##### 生产接入

- [异步任务与结果可用性](https://docs.viggle.ai/zh/v1/production/async-jobs.md): 可靠地轮询或监听 V1 任务，并处理其生命周期。
- [错误与恢复](https://docs.viggle.ai/zh/v1/production/errors.md): 以一致方式处理 V1 错误。
- [从旧版迁移到 V1](https://docs.viggle.ai/zh/v1/production/migrate-from-legacy.md): 将已有 Viggle 集成从旧版 API 迁移到 V1。

#### API 参考

##### 账户

- [V1 API 参考](https://docs.viggle.ai/zh/v1/api-reference/overview.md): 按资源组织的 Viggle V1 API 参考文档。
- [积分](https://docs.viggle.ai/zh/v1/api-reference/credits.md): 查询当前账户的积分余额。

##### 角色

- [从图片创建角色](https://docs.viggle.ai/zh/v1/api-reference/characters/create.md): 从图片创建可复用角色，并可选提取 3D vsplat。
- [列出角色](https://docs.viggle.ai/zh/v1/api-reference/characters/list.md): 列出当前账户可用的可复用角色。
- [获取角色](https://docs.viggle.ai/zh/v1/api-reference/characters/get.md): 获取单个角色的状态和能力。
- [删除角色](https://docs.viggle.ai/zh/v1/api-reference/characters/delete.md): 从当前账户删除角色。
- [导出 3D 角色（用于 3D／游戏引擎）](https://docs.viggle.ai/zh/v1/api-reference/characters/export.md): 获取角色 vsplat 提取结果的签名下载链接。

##### 动作

- [从视频创建动作](https://docs.viggle.ai/zh/v1/api-reference/motions/create.md): 从驱动视频创建可复用动作。
- [从文本创建动作](https://docs.viggle.ai/zh/v1/api-reference/motions/create-from-text.md): 通过文本提示词生成可复用的 3D 动作。
- [导入动作](https://docs.viggle.ai/zh/v1/api-reference/motions/import.md): 从 Viggle 官方动作模板创建可复用动作。
- [列出动作](https://docs.viggle.ai/zh/v1/api-reference/motions/list.md): 获取当前账户最近创建的动作。
- [获取动作](https://docs.viggle.ai/zh/v1/api-reference/motions/get.md): 获取单个动作的当前状态。
- [删除动作](https://docs.viggle.ai/zh/v1/api-reference/motions/delete.md): 删除当前账户拥有的动作。
- [导出 3D 动作（用于 3D／游戏引擎）](https://docs.viggle.ai/zh/v1/api-reference/motions/export.md): 获取提取或生成的 3D 动画的签名下载链接。

##### 渲染

- [准备渲染](https://docs.viggle.ai/zh/v1/api-reference/renders/prepare.md): 准备渲染草稿，并获取待上传素材的直传计划。
- [从角色与动作渲染视频](https://docs.viggle.ai/zh/v1/api-reference/renders/create.md): 直接创建渲染任务，或提交已准备好的渲染草稿。
- [监听渲染](https://docs.viggle.ai/zh/v1/api-reference/renders/events.md): 通过服务器发送事件监听渲染状态。
- [下载渲染结果](https://docs.viggle.ai/zh/v1/api-reference/renders/download.md): 下载已就绪渲染任务的成品视频。

##### 视频

- [从文本生成视频](https://docs.viggle.ai/zh/v1/api-reference/videos/create-from-text.md): 仅通过文本提示词生成 MiniMax H3 视频。
- [从首帧和文本生成视频](https://docs.viggle.ai/zh/v1/api-reference/videos/create-from-first-frame.md): 通过首帧图片和提示词生成 MiniMax H3 视频。
- [从首尾帧和文本生成视频](https://docs.viggle.ai/zh/v1/api-reference/videos/create-from-first-last-frame.md): 为 MiniMax H3 视频指定起始画面和结束画面。
- [从参考视频或图片生成视频](https://docs.viggle.ai/zh/v1/api-reference/videos/create-from-reference-video.md): 使用参考视频或最多 4 张图片，延续其主体或风格来生成 MiniMax H3 视频。
- [使用 Viggle-Animate](https://docs.viggle.ai/zh/v1/api-reference/videos/create-from-character-animation.md): 使用 Viggle-Animate 从角色图片生成动画视频：单独使用时最多四张，配合驱动视频时最多五张。
- [视频 2 倍超分](https://docs.viggle.ai/zh/v1/api-reference/videos/super-resolution.md): 使用 FlashVSR 将现有视频固定放大 2 倍。
- [列出视频](https://docs.viggle.ai/zh/v1/api-reference/videos/list.md): 使用游标分页列出当前调用者的渲染、H3 视频和角色动画。
- [获取视频](https://docs.viggle.ai/zh/v1/api-reference/videos/get.md): 通过统一接口获取渲染、视频生成或视频超分的完整状态。

##### Viggle Image

- [生成图片](https://docs.viggle.ai/zh/v1/api-reference/images/create.md): 用文字描述生成 1–6 张 PNG，可选最多 8 张参考图。
- [查询图片](https://docs.viggle.ai/zh/v1/api-reference/images/get.md): 获取图片生成任务的当前状态，就绪后获取 PNG 下载链接。

## OpenAPI Specs

- [openapi](/zh/openapi.yaml)

## Optional

- [社区](https://discord.com/invite/viggle)