Viggle API V1 - Viggle API

V1 是当前版本的 API。 新项目请使用 V1。已有的 /api/* 接入可按照迁移指南升级。

Viggle API 以可复用素材、异步操作和输出文件为核心。角色（Character）和动作（Motion）只需创建一次，即可用于多个渲染任务（Render）。Render 代表一次操作，其 MP4 和可选的 Alpha 视频是该操作的输出文件。

创建第一个渲染任务

获取 API 密钥

在 Viggle 控制台创建 API 密钥。

创建渲染任务

向 POST /v1/renders 上传图片和动作视频。

等待结果

轮询 GET /v1/videos/{render_id}，直到 status 为 ready，然后使用 video_url。

将角色图片和动作视频合成为成品视频。

从动作视频提取可下载的 3D（GLB）动画。

结合参考视频或图片与文本提示词生成视频。

在一次请求中上传图片和动作视频，适合首次体验或一次性任务。

创建角色和动作后，在后续渲染请求中引用其 ID。

概念	含义
角色（Character）	从图片创建的可复用角色，ID 以 `char_` 开头。`type=vsplat`/`all` 还会提取 3D 高斯泼溅模型。
动作（Motion）	从视频提取或从文本生成的可复用驱动动作，ID 以 `mot_` 开头。`type=glb`/`all` 还会提取或生成 3D 动画。
渲染任务（Render）	一次异步视频生成任务，ID 以 `render_` 开头。
动作模板（Motion Template）	Viggle 官方动作，可通过模板 ID 直接用于渲染，也可导入为自己的动作资源。

安全地发送 API 密钥。

浏览全部 V1 资源。

处理异步任务和失败。