img_uuid,并通过轮询或 HTTPS 回调处理异步结果。AI Dance Move API
通过 GoEnhance 使用 AI Dance Move API,利用参考舞蹈视频中的动作,让一张源图片中的人物动起来。同时提交两个公网 URL,选择 480p 或 720p,保存返回的
创建 API Key
用参考舞蹈动作驱动人像
提交前验证源 URL、时长、分辨率和完成处理方式。
AI Dance Move API 能力与限制
精确的模型标识符
对于此路由,将 <code>model</code> 设置为 <code>ai_dance_move</code>。
两个必填的媒体 URL
为人物提供 <code>image_url</code>,为参考舞蹈提供 <code>video_url</code>。
30 秒输入限制
参考舞蹈视频不得超过 30 秒;更长的输入会被拒绝。
480p 或 720p 输出
选择 <code>480p</code> 或 <code>720p</code>。文档规定的默认值为 <code>480p</code>。
异步任务 ID
提交成功后返回 <code>data.img_uuid</code>,而不是成品视频。
轮询或回调
轮询任务详情端点,或提供公网 HTTPS 回调 URL 以接收状态变更。
GoEnhance 按输入参考视频的每个向上取整秒数,以所选输出分辨率计费。
AI Dance Move API 定价
480p:每秒 2 tokens
一个 5 秒的输入是 10 tokens,在当前 GoEnhance 文档中显示为 $0.20。
720p:每秒 4 tokens
一个 5 秒的输入是 20 tokens,在当前 GoEnhance 文档中显示为 $0.40。
根据输入时长估算
将输入视频时长向上取整到整秒,然后按 480p 乘以 2 tokens,或按 720p 乘以 4 tokens。在生产批次前查看实时定价参考。
分六步集成 AI 舞蹈动作 API
1
1. 创建并妥善保管 API Key
创建 GoEnhance 密钥,并从受信任的服务器端代码发送授权。
2
2. 托管源媒体
提供一张人物图片和一个参考舞蹈视频的公开可访问 URL,视频时长不超过 30 秒。
3
3. 构建请求
向
https://api.goenhance.ai/api/v1/videos/generations 发送 POST 请求,包含 model: ai_dance_move、两个 URL 以及 480p 或 720p 分辨率。 4
4. 保存任务标识符
在离开请求处理器之前,确认响应级成功并持久化返回的
data.img_uuid。 5
5. 跟踪每个状态
轮询
GET /api/v1/jobs/detail,或在公共 HTTPS 回调 URL 接收处理中、成功和失败事件。 6
6. 处理最终结果
对成功和失败进行幂等处理,验证返回的媒体,并在轮询和回调重叠时避免重复的下游工作。
围绕您获准使用的源媒体构建受控的运动迁移工作流。
AI 舞蹈动作 API 使用案例
创作者舞蹈片段
将已获批准的全身照转换为由所选参考动作驱动的简短舞蹈概念。
角色动作研究
在更大规模制作之前,测试原创角色或表演者在运动中的呈现效果。
活动概念变体
为创意审核队列参数化源图像和已批准的编舞参考。
音乐视频预可视化
在投入时间进行最终拍摄或剪辑之前,先探索舞蹈方向和取景。
本地化社交创意
通过一条经过验证的提交和完成流水线处理区域源资产。
自动化媒体工作流
在您的应用中集成生成、任务状态持久化、回调处理、存储和人工审批。
关于输入、定价、时长、分辨率和异步交付的解答。


