Skip to main content

积分

1 积分 = $0.01。新账户初始获得 100 免费积分($1.00)。 通过查询积分查看余额,或在 Viggle 控制台管理账单。余额不足导致任务无法启动时,返回 402error.code: "INSUFFICIENT_CREDITS",详见错误与恢复

价格一览

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

视频重混

视频重混POST /v1/renders)按每个角色、每秒成品输出 $0.01 计费:
当前一次渲染仅支持一个角色来源(imageimage_urlcharacter_id),因此实际为 $0.01/秒成品视频。例如 10 秒视频为 $0.10(10 积分)。价格中的“每个角色”用于明确计价口径,当前不能请求多角色渲染,详见渲染视频 按最终视频的精确秒数计费,小数秒按比例计费,无单次最低消费。开始时依据输入预留预计费用,进入 ready 后按实际完成时长结算。

角色

以默认 type=render 创建可复用角色,每个固定 $0.01(1 积分),与图片大小或 name 无关。

3D 角色

type=vsplat 提取 3D 高斯泼溅模型,all 同时创建 2D 渲染素材: enhance 只影响 vsplat,将 $0.25 替换为 $0.30,并非再加 $0.30。all 为 $0.01 的渲染素材费加上相应 vsplat 费用。model_precisionfilter_low_qualityjoint_setrender_thumbnail 不影响价格。就绪后通过导出 3D 角色下载。

动作

从上传文件或 URL 视频以默认 type=render 创建动作不单独收取预处理费,后续用于视频重混时再收取渲染费用。

3D 动作

type=glb 提取 3D 骨骼动画,all 同时保留 2D 素材。提取费用按源视频时长计算:
时长先向上取整到整数秒再计费。例如纯计价计算中 0.3 秒按 1 秒计为 $0.05(可上传时长仍以接口限制为准),10.1 秒按 11 秒计为 $0.55。all 合并 GLB 提取费与免费的 2D 预处理。enable_smoothingtarget_fps 不影响价格。就绪后通过导出 3D 动作获取 mixamometahuman 两种骨架。

文本生成动作

从文本创建动作使用 JSON text 请求体,每次固定 $0.10(10 积分),与 duration_secondsguidance_scalesmooth 无关。虽然文本生成动作的 type 也是 glb,但不采用上方视频提取的按时长计费方式。

H3 视频

POST /v1/videos 的四种 H3 模式价格一致:文本首帧首尾帧参考素材
duration_s(3–15,默认 5)向上取整后乘以单价。qualitylow 生成更快,high 保真度更高)、resolutionaspect_ratio不影响价格,全部为 $0.01/秒。每个视频自带原生音频,不额外收费。相同 qualityduration_s 下,首帧、尾帧或参考素材不会增加纯文本生成之外的费用。

Viggle-Animate

使用 Viggle-Animate也调用 POST /v1/videos,但通过 driving_video_urlcharacter_image_urlcharacter_image_urls 选择独立的角色动画后端,按固定价格计费:
创建时按全额预留费用,与实际输出时长无关。本模式没有可调的 duration_squalityresolutionaspect_ratio。由于实际输出时长晚于积分预留才能确定,每个受理请求按最大可能输出统一计价,watermark 不影响价格。失败或取消时的释放规则见下方。

导入动作

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

积分预留与结算

所有收费操作在创建异步任务时预留积分。视频重混按请求或预计时长估算,其他操作在请求时已确定价格。进入终态后结算:
  • ready 按最终价格结算。视频重混根据实际完成时长调整,其他操作保持原预留金额。这是唯一产生净扣费的结果。
  • failedcancelled 释放预留,不扣积分。渲染的 cancelled 无法由客户端主动触发,但计费处理与失败一致,见异步任务
  • 失败或取消后重试: 新请求建立独立的预留。前一次未成功的任务不结算,因此不会重复计费。
这与旧提取接口的“创建时预留、成功时结算、失败时退回”规则一致。若某个 V1 资源表现不同,请记录 error.coderequest_id 并联系支持。

结果保留期限

video_urlalpha_urlvsplat_urlthumbnail_urlglb_url 签发后有效期为 1 小时。每次调用对应接口都会重新签发有效期为 1 小时的链接,例如获取视频导出角色导出动作 不要在一小时后继续使用缓存 URL;过期请求可能返回 RESULT_EXPIRED400)。请及时下载成品,并为长期使用保存到自己的系统。以后需要链接时,重新调用同一导出、下载或获取接口。见错误与恢复

失败任务

任务失败时检查 error,尤其是 coderetryableremediation。不要假定失败任务已经产生可用输出,详见错误与恢复