面向动作驱动视频的 AI Dance Replace API

通过 GoEnhance API 使用 ai_dance_replace,将参考舞蹈视频中的人物替换为单张源图中的人物,同时保留参考动作。提交异步任务,保存其 img_uuid,然后轮询或通过回调获取完成状态。
获取 API 密钥
舞者在电影级制作棚中表演,用于 AI Dance Replace API 工作流

构建人物替换舞蹈视频工作流

定义替换人物

提供一个公共的 image_url。该图像中的人物将成为生成舞蹈视频中的主体,因此请在提交前校验 URL。
舞蹈替换 API 所用人像图的拍摄设置

从舞蹈视频驱动动作

提供一个包含参考舞蹈的公共 video_url。文档限制为 30 秒;超过该时长的视频会被拒绝。
舞者与电影摄影机为 AI 舞蹈替换工作流捕捉动作
提交前请校验精确的模型标识符、媒体 URL 和输出分辨率。

AI Dance Replace API 能力与输入

精确的模型标识符

将 model 设置为 ai_dance_replace;这是必填请求字段。

必填的人物图像

将 image_url 作为有效的公共 URI 传入,用于指定将出现在输出中的人物。

必填的舞蹈视频

将 video_url 作为公共参考视频传入,时长不得超过文档规定的 30 秒上限。

两种分辨率选项

选择 480p 或 720p。文档中的默认值为 480p。

可选的回调投递

添加一个公共的 HTTPS custom_callback_url,以接收处理中、成功和失败的状态更新。

异步任务响应

成功提交后返回 img_uuid;请保存该值,用于状态检查和结果处理。
计费使用输入视频向上取整后的时长。根据所选分辨率和计费秒数计算成本。

AI Dance Replace API 定价

480p 定价

每个输入视频秒消耗 2 个 token,按每个 token $0.02 计算,即每秒 $0.04,每 5 秒 $0.20。

720p 定价

每个输入视频秒消耗 4 个 token,按每个 token $0.02 计算,即每秒 $0.08,每 5 秒 $0.40。

按时长计费

计费时输入视频时长向上取整;估算成本时,使用计费秒数乘以所选费率。

六步集成 GoEnhance API

1

1. 创建 API 密钥

创建 GoEnhance API 密钥,并将其作为 bearer token 放在 Authorization 请求头中发送。
2

2. 验证两个媒体 URL

确认人物图片和舞蹈视频可公开访问,且视频时长不超过 30 秒。
3

3. 构建请求

设置 model: ai_dance_replace,添加 image_url 和 video_url,然后选择 480p 或 720p。
4

4. 提交任务

将 JSON 请求体 POST 到 https://api.goenhance.ai/api/v1/videos/generations。
5

5. 持久化并跟踪

保存返回的 img_uuid,然后轮询 GET /api/v1/jobs/detail 或接收回调事件。
6

6. 处理终态

以幂等方式处理成功和失败,验证返回的资源,并避免重复下游工作。
获取 API 密钥
在创作者工具、营销活动制作和可重复的视频自动化中,使用注重授权的媒体流水线。

舞蹈替换视频的开发者用例

创作者舞蹈模板

让用户在引导式创作流程中,将已批准的人物图片应用到已授权的参考舞蹈上。

营销活动视频变体

从已批准的源媒体生成主体变体,用于内部审核和下游编辑。

角色表演测试

在制作前,探索提供的角色图像如何跟随既有动作参考。

本地化创作者素材

将同一个已批准的舞蹈参考复用于不同授权主体,以支持区域内容流水线。

自动化内容队列

将任务 ID 和回调接入批处理编排,避免阻塞应用请求线程。

动作体验原型

在投入定制采集流水线前,验证图像+动作的产品概念。
关于常见输入、定价、状态、回调和集成问题的解答。

AI Dance Replace API 常见问题

AI Dance Replace API 使用哪个端点?

使用 model: ai_dance_replace、公开的 image_url 和公开的 video_url,向 POST https://api.goenhance.ai/api/v1/videos/generations 发送请求。

AI Dance Replace API 如何定价?

定价基于向上取整的输入视频时长:480p 为每秒 2 个 token,720p 为每秒 4 个 token,分别等于每 5 秒 $0.20 和 $0.40。

哪些字段是必填的?

文档中的必填字段为 model、image_url 和 video_url。分辨率和回调 URL 为可选。

参考舞蹈视频的时长限制是多少?

文档规定的最大时长为 30 秒。提交前请校验时长,因为更长的视频会被拒绝。

支持哪些输出分辨率?

该端点接受 480p 和 720p。如果省略,文档规定的默认值为 480p。

如何查看任务状态?

持久化返回的 img_uuid,并轮询 GET /api/v1/jobs/detail,或提供公开的 HTTPS 回调 URL。

回调失败如何处理?

GoEnhance 规定,当你的回调端点未返回 HTTP 200 时,最多重试三次,每次尝试的超时时间为三秒。

我的应用需要哪些权限?

仅使用你有权处理的图片和舞蹈视频,并从源媒体中的可识别个人处获得适当的同意。

使用 AI Dance Replace API 构建

AI Dance Replace API 定价与集成 | GoEnhance