img_uuid,并通过轮询或 HTTPS 回调处理异步结果。AI Dance Move API
通过 GoEnhance 使用 AI Dance Move API,利用参考舞蹈视频中的动作,让一张源图片中的人物动起来。同时提交两个公网 URL,选择 480p 或 720p,保存返回的
创建 API Key
用参考舞蹈动作驱动人像
提交前验证源 URL、时长、分辨率和完成处理方式。
AI Dance Move API 能力与限制
精确的模型标识符
对于此路由,将
model 设置为 ai_dance_move。两个必填的媒体 URL
为人物提供
image_url,为参考舞蹈提供 video_url。30 秒输入限制
参考舞蹈视频不得超过 30 秒;更长的输入会被拒绝。
480p 或 720p 输出
选择
480p 或 720p。文档规定的默认值为 480p。异步任务 ID
提交成功后返回
data.img_uuid,而不是成品视频。轮询或回调
轮询任务详情端点,或提供公网 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 使用案例
创作者舞蹈片段
将已获批准的全身照转换为由所选参考动作驱动的简短舞蹈概念。
角色动作研究
在更大规模制作之前,测试原创角色或表演者在运动中的呈现效果。
活动概念变体
为创意审核队列参数化源图像和已批准的编舞参考。
音乐视频预可视化
在投入时间进行最终拍摄或剪辑之前,先探索舞蹈方向和取景。
本地化社交创意
通过一条经过验证的提交和完成流水线处理区域源资产。
自动化媒体工作流
在您的应用中集成生成、任务状态持久化、回调处理、存储和人工审批。
关于输入、定价、时长、分辨率和异步交付的解答。
AI Dance Move API 常见问题
AI Dance Move API 使用哪个端点?
发送一个经过授权的 POST 请求到 https://api.goenhance.ai/api/v1/videos/generations,并将 model 设置为 ai_dance_move。
需要哪些输入?
请求需要为人物提供 image_url,并为参考舞蹈提供 video_url。这两个值都必须是有效的 URL。
AI Dance Move API 定价是如何运作的?
计费按输入参考视频的向上取整时长计算:480p 为每秒 2 token,720p 为每秒 4 token。当前文档将五秒分别列为 $0.20 或 $0.40。
参考舞蹈视频的时长限制是多少?
文档规定的最大时长是30秒。更长的video_url输入将被拒绝。
有哪些可用的输出分辨率?
文档中说明的选项为480p和720p,其中480p为默认。分辨率还决定了每秒的token速率。
请求是否立即返回完整的舞蹈视频?
不。成功提交会返回data.img_uuid。使用该标识符配合GET /api/v1/jobs/detail,或配置回调,以获取最终结果。
GoEnhance 回调如何运作?
提供可公开访问的 HTTPS custom_callback_url。GoEnhance 会发送处理中、成功和失败状态的更新;对于非 200 响应,文档规定最多重试三次,每次尝试超时三秒。
这是某个独立舞蹈应用或模型供应商的官方 API 吗?
本页面记录了 GoEnhance 中模型标识符为 ai_dance_move 的路由。它不声称与任何独立的舞蹈平台或模型供应商存在隶属关系、合作关系,也不声称获得其认可。


