AI 舞蹈生成器 API：用代码生成 AI 舞蹈视频

AI Dance Generator 公开 API 让您可以通过编程方式生成舞蹈视频 — 从自己的应用程序、自动化脚本或工作流中直接调用。上传角色图片，提供参考舞蹈视频（或 TikTok 链接），AI 舞蹈视频生成器会完成剩下的工作。

无论您是构建内容创作流水线、将 AI 视频生成集成到产品中，还是自动化社交媒体工作流，Dance Generator REST API 都能让您完全控制舞蹈视频的创建过程。

本指南涵盖身份验证、所有可用端点、请求/响应示例，以及将 AI 舞蹈生成器 API 集成到项目中的最佳实践。

快速开始使用 Dance Generator API

1. 创建 API Key

登录您的 Dance Generator 账户，进入 设置 → API Keys，点击创建生成新密钥。

密钥格式为 sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx。请立即复制 — 它只会显示一次。

2. 身份验证

所有 API 请求都需要在 Authorization 头中携带 Bearer 令牌：

Authorization: Bearer sk-your-api-key-here

3. 基础 URL

https://dancegenerator.ai/api/v1

所有端点均以 /api/v1 为前缀。

AI 舞蹈生成器 API 端点

查询积分余额

在生成 AI 舞蹈视频前查看当前积分余额。

GET /api/v1/credits

示例：

curl https://dancegenerator.ai/api/v1/credits \
  -H "Authorization: Bearer sk-your-api-key"

响应：

{
  "remaining_credits": 500,
  "cost_reference": {
    "per_second": 7,
    "example_10s_video": 70
  }
}

费用计算方式：视频时长（秒）× 7 积分。

上传文件（图片或视频）

通过 presigned URL 上传角色图片或参考舞蹈视频。这个两步流程支持任意大小的文件 — 文件直接上传到存储服务，不经过 API 服务器。

POST /api/v1/upload/presign

格式： application/json
支持图片类型： JPG、PNG、WebP
支持视频类型： MP4、MOV

第一步 — 获取 presigned URL：

# 计算文件的 MD5 哈希值
MD5=$(md5sum character.jpg | cut -d' ' -f1)

# 请求 presigned 上传 URL
curl https://dancegenerator.ai/api/v1/upload/presign \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d "{\"md5\": \"$MD5\", \"content_type\": \"image/jpeg\"}"

响应：

{
  "presigned_url": "https://storage.example.com/...?X-Amz-Signature=...",
  "public_url": "https://file.dancegenerator.ai/uploads/abc123.jpg",
  "deduplicated": false
}

如果 deduplicated 为 true，文件已存在 — 跳过第二步，直接使用 public_url。
如果 deduplicated 为 false，使用 presigned_url 上传文件。

第二步 — 直接上传文件：

curl -X PUT "<第一步返回的 presigned_url>" \
  -H "Content-Type: image/jpeg" \
  --data-binary @character.jpg

请保存 public_url — 生成请求中需要用到。视频上传流程相同 — 只需将 content_type 改为 "video/mp4"（MOV 文件用 "video/quicktime"）。

生成 AI 舞蹈视频

这是 AI 舞蹈生成器 API 的核心端点。提交角色图片和参考舞蹈视频（或 TikTok 链接），通过 AI 生成舞蹈视频。

POST /api/v1/generate

请求体（JSON）：

字段	类型	必填	说明
`character_image_url`	string	是	角色图片 URL（通过上传接口获取）
`reference_video_url`	string	与 `tiktok_url` 二选一	参考舞蹈视频 URL
`tiktok_url`	string	与 `reference_video_url` 二选一	TikTok 视频链接作为舞蹈参考
`prompt`	string	否	生成提示词（最长 2500 字符）
`character_orientation`	string	否	`"image"`（默认，最长 10 秒）或 `"video"`（最长 30 秒）
`keep_original_sound`	boolean	否	保留参考视频原声（默认：`true`）

使用上传视频的示例：

curl https://dancegenerator.ai/api/v1/generate \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "character_image_url": "https://file.dancegenerator.ai/abc123.jpg",
    "reference_video_url": "https://file.dancegenerator.ai/videos/def456.mp4",
    "prompt": "让角色充满活力地跳舞",
    "character_orientation": "image"
  }'

使用 TikTok 链接的示例：

curl https://dancegenerator.ai/api/v1/generate \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "character_image_url": "https://file.dancegenerator.ai/abc123.jpg",
    "tiktok_url": "https://www.tiktok.com/@user/video/1234567890",
    "character_orientation": "image"
  }'

响应（201）：

{
  "task_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "pending",
  "cost_credits": 70,
  "remaining_credits": 430,
  "estimated_duration_seconds": 180,
  "created_at": "2026-03-09T10:00:00.000Z"
}

AI 舞蹈视频生成通常需要 2-3 分钟。使用任务 ID 轮询获取结果。

查询任务状态

轮询此端点以检查视频是否已完成。

GET /api/v1/tasks/:taskId

示例：

curl https://dancegenerator.ai/api/v1/tasks/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer sk-your-api-key"

响应（处理中）：

{
  "task_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "processing",
  "progress": 50,
  "result": null,
  "cost_credits": 70,
  "created_at": "2026-03-09T10:00:00.000Z",
  "completed_at": null,
  "error": null
}

响应（已完成）：

{
  "task_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "success",
  "progress": 100,
  "result": {
    "video_url": "https://..."
  },
  "cost_credits": 70,
  "created_at": "2026-03-09T10:00:00.000Z",
  "completed_at": "2026-03-09T10:03:22.000Z",
  "error": null
}

状态值说明：

状态	说明
`pending`	排队等待处理
`processing`	视频正在生成中
`success`	完成 — `result.video_url` 包含生成的视频
`failed`	生成失败 — 积分自动退还

任务列表

获取您的任务历史记录，支持分页和状态筛选。

GET /api/v1/tasks

查询参数：

参数	类型	默认值	说明
`status`	string	—	按状态筛选：`pending`、`processing`、`success`、`failed`
`page`	number	1	页码
`limit`	number	20	每页条数（最大 100）

示例：

curl "https://dancegenerator.ai/api/v1/tasks?status=success&page=1&limit=10" \
  -H "Authorization: Bearer sk-your-api-key"

响应：

{
  "tasks": [
    {
      "task_id": "550e8400-e29b-41d4-a716-446655440000",
      "status": "success",
      "cost_credits": 70,
      "created_at": "2026-03-09T10:00:00.000Z",
      "completed_at": "2026-03-09T10:03:22.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 42
  }
}

完整的 AI 舞蹈视频生成工作流

以下是通过 API 生成舞蹈视频的完整工作流，使用 curl 演示：

# 第一步：获取角色图片的 presigned URL
MD5=$(md5sum character.jpg | cut -d' ' -f1)
curl https://dancegenerator.ai/api/v1/upload/presign \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d "{\"md5\": \"$MD5\", \"content_type\": \"image/jpeg\"}"
# → 记录响应中的 "presigned_url" 和 "public_url"

# 第二步：直接上传文件（如果 deduplicated=true 则跳过）
curl -X PUT "<PRESIGNED_URL>" \
  -H "Content-Type: image/jpeg" \
  --data-binary @character.jpg

# 第三步：使用 TikTok 参考视频生成舞蹈视频
curl https://dancegenerator.ai/api/v1/generate \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "character_image_url": "YOUR_PUBLIC_URL",
    "tiktok_url": "https://www.tiktok.com/@dancer/video/1234567890"
  }'
# → 记录响应中的 "task_id"

# 第四步：轮询查询结果（重复直到状态为 "success" 或 "failed"）
curl https://dancegenerator.ai/api/v1/tasks/YOUR_TASK_ID \
  -H "Authorization: Bearer sk-your-api-key"
# → 当状态为 "success" 时，从 result.video_url 下载视频

API 错误处理

所有 Dance Generator API 错误遵循统一的 JSON 格式：

{
  "error": "error_code",
  "message": "可读的错误描述",
  "details": {}
}

常见错误码：

HTTP 状态码	错误码	说明
401	`invalid_api_key`	API Key 缺失、无效或已删除
402	`insufficient_credits`	积分不足 — 请充值
404	`task_not_found`	任务不存在或属于其他用户
415	`unsupported_media_type`	不支持的文件格式
422	`validation_error`	请求参数无效
500	`internal_error`	服务器错误 — 请稍后重试
502	`provider_error`	AI 服务暂时不可用

AI 舞蹈生成器 API 使用技巧

轮询间隔： 建议每 5-10 秒查询一次任务状态。大多数 AI 舞蹈视频在 2-3 分钟内完成。
积分退款： 如果舞蹈视频生成任务失败，积分会自动退还到您的账户。
TikTok 集成： 您可以直接传入 TikTok 链接作为舞蹈参考 — API 会自动处理视频的下载和处理。
文件去重： 重复上传相同文件会返回相同的 URL，不会占用额外存储空间。
支持跨域： 所有 API 端点都支持 CORS 跨域请求，可从浏览器应用中直接调用舞蹈生成器 API。

常见问题

什么是 AI Dance Generator API？

AI Dance Generator API 是一个 RESTful 公开 API，让开发者可以通过编程方式生成舞蹈视频。您提供角色图片和参考舞蹈视频，我们的 AI 会创建角色表演舞蹈动作的逼真动画。

舞蹈生成器 API 支持哪些视频格式？

API 接受 MP4 和 MOV 格式的参考视频，以及 JPG、PNG 和 WebP 格式的角色图片。您也可以直接传入 TikTok 链接，无需上传视频文件。

通过 API 生成舞蹈视频的费用是多少？

AI 舞蹈生成器采用按积分计费模式。每秒生成的视频消耗 7 个积分。例如，一个 10 秒的舞蹈视频需要 70 个积分。如果生成失败，积分会自动退还。

我可以在自己的应用中使用舞蹈生成器 API 吗？

可以。Dance Generator 公开 API 专为集成而设计。所有端点都支持 CORS，因此您可以从 Web 应用、移动端后台、自动化脚本或任何 HTTP 客户端调用。

AI 舞蹈生成器 API：用代码生成 AI 舞蹈视频

目录