一张角色图，一段参考表演。
将一张角色图片与一段动作视频组合，生成角色演绎该动作的 MP4 视频。
Viggle API
用 Viggle 模型，构建你的产品。
Mix / Remix 动作迁移、Viggle-Animate 角色替换、单图高质量 3D 角色、视频或文字生成 3D 动作，以及带原生音频的 Viggle-Optimized Minimax H3。通过同一套 API，构建你的产品。
一把 API Key，资产可复用，含 100 免费积分。
Mix / Remix，让你的角色动起来。
Mix / Remix 将驱动视频中的表演迁移到你的角色图片，围绕你选择的动作，构建个性化视频、Remix 工具与粉丝互动体验。
角色图片驱动视频角色视频 · MP4
创建的资产，继续复用。
Character 与 Motion 资源创建一次，待其就绪后即可用资产 ID 组合出新的视频。
合成到你自己的场景中。
选择透明输出，获取主视频与独立的透明遮罩，接入你自己的合成流程。
Viggle-Animate，专为角色替换打造。
Viggle 专门后训练的角色替换模型。提供角色图片与驱动视频，让新角色演绎原有表演。
跟住快速动作，驾驭不同角色。
模型演示覆盖快速动作、极限姿态，以及人物、动物和风格化角色的替换。
保留原有表演。
在替换角色的同时，着重保留参考表演、镜头运动与节奏。
通过托管 API 接入产品。
提交一张角色图片与 5–15 秒驱动视频，每生成一秒计费 $0.01。
在 Hugging Face 查看模型
在 Hugging Face 查看模型权重、技术说明与社区应用。
一张照片，生成你能赋予生命的 3D 角色。
驱动 PINOC 角色生成的 Viggle 模型，能将一张图片变成高质量、已绑定的 3D 角色。为它赋予动作，再把它带进你的游戏或应用。
把角色的模样，带入 3D。
从照片、插画或概念图出发，生成高质量的 3D 角色。
生成后，即可赋予动作。
角色已完成绑定，可搭配从视频捕捉或文字生成的兼容动作。
让角色成为产品的一部分。
用用户自己生成的角色，构建个性化游戏、Avatar 与互动体验。
Viggle Survivor：让照片里的你成为游戏主角。
在 Viggle Survivor 中，一张照片就能变成你操控的英雄。你也可以构建这样的游戏，让玩家带着自己的角色加入其中。
探索 Viggle 游戏从视频或文字，生成 3D 动作。
捕捉一段表演，或描述一个动作。导出骨骼动画，让游戏、动画工具和 3D 应用中的角色动起来。
Viggle H3
Viggle H3：视频与原生音频，一起生成。
用 Viggle-Optimized Minimax H3，将提示词、首尾帧或视觉参考变成新视频。四种生成模式，让你的产品能用不同方式控制镜头。
文字生成视频
描述场景与动作，无需图片或视频输入，即可生成新镜头。
首帧生成视频
指定起始画面，用提示词控制接下来发生的动作。
首尾帧生成视频
提供起始与结束画面，控制镜头的两端。
参考视频与图片
用最多一段参考视频、四张参考图和提示词，引导主体或风格。
发起你的第一个请求。
获取 Key，在服务端运行所选工作流，待任务就绪后获取结果。
Video Remix
- 01
设置 API Key
在 Dashboard 创建 Key，并将其保存在服务端环境变量中。
- 02
提交操作
角色图片 + 动作视频，或可复用资产 ID
POST /v1/renders
- 03
轮询并读取结果
MP4 视频 + 可选的独立透明遮罩视频
GET /v1/videos/{render_id}
代码已包含示例素材，请在你自己的环境中运行。
需安装 curl 和 jq，并先设置 VIGGLE_API_KEY。
请勿在客户端代码或公开代码仓库中暴露 API Key。
完整可运行示例quickstart.shVideo Remix
set -eu
RENDER=$(curl -fsS -X POST "https://apis.viggle.ai/v1/renders" \
-H "Authorization: Bearer $VIGGLE_API_KEY" \
-F "image_url=https://assets.viggle.ai/pub/www/developers/threed-source-image-3f2f6787.webp" \
-F "motion_video_url=https://assets.viggle.ai/pub/www/developers/sample-motion-97bb074a.mp4")
RENDER_ID=$(printf '%s' "$RENDER" | jq -r '.id')
for _ in $(seq 1 60); do
VIDEO=$(curl -fsS "https://apis.viggle.ai/v1/videos/$RENDER_ID" \
-H "Authorization: Bearer $VIGGLE_API_KEY")
STATUS=$(printf '%s' "$VIDEO" | jq -r '.status')
[ "$STATUS" = "ready" ] && break
case "$STATUS" in
failed|cancelled) printf '%s\n' "$VIDEO" && exit 1 ;;
esac
sleep 5
done
[ "$STATUS" = "ready" ] || { printf 'Timed out waiting for %s\n' "$RENDER_ID" >&2; exit 1; }
printf '%s\n' "$VIDEO" | jq -r '.video_url'接入之前，先算清费用。
先估算所选操作的费用，再查看工作流中其他资产创建或导入的费率。
每次 Render 支持一个角色，按成品实际时长计费。
对比工作流费率
| 选择工作流 | 费用 | 你得到 |
|---|---|---|
| Video Remix | 每输出秒 $0.01 | MP4 视频 + 可选的独立透明遮罩视频 |
| Viggle-Animate | 每生成秒 $0.01 | 角色替换视频 |
| 图片生成 3D 角色 | 每个 $0.25 · 开启 enhance 为 $0.30 | 已绑定、可动画的 3D 角色（.vsplat） |
| 视频生成 3D 动作 | 每源视频秒 $0.05，时长向上取整 | GLB 或 FBX · Mixamo、MetaHuman、MetaHuman Body |
| 文字生成 3D 动作 | 每次请求 $0.10 | GLB 或 FBX · Mixamo、MetaHuman、MetaHuman Body |
| 可复用角色 | 每个 Character $0.01 | 可用于 Video Remix 的 Character ID |
| 可复用动作 | 预处理不单独收费 | 可用于 Video Remix 的 Motion ID |
| Viggle H3 | 每生成秒 $0.01 · 4K 为 $0.05 | 带原生音频的生成视频 |
| 参考素材生成视频 | 每生成秒 $0.01 · 4K 为 $0.05 | 带原生音频的生成视频 |
查询、列表、导出和删除免费；失败或取消的任务不会产生净扣费。
从第一个请求，走向产品接入。
在正式接入前，安排好异步任务、请求重试与结果存储。
跟踪任务状态
轮询直到资源就绪或失败；Render 还支持 SSE 状态事件，用于跟踪进度，不返回可播放的视频分片。
异步任务指南按接口规则安全重试
基于 draft 的 JSON Render 流程支持 Idempotency-Key；multipart Render 与其他操作需遵循各自的重试规则。
Render 与重试文档自行保存需要保留的结果
签名输出地址有效期为 1 小时；重新查询或导出可获取新地址，需要长期使用的成品请下载到自己的存储。
计费与结果有效期内容权利与商业使用
API 输入与输出为保密内容，不用于训练 Viggle 模型。你保留相关权利，并可在遵守 API 条款、拥有素材必要权利的前提下商业使用输出。
Viggle API 条款接入前，你可能想了解
如何开始接入？
在开发者 Portal 创建 API Key，新账户可获得 100 免费积分。将 Key 保存在服务端，选择上方工作流，并用代码中的示例素材运行。创建操作为异步任务，请等资源就绪后再使用输出。
应该选择 Video Remix 还是 Viggle-Animate？
Video Remix 可组合复用 Character 与 Motion，支持可选的透明遮罩，并按成品时长计费；每次 Render 接受一个角色。Viggle-Animate 是专门后训练的独立角色替换模型，模型权重发布在 Hugging Face。其托管 API 接受一张角色图片和 5–15 秒驱动视频，每生成一秒计费 $0.01，不能设置画质档位或分辨率。
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 的计费秒数向上取整；后者在 480p–2K 为每秒 $0.01，4K 为每秒 $0.05。Text-to-Motion 与 Viggle-Animate 按每次请求固定计费。查询与导出免费，失败或取消的任务不会产生净扣费。
如何跟踪进度并处理重试？
轮询文档指定的资源，直到就绪或失败。Render 还支持 SSE 状态事件，但不提供可播放的视频分片。Idempotency-Key 仅适用于基于 draft 的 JSON Render 流程，不适用于 multipart Render 提交；各操作需遵循文档的错误与重试说明。
输出地址可以使用多久？
签名输出地址签发后 1 小时内有效，重新查询或导出资源可获得新地址。请及时下载已完成的产物，需要保留的文件应存入你自己的系统。
输出能否商用？我的内容会被用于训练吗？
API 输入与输出为保密内容，不用于训练 Viggle 模型。你保留相关权利，并可在拥有所提交素材必要权利、遵守 Viggle API 条款的前提下商业使用输出。
让你的下一个创意，动起来。
构建 Remix 工具、Viggle-Animate 角色替换、3D 角色与动作，或使用 Viggle-Optimized Minimax H3 开发视频应用。用 100 免费积分，开始你的产品。