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 发布示例素材后使用其正式地址。创建、轮询并导出角色
响应
GET /v1/characters/{character_id},直到 status 为 ready 或 failed。就绪后,请求 GET /v1/characters/{character_id}/export?download_type=vsplat 获取签名链接 vsplat_url。链接有效期为 1 小时,每次调用都会重新签名,请重新获取而非长期缓存。创建时可添加 enhance=true 以使用更高质量的提取流程(费用不同,见下方),或添加 render_thumbnail=true,以便在同一次导出响应中获取 thumbnail_url。
vsplat、enhance 和 all 的费用见计费与保留期限。
从图片创建角色
查看全部请求参数,包括
model_precision、filter_low_quality 和 joint_set。
