--- name: mediaio-ai-dance-video-generator description: 使用 Media.io OpenAPI 生成 AI 舞蹈视频，使角色随音乐或编舞模板动态起舞。可创建富有节奏感的舞蹈动画。AI 舞蹈视频、舞蹈生成器 AI、AI 跳舞视频。 metadata: {"openclaw": {"homepage": "https://platform.media.io/docs/", "requires": {"bins": ["curl"], "env": ["MEDIAIO_API_KEY"]}, "primaryEnv": "MEDIAIO_API_KEY"}}

Media.io AI 舞蹈视频生成技能

概述

该技能调用 Media.io OpenAPI，使用模型代码 effects-video-babydance 执行舞蹈视频生成任务。 该 API 为异步接口：

1. 提交生成请求并获取 task_id。
2. 轮询任务结果接口，直至任务完成。

适用场景

• 用户希望基于一张图像和一段驱动视频生成舞蹈动画。
• 用户能提供 Media.io 服务器可访问的源 URL。
• 用户需要基于任务（task-based）的生成方式，并主动轮询状态。

不适用场景

• 用户仅要求本地文件上传（本 API 仅接受 URL 输入）。
• 用户要求使用非 Media.io 的服务提供商。
• 用户要求单次调用即返回实时同步的视频输出。

前提要求

环境变量

基础请求头

• Content-Type: application/json
• X-API-KEY: $MEDIAIO_API_KEY

支持的接口端点

1) 查询余额（Credits）

• 方法：POST
• 端点：https://openapi.media.io/user/credits
• 请求体：{}
• 用途：生成前检查可用余额。

2) 创建舞蹈视频任务

• 方法：POST
• 端点：https://openapi.media.io/generation/effects/effects-video-babydance
• 请求体：

{
	"data": {
		"image": "https://example.com/portrait.jpg",
		"video": "https://example.com/dance.mp4"
	}
}

• 必需字段：
  • data.image（字符串格式 URL）
  • data.video（字符串格式 URL）

3) 查询任务结果

• 方法：POST
• 端点：https://openapi.media.io/generation/result/{task_id}
• 请求体：{}
• 路径参数：
  • task_id（字符串，必需）

请求与响应契约

通用成功响应结构

{
	"code": 0,
	"msg": "",
	"data": {},
	"trace_id": "..."
}

创建任务响应

• 成功时返回 data.task_id。

任务结果响应

• data.status 可取以下值之一：
  • waiting：已入队列
  • processing：执行中
  • completed：成功完成
  • failed：失败
  • timeout：超时
• data.reason：提供附加上下文信息（例如 success 或具体错误消息）
• 当状态为 completed 时：
  • data.result 是一个输出对象数组，包含生成资源的公开 URL
  • 每个结果对象包含字段：val（内部路径）、preview（公开 HTTPS URL）、status（完成状态）

标准调用流程

1. 调用 user/credits 接口验证账户余额。
2. 调用 effects-video-babydance 接口，传入 data.image 和 data.video。
3. 提取响应中的 task_id。
4. 每隔 3 至 5 秒轮询一次 generation/result/{task_id} 接口。
5. 当状态变为 completed 或 failed 时停止轮询。
6. 若状态为 completed，从 data.result 中返回输出 URL。

cURL 示例

查询余额

curl --request POST 
	--url https://openapi.media.io/user/credits 
	--header 'Content-Type: application/json' 
	--header "X-API-KEY: $MEDIAIO_API_KEY" 
	--data '{}'

创建舞蹈视频任务

curl --request POST 
	--url https://openapi.media.io/generation/effects/effects-video-babydance 
	--header 'Content-Type: application/json' 
	--header "X-API-KEY: $MEDIAIO_API_KEY" 
	--data '{
	"data": {
		"image": "https://example.com/portrait.jpg",
		"video": "https://example.com/dance.mp4"
	}
}'

查询任务结果

curl --request POST 
	--url https://openapi.media.io/generation/result/ 
	--header 'Content-Type: application/json' 
	--header "X-API-KEY: $MEDIAIO_API_KEY" 
	--data '{}'

成功响应示例

{
	"code": 0,
	"msg": "",
	"data": {
		"task_id": "effect-3dbdb8ca-1f5e-4b1c-9c08-43a4a9bb8e2b",
		"status": "completed",
		"reason": "success",
		"result": [
			{
				"val": "aicloudtmp/550160908/3/202603/1/combo_tm_alg-20260317165022-802800-60eb3-dwt.mp4",
				"preview": "https://url_to_generated_image.png",
				"status": "completed"
			}
		]
	},
	"trace_id": "d63f54745ea24238bc6be4e6fe3d4937"
}

当状态为 completed 时，响应字段含义如下：

• data.task_id：唯一任务标识符
• data.status：completed 表示任务已成功完成
• data.reason：success 表示未发生错误
• data.result：输出对象数组，每个对象包含：
  • val：生成资源的内部文件路径
  • preview：生成资源的公开可访问 HTTPS URL
  • status：每个结果项的状态均为 completed

错误处理指南

• 将 code != 0 视为失败。
• 典型认证错误：
  • 374004：未通过身份验证。请前往 https://developer.media.io/ 申请 APP KEY。
• 典型请求校验错误：
  • 490000：参数错误
• 典型计费/余额错误：
  • 490505：余额不足。请在调用生成接口前完成充值。
• 日志中务必记录 trace_id，以便排查问题。

智能体行为要求

• 调用创建接口前，须校验输入中 image 和 video URL 均非空。
• 任务创建后不得声称已立即获得输出；必须始终通过 task_id 进行轮询。
• 若余额不足，应返回明确提示并终止流程，避免重试循环。
• 切勿在日志或响应中暴露原始 API 密钥。

安全与合规说明

• 仅处理用户提供的或经用户授权的媒体内容。
• 不得暗示生成视频具备身份核验能力或生物特征确定性。
• 生成内容属于合成媒体，须明确标注为编辑/合成内容。

参考资料

• Media.io 平台主页：https://developer.media.io/
• API 文档：https://platform.media.io/docs/