Skip to main content

积分

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、joint_set 和 render_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_smoothing 和 target_fps 不影响价格。就绪后通过导出 3D 动作获取 mixamo 和 metahuman 两种骨架。

文本生成动作

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

H3 视频

POST /v1/videos 的四种 H3 模式价格一致:文本、首帧、首尾帧及参考素材,由 duration_s 和 resolution 决定:
duration_s(5–15,默认 5)向上取整后乘以单价。resolution(480p、768p、1080p、2k 或 4k,默认 768p)决定单价——除 4k 外均为 $0.01/秒(1 积分),4k 为 $0.05/秒(5 积分)。quality(low 生成更快,high 保真度更高)和 aspect_ratio 不影响价格——相同分辨率下两档画质单价一致。enhance(可选的 AI 提示词改写,见从文本生成视频)同样不影响价格。每个视频自带原生音频,不额外收费。相同 quality、resolution 和 duration_s 下,首帧、尾帧或参考素材不会增加纯文本生成之外的费用。

Viggle-Animate

使用 Viggle-Animate也调用 POST /v1/videos,通过 character_image/character_image_url/character_image_urls 以及可选的 driving_video/driving_video_url 选择独立的角色动画后端,按 1 积分/秒计费:
  • 提供驱动视频:提交时测量驱动视频时长,预留 5–16 积分($0.05–$0.16)。5–15 秒的时长校验先截断为整数秒,因此 15.9 秒的视频可以通过校验,并预留 16 积分。
  • 未提供驱动视频(仅图片):无可测量的时长,每个请求固定预留 11 积分($0.11)。
视频 ready 后按成片时长以同一单价结算,且不超过预留金额——结算只会退还,不会多扣。本模式没有可调的 duration_s、quality、resolution 或 aspect_ratio。watermark 不影响价格。失败或取消时的释放规则见下方。

Viggle Image

生成图片(POST /v1/images)按张计费,单价由 resolution 决定:
1K 每张 $0.01(1 积分),2K 每张 $0.02(2 积分),共 n 张(1–6),例如 2K、n=3 为 $0.06(6 积分)。aspect_ratio、seed 和参考图不影响价格;带参考图时 2K 的输出尺寸较小,但单价不变。创建时一次性预扣全部费用,余额不足返回 402 INSUFFICIENT_CREDITS,任务不会开始生成。任务要么 n 张全部生成并扣费,要么整体失败并全额退回,即使失败前已生成了部分图片。

导入动作

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

积分预留与结算

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

结果保留期限

video_url、alpha_url、vsplat_url、thumbnail_url,动作导出的 mixamo_url/metahuman_url/metahuman_body_url,以及生成图片的 images[].url 签发后有效期为 1 小时。每次调用对应接口都会重新签发有效期为 1 小时的链接,例如获取视频、导出角色或导出动作或查询图片。 生成的图片在任务结束 24 小时后删除。之后查询图片仍可查到任务,但每个 images[].url 为 null,请在此之前下载。 不要在一小时后继续使用缓存 URL;过期请求可能返回 RESULT_EXPIRED(400)。请及时下载成品,并为长期使用保存到自己的系统。以后需要链接时,重新调用同一导出、下载或获取接口。见错误与恢复。

失败任务

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