VIGGLE_API_KEY,并准备下方示例所需的角色图片和动作视频。
准备工作
- 在 Viggle 控制台创建 API 密钥,并导出为
VIGGLE_API_KEY。
示例中的
https://assets.viggle.ai/samples/... 是占位地址。请替换为自己的 image/image_url 和 motion_video/motion_video_url,或使用 Viggle 正式发布的示例素材。完整示例
输入
- 角色:
image(文件)、image_url,或角色快速入门中创建的可复用character_id。 - 动作:
motion_video(文件)、motion_video_url,或动作快速入门中创建的可复用motion_id。 background_mode:original(默认)、solid或transparent。bg_color:R,G,B格式的颜色,仅在solid模式下使用。
响应
stage 可能为 analyzing、rendering 或 finishing。任务完成后,status 为 ready,响应中包含 video_url。该签名链接有效期为 1 小时,每次读取都会重新签名;请及时下载,或再次调用获取视频以获取新链接。透明模式下还会返回 alpha_url。除轮询外,也可通过监听渲染的服务器发送事件(SSE)订阅同一生命周期。
视频重混的费用见计费与保留期限。
异步任务与失败处理
了解终态、轮询与结果保留期限。

