积分
1 积分 = $0.01。新账户初始获得 100 免费积分($1.00)。 通过查询积分查看余额,或在 Viggle 控制台管理账单。余额不足导致任务无法启动时,返回402 和 error.code: "INSUFFICIENT_CREDITS",详见错误与恢复。
价格一览
其他操作均免费,包括各资源的查询、删除、列表、导出,以及
POST /v1/renders/prepare。
视频重混
视频重混(POST /v1/renders)按每个角色、每秒成品输出 $0.01 计费:
image、image_url 或 character_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_precision、filter_low_quality、joint_set 和 render_thumbnail 不影响价格。就绪后通过导出 3D 角色下载。
动作
从上传文件或 URL 视频以默认type=render 创建动作,不单独收取预处理费,后续用于视频重混时再收取渲染费用。
3D 动作
type=glb 提取 3D 骨骼动画,all 同时保留 2D 素材。提取费用按源视频时长计算:
all 合并 GLB 提取费与免费的 2D 预处理。enable_smoothing 和 target_fps 不影响价格。就绪后通过导出 3D 动作获取 mixamo 和 metahuman 两种骨架。
文本生成动作
从文本创建动作使用 JSONtext 请求体,每次固定 $0.10(10 积分),与 duration_seconds、guidance_scale 或 smooth 无关。虽然文本生成动作的 type 也是 glb,但不采用上方视频提取的按时长计费方式。
H3 视频
POST /v1/videos 的四种 H3 模式价格一致:文本、首帧、首尾帧及参考素材。
duration_s(3–15,默认 5)向上取整后乘以单价。quality(low 生成更快,high 保真度更高)、resolution 和 aspect_ratio 均不影响价格,全部为 $0.01/秒。每个视频自带原生音频,不额外收费。相同 quality 和 duration_s 下,首帧、尾帧或参考素材不会增加纯文本生成之外的费用。
Viggle-Animate
使用 Viggle-Animate也调用POST /v1/videos,但通过 driving_video_url、character_image_url 或 character_image_urls 选择独立的角色动画后端,按固定价格计费:
duration_s、quality、resolution 或 aspect_ratio。由于实际输出时长晚于积分预留才能确定,每个受理请求按最大可能输出统一计价,watermark 不影响价格。失败或取消时的释放规则见下方。
导入动作
导入动作将 Viggle 模板复制为账户中的可复用动作。按源模板时长 $0.01/秒 收费,最低 $0.01(1 积分)。此操作仅复制已有模板,不处理用户媒体,与视频重混、动作预处理和 3D 提取分别计价。积分预留与结算
所有收费操作在创建异步任务时预留积分。视频重混按请求或预计时长估算,其他操作在请求时已确定价格。进入终态后结算:ready: 按最终价格结算。视频重混根据实际完成时长调整,其他操作保持原预留金额。这是唯一产生净扣费的结果。failed或cancelled: 释放预留,不扣积分。渲染的cancelled无法由客户端主动触发,但计费处理与失败一致,见异步任务。- 失败或取消后重试: 新请求建立独立的预留。前一次未成功的任务不结算,因此不会重复计费。
这与旧提取接口的“创建时预留、成功时结算、失败时退回”规则一致。若某个 V1 资源表现不同,请记录
error.code 和 request_id 并联系支持。结果保留期限
video_url、alpha_url、vsplat_url、thumbnail_url 和 glb_url 签发后有效期为 1 小时。每次调用对应接口都会重新签发有效期为 1 小时的链接,例如获取视频、导出角色或导出动作。
不要在一小时后继续使用缓存 URL;过期请求可能返回 RESULT_EXPIRED(400)。请及时下载成品,并为长期使用保存到自己的系统。以后需要链接时,重新调用同一导出、下载或获取接口。见错误与恢复。
失败任务
任务失败时检查error,尤其是 code、retryable 和 remediation。不要假定失败任务已经产生可用输出,详见错误与恢复。
