> ## 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 的费用、积分结算及结果可用性。

## 积分

1 积分 = **\$0.01**。新账户初始获得 **100 免费积分**（\$1.00）。

通过[查询积分](/zh/v1/api-reference/credits)查看余额，或在 [Viggle 控制台](https://portal.viggle.ai/dashboard)管理账单。余额不足导致任务无法启动时，返回 `402` 和 `error.code: "INSUFFICIENT_CREDITS"`，详见[错误与恢复](/zh/v1/production/errors)。

## 价格一览

| 能力                                     | 接口                                   | 价格                                        |
| -------------------------------------- | ------------------------------------ | ----------------------------------------- |
| [视频重混](#video-remix)                   | `POST /v1/renders`                   | 每个角色每秒输出 **\$0.01**                       |
| [角色](#character)                       | `POST /v1/characters`，`type=render`  | 每个 **\$0.01**                             |
| [3D 角色](#character-3d)                 | `POST /v1/characters`，`type=vsplat`  | 每个 **\$0.25**，`enhance=true` 时 **\$0.30** |
| [动作](#motion)                          | `POST /v1/motions`（视频），`type=render` | 不单独收费                                     |
| [3D 动作](#motion-3d)                    | `POST /v1/motions`（视频），`type=glb`    | 源视频时长向上取整后按 **\$0.05/秒**                  |
| [文本生成动作](#text-to-motion)              | `POST /v1/motions`（JSON `text`）      | 每次固定 **\$0.10**                           |
| [H3 视频](#h3-video)                     | `POST /v1/videos`                    | 生成时长按 **\$0.01/秒**                        |
| [Viggle-Animate](#character-animation) | `POST /v1/videos`（角色动画模式）            | 每次固定 **\$0.11**                           |
| [导入动作](#import-motion)                 | `POST /v1/motions/import`            | 模板时长按 **\$0.01/秒**，最低 **\$0.01**          |

其他操作均免费，包括各资源的查询、删除、列表、导出，以及 `POST /v1/renders/prepare`。

<a id="video-remix" />

## 视频重混

[视频重混](/zh/v1/guides/quickstart-mix)（`POST /v1/renders`）按**每个角色、每秒成品输出 \$0.01** 计费：

```
cost = $0.01 × characters in the render × finished duration in seconds
```

当前一次渲染仅支持一个角色来源（`image`、`image_url` 或 `character_id`），因此实际为 **\$0.01/秒成品视频**。例如 10 秒视频为 **\$0.10（10 积分）**。价格中的“每个角色”用于明确计价口径，当前不能请求多角色渲染，详见[渲染视频](/zh/v1/api-reference/renders/create)。

按最终视频的精确秒数计费，小数秒按比例计费，无单次最低消费。开始时依据输入预留预计费用，进入 `ready` 后按实际完成时长结算。

<a id="character" />

## 角色

以默认 `type=render` 创建[可复用角色](/zh/v1/api-reference/characters/create)，每个固定 **\$0.01（1 积分）**，与图片大小或 `name` 无关。

<a id="character-3d" />

## 3D 角色

`type=vsplat` 提取 3D 高斯泼溅模型，`all` 同时创建 2D 渲染素材：

| `type`                 | `enhance`   | 价格            |
| ---------------------- | ----------- | ------------- |
| `vsplat`               | `false`（默认） | 固定 **\$0.25** |
| `vsplat`               | `true`      | 固定 **\$0.30** |
| `all`（render + vsplat） | `false`     | 固定 **\$0.26** |
| `all`（render + vsplat） | `true`      | 固定 **\$0.31** |

`enhance` 只影响 vsplat，将 \$0.25 **替换**为 \$0.30，并非再加 \$0.30。`all` 为 \$0.01 的渲染素材费加上相应 vsplat 费用。`model_precision`、`filter_low_quality`、`joint_set` 和 `render_thumbnail` 不影响价格。就绪后通过[导出 3D 角色](/zh/v1/api-reference/characters/export)下载。

<a id="motion" />

## 动作

从上传文件或 URL 视频以默认 `type=render` 创建[动作](/zh/v1/api-reference/motions/create)，**不单独收取预处理费**，后续用于视频重混时再收取渲染费用。

<a id="motion-3d" />

## 3D 动作

`type=glb` 提取 3D 骨骼动画，`all` 同时保留 2D 素材。提取费用按**源视频时长**计算：

```
cost = $0.05 × ceil(source video duration in seconds)
```

时长先向上取整到整数秒再计费。例如纯计价计算中 0.3 秒按 1 秒计为 \$0.05（可上传时长仍以接口限制为准），10.1 秒按 11 秒计为 \$0.55。`all` 合并 GLB 提取费与免费的 2D 预处理。`enable_smoothing` 和 `target_fps` 不影响价格。就绪后通过[导出 3D 动作](/zh/v1/api-reference/motions/export)获取 `mixamo` 和 `metahuman` 两种骨架。

<a id="text-to-motion" />

## 文本生成动作

[从文本创建动作](/zh/v1/api-reference/motions/create-from-text)使用 JSON `text` 请求体，每次固定 **\$0.10（10 积分）**，与 `duration_seconds`、`guidance_scale` 或 `smooth` 无关。虽然文本生成动作的 `type` 也是 `glb`，但不采用上方视频提取的按时长计费方式。

<a id="h3-video" />

## H3 视频

`POST /v1/videos` 的四种 H3 模式价格一致：[文本](/zh/v1/api-reference/videos/create-from-text)、[首帧](/zh/v1/api-reference/videos/create-from-first-frame)、[首尾帧](/zh/v1/api-reference/videos/create-from-first-last-frame)及[参考素材](/zh/v1/api-reference/videos/create-from-reference-video)。

```
cost = $0.01 × ceil(duration_s)
```

`duration_s`（3–15，默认 `5`）向上取整后乘以单价。`quality`（`low` 生成更快，`high` 保真度更高）、`resolution` 和 `aspect_ratio` 均**不影响价格**，全部为 \$0.01/秒。每个视频自带原生音频，不额外收费。相同 `quality` 和 `duration_s` 下，首帧、尾帧或参考素材不会增加纯文本生成之外的费用。

<a id="character-animation" />

## Viggle-Animate

[使用 Viggle-Animate](/zh/v1/api-reference/videos/create-from-character-animation)也调用 `POST /v1/videos`，但通过 `driving_video_url`、`character_image_url` 或 `character_image_urls` 选择独立的角色动画后端，按固定价格计费：

```
cost = $0.11 (11 credits) per request
```

创建时按全额预留费用，与实际输出时长无关。本模式没有可调的 `duration_s`、`quality`、`resolution` 或 `aspect_ratio`。由于实际输出时长晚于积分预留才能确定，每个受理请求按最大可能输出统一计价，`watermark` 不影响价格。失败或取消时的释放规则见下方。

<a id="import-motion" />

## 导入动作

[导入动作](/zh/v1/api-reference/motions/import)将 Viggle 模板复制为账户中的可复用动作。按源模板时长 **\$0.01/秒** 收费，最低 **\$0.01（1 积分）**。此操作仅复制已有模板，不处理用户媒体，与视频重混、动作预处理和 3D 提取分别计价。

## 积分预留与结算

所有收费操作在**创建异步任务时**预留积分。视频重混按请求或预计时长估算，其他操作在请求时已确定价格。进入终态后结算：

* **`ready`：** 按最终价格结算。视频重混根据实际完成时长调整，其他操作保持原预留金额。这是唯一产生净扣费的结果。
* **`failed` 或 `cancelled`：** 释放预留，**不扣积分**。渲染的 `cancelled` 无法由客户端主动触发，但计费处理与失败一致，见[异步任务](/zh/v1/production/async-jobs)。
* **失败或取消后重试：** 新请求建立独立的预留。前一次未成功的任务不结算，因此不会重复计费。

<Note>
  这与旧提取接口的“创建时预留、成功时结算、失败时退回”规则一致。若某个 V1 资源表现不同，请记录 `error.code` 和 `request_id` 并联系支持。
</Note>

## 结果保留期限

`video_url`、`alpha_url`、`vsplat_url`、`thumbnail_url` 和 `glb_url` 签发后有效期为 **1 小时**。每次调用对应接口都会**重新签发有效期为 1 小时的链接**，例如[获取视频](/zh/v1/api-reference/videos/get)、[导出角色](/zh/v1/api-reference/characters/export)或[导出动作](/zh/v1/api-reference/motions/export)。

不要在一小时后继续使用缓存 URL；过期请求可能返回 `RESULT_EXPIRED`（`400`）。请及时下载成品，并为长期使用保存到自己的系统。以后需要链接时，重新调用同一导出、下载或获取接口。见[错误与恢复](/zh/v1/production/errors)。

## 失败任务

任务失败时检查 `error`，尤其是 `code`、`retryable` 和 `remediation`。不要假定失败任务已经产生可用输出，详见[错误与恢复](/zh/v1/production/errors)。