3D 场景
描述一个场景，或提供一张 360° 全景图，即可获得可漫游的 3D 场景（.spz 高斯泼溅文件）；还能从任意机位生成新视角，并据此重建场景。
$0.01每个新视角（一张全景图计 6 个）查看代码
发起你的第一个请求。
获取 Key，在服务端运行所选工作流，待任务就绪后获取结果。
quickstart.sh
设置 API Key
在 Dashboard 创建 Key，并将其保存在服务端环境变量中。
set -eu提交操作
POST /v1/scenes/pano不超过 1,000 字符的文本提示词，或一张 360° 全景图
TASK=$(curl -fsS -X POST "https://apis.viggle.ai/v1/scenes/pano" \
-H "Authorization: Bearer $VIGGLE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"sessionId": "quickstart-'"$(date +%s)"'", "prompt": "A sunlit Scandinavian living room with a grey sofa and large windows", "quality": "low"}')轮询并读取结果
GET /v1/scenes/{task_id}可漫游的 3D 场景（.spz）· 全景图 · 带位姿的视角图
TASK_ID=$(printf '%s' "$TASK" | jq -r '.id')
for _ in $(seq 1 360); do
TASK=$(curl -fsS "https://apis.viggle.ai/v1/scenes/$TASK_ID" \
-H "Authorization: Bearer $VIGGLE_API_KEY")
STATUS=$(printf '%s' "$TASK" | jq -r '.status')
[ "$STATUS" = "ready" ] && break
case "$STATUS" in
failed|cancelled) printf '%s\n' "$TASK" && exit 1 ;;
esac
sleep 5
done
[ "$STATUS" = "ready" ] || { printf 'Timed out waiting for %s\n' "$TASK_ID" >&2; exit 1; }
printf '%s' "$TASK" | jq '{spz: .result.spz.url, panorama: .result.panorama.url}'费率
一张全景图计 6 个视角，提示词生成一个场景即 $0.06完整可运行示例需安装 curl 和 jq，并先设置 VIGGLE_API_KEY。
费率。
新账户含 100 免费积分，1 积分 = $0.01。
JST-2
Viggle 自研模型
- $0.01每个新视角（一张全景图计 6 个）提示词或 360° 全景生成 3D 场景可漫游的 3D 场景（.spz）· 全景图 · 带位姿的视角图
- $0.25每个 · 增强后 $0.30图片生成 3D 角色已绑定、可动画的 3D 角色（.vsplat）
- $0.05每源视频秒，向上取整视频生成 3D 动作GLB 或 FBX · Mixamo、MetaHuman、MetaHuman Body
- $0.10每次请求文字生成 3D 动作GLB 或 FBX · Mixamo、MetaHuman、MetaHuman Body
JST-1
Viggle 自研模型
- $0.01每输出秒Video RemixMP4 视频 + 可选的独立透明遮罩视频
- $0.01每个 Character可复用角色可用于 Video Remix 的 Character ID
- $0.00无单独预处理费用可复用动作可用于 Video Remix 的 Motion ID
Viggle 微调
基于开源模型
- $0.06每驱动视频秒（Normal）· Planner $0.08Viggle-Animate角色替换视频
- $0.02每生成秒（480p 文生视频）· 4K 最高 $0.13Viggle H3带原生音频的生成视频
- $0.03每生成秒（480p）· 4K 最高 $0.15参考素材生成视频带原生音频的生成视频
- $0.01每张 · 2K $0.02Viggle ImagePNG 图片，每个任务 1–6 张
查询、列表、导出和删除免费；失败或取消的任务不会产生净扣费。
如何开始接入？
在开发者 Portal 创建 API Key，新账户可获得 100 免费积分。将 Key 保存在服务端，选择上方工作流，并用代码中的示例素材运行。创建操作为异步任务，请等资源就绪后再使用输出。
应该选择 Video Remix 还是 Viggle-Animate？
Video Remix 可组合复用 Character 与 Motion，支持可选的透明遮罩，并按成品时长计费；每次 Render 接受一个角色。Viggle-Animate 是专门后训练的独立角色替换模型，模型权重发布在 Hugging Face。其托管 API 接受最多五张角色图片搭配 5–15 秒驱动视频，按 enhance_mode 计费：Normal 每秒 $0.06，默认的 Planner 每秒 $0.08，均按驱动视频秒数向上取整。预扣按驱动视频时长计算，完成后按成片秒数向上取整结算，不超过预扣金额，差额退回。不能设置画质档位或分辨率。
什么是 Viggle Image？
Viggle Image 根据文字提示词，每次请求生成一到六张 PNG 图片，可用最多八张参考图引导。1K 每张 $0.01，2K 每张 $0.02。请轮询任务直到就绪，并在 24 小时内下载图片。
3D 导出支持哪些格式和骨架？
图片生成的 3D 角色已绑定、可动画，以 .vsplat 格式导出。这类高斯泼溅资产通过 Viggle Splat Engine 渲染，不是标准 GLB 或 FBX 导入器所用的网格。动作则单独导出为 GLB 或 FBX，支持 Mixamo、MetaHuman 和 MetaHuman Body。Mixamo 动作需重定向到自有网格；生成的角色与 MetaHuman 动作组合时，需使用匹配的骨架。
文字生成的 Motion 能用于 Video Remix 吗？
不能。Text-to-Motion 仅生成 3D 动画，不具备视频渲染能力。Video Remix 需要受支持的驱动视频、具备视频渲染能力且已就绪的 Motion，或官方动作模板。
费用估算包含哪些项目？
计算器估算当前所选操作；另行创建 Character 或导入动作模板有各自费用。Video Remix 按成品实际时长结算，Motion 3D、Viggle-Optimized Minimax H3 和 Viggle-Animate 的计费秒数向上取整。H3 按生成秒数计费，单价随输入方式、分辨率和 enhance（默认开启）变化，从 480p 文生视频的 $0.02 起，到 4K 参考素材且开启 enhance 的 $0.15 止。Viggle-Animate 按驱动视频秒数、随 enhance_mode 计费（Normal 每秒 $0.06，Planner 每秒 $0.08），先预扣，完成后按成片时长向上取整结算，不超过预扣金额，差额退回。计算器按所示示例估算：H3 为文生视频，参考素材为开启 enhance，Viggle-Animate 为 Planner。Viggle Image 按图片数量计费（1K 每张 $0.01，2K 每张 $0.02），Text-to-Motion 按每次请求固定计费。查询与导出免费，失败或取消的任务不会产生净扣费。
如何跟踪进度并处理重试？
轮询文档指定的资源，直到就绪或失败。Render 还支持 SSE 状态事件，但不提供可播放的视频分片。Idempotency-Key 仅适用于基于 draft 的 JSON Render 流程，不适用于 multipart Render 提交；各操作需遵循文档的错误与重试说明。
输出地址可以使用多久？
签名输出地址签发后 1 小时内有效，重新查询或导出资源可获得新地址。生成的图片会在任务完成 24 小时后删除。请及时下载已完成的产物，需要保留的文件应存入你自己的系统。
输出能否商用？我的内容会被用于训练吗？
API 输入与输出为保密内容，不用于训练 Viggle 模型。你保留相关权利，并可在拥有所提交素材必要权利、遵守 Viggle API 条款的前提下商业使用输出。