Skip to main content
创建角色时设置 type=vsplat,可提取 3D 高斯泼溅模型(.vsplat),而不是用于视频渲染的 2D 角色。就绪后,通过导出 3D 角色获取签名下载链接。若还想在同一个角色中保留 2D 渲染能力,请改用 type=all;仅需 2D 角色时,请参阅角色快速入门 设置环境变量 VIGGLE_API_KEY,并准备下方示例所需的角色图片。

准备工作

  • Viggle 控制台创建 API 密钥,并导出为环境变量 VIGGLE_API_KEY
示例中的 https://assets.viggle.ai/samples/character.png 是占位地址。请替换为自己的 image/image_url,或在 Viggle 发布示例素材后使用其正式地址。

创建、轮询并导出角色

响应

每 3 秒轮询 GET /v1/characters/{character_id},直到 statusreadyfailed。就绪后,请求 GET /v1/characters/{character_id}/export?download_type=vsplat 获取签名链接 vsplat_url。链接有效期为 1 小时,每次调用都会重新签名,请重新获取而非长期缓存。创建时可添加 enhance=true 以使用更高质量的提取流程(费用不同,见下方),或添加 render_thumbnail=true,以便在同一次导出响应中获取 thumbnail_url vsplatenhanceall 的费用见计费与保留期限

从图片创建角色

查看全部请求参数,包括 model_precisionfilter_low_qualityjoint_set