ai_dance_replace，将参考舞蹈视频中的人物替换为单张源图中的人物，同时保留参考动作。提交异步任务，保存其 img_uuid，然后轮询或通过回调获取完成状态。面向动作驱动视频的 AI Dance Replace API
通过 GoEnhance API 使用
获取 API 密钥
构建人物替换舞蹈视频工作流
提交前请校验精确的模型标识符、媒体 URL 和输出分辨率。
AI Dance Replace API 能力与输入
精确的模型标识符
将 <code>model</code> 设置为 <code>ai_dance_replace</code>；这是必填请求字段。
必填的人物图像
将 <code>image_url</code> 作为有效的公共 URI 传入，用于指定将出现在输出中的人物。
必填的舞蹈视频
将 <code>video_url</code> 作为公共参考视频传入，时长不得超过文档规定的 30 秒上限。
两种分辨率选项
选择 <code>480p</code> 或 <code>720p</code>。文档中的默认值为 <code>480p</code>。
可选的回调投递
添加一个公共的 HTTPS <code>custom_callback_url</code>，以接收处理中、成功和失败的状态更新。
异步任务响应
成功提交后返回 <code>img_uuid</code>；请保存该值，用于状态检查和结果处理。
计费使用输入视频向上取整后的时长。根据所选分辨率和计费秒数计算成本。
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. 处理终态
以幂等方式处理成功和失败，验证返回的资源，并避免重复下游工作。
在创作者工具、营销活动制作和可重复的视频自动化中，使用注重授权的媒体流水线。
舞蹈替换视频的开发者用例
创作者舞蹈模板
让用户在引导式创作流程中，将已批准的人物图片应用到已授权的参考舞蹈上。
营销活动视频变体
从已批准的源媒体生成主体变体，用于内部审核和下游编辑。
角色表演测试
在制作前，探索提供的角色图像如何跟随既有动作参考。
本地化创作者素材
将同一个已批准的舞蹈参考复用于不同授权主体，以支持区域内容流水线。
自动化内容队列
将任务 ID 和回调接入批处理编排，避免阻塞应用请求线程。
动作体验原型
在投入定制采集流水线前，验证图像+动作的产品概念。
关于常见输入、定价、状态、回调和集成问题的解答。