Free Exercise DB with Videos

一个免费、开源的锻炼数据库和REST API，包含真实的男性和女性演示视频。提供317个锻炼动作、593个全高清演示视频（男性和女性），以及每个动作的逐步说明、形式提示、常见错误、呼吸注释和缩略图。无需API密钥，无数据库要求，采用MIT许可证，一键自托管。

A free, open-source exercise database and REST API featuring authentic male and female demonstration videos. It offers 317 exercise movements, 593 Full HD demonstration videos for both genders, along with step-by-step instructions, form tips, common mistakes, breathing notes, and thumbnails for each exercise. No API key is required, no database setup is needed, it is licensed under the MIT License, and supports one-click self-hosting.

原始信息汇总

数据集概述：Free Exercise DB with Videos

这是一个免费、开源的健身动作数据库及 REST API，包含真人演示视频。

核心数据规模

• 动作数量：317 个
• 演示视频：总计 593 个，均为 1920×1080 全高清（Full-HD）MP4 格式
  • 男性视频：290 个
  • 女性视频：303 个
• 缩略图：每个动作配有一个男性模型缩略图（JPG 格式）
• 动作难度：分为初学者（beginner）、中级（intermediate）、高级（advanced）三个等级
• 身体部位：覆盖 10 个身体部位
• 器材类型：覆盖 13 种器材类型

每条动作的字段信息

每个动作（以 JSON 格式存储）包含以下完整字段：

• id：唯一标识
• name：动作名称
• aliases：别名
• bodyPart：锻炼的身体部位
• target：目标肌肉
• secondaryMuscles：次要肌肉
• equipment：使用的器材
• difficulty：难度等级
• compound：是否为复合动作
• unilateral：是否为单侧动作
• shortDescription：简短描述
• instructions：完整指导说明
• steps：分步步骤详解
• formCues：动作姿势提示
• commonMistakes：常见错误
• breathing：呼吸注意事项
• videos：男女演示视频 URL（male 和 female）
• thumbnails：男女缩略图 URL（male 和 female）

API 参考

• 基础路径：/api/v1
• 认证：无需 API 密钥
• 响应格式：JSON 结构 { success, count?, data }
• 主要端点：
  • GET /api/v1/exercises：列表与筛选（支持 bodyPart, equipment, target, difficulty, search, limit, offset 参数）
  • GET /api/v1/exercises/:id：按 ID 获取单个动作
  • GET /api/v1/search?q=：按名称、别名、目标或肌肉搜索
  • GET /api/v1/bodyparts：身体部位分类及计数
  • GET /api/v1/equipment：器材分类及计数
  • GET /api/v1/targets：目标肌肉分类及计数
• OpenAPI 规范：仓库根目录包含 openapi.yaml 文件

数据集文件结构与托管

• 完整数据集文件：data/exercises.json
• 单动作文件：data/exercises/<id>.json
• 按身体部位分类文件：data/by-bodypart/<part>.json
• 视频与缩略图：可通过脚本 bash scripts/download-all-videos.sh 下载到本地 ./videos/{male,female}/*.mp4 和 ./thumbnails/{male,female}/*.jpg
• 托管：支持一键部署到 Vercel（无需数据库，无需 API 密钥），代码基于 MIT 许可证
• CDN：视频默认从零出口流量的 CDN 提供；如需自托管，可下载后更新 URL

演示实例

• 网站：https://exercise-database.zenithfits.com
• API：https://exercise-database.zenithfits.com/api/v1/exercises
• 演示实例仅供测试评估，生产环境建议自行克隆部署

搜集汇总

数据集介绍

构建方式

在健身与运动科学领域，高质量的动作示范视频与结构化训练数据始终是研究者和开发者寻求的资源。Free Exercise DB with Videos 通过整合317项常见健身动作，并为每项动作分别录制男性与女性模特的全高清（1920×1080）示范视频，构建了一个开放且全面的数据库。每项动作均包含详尽的元数据，如分步指导、动作要点、常见错误、呼吸提示及缩略图。数据集以静态JSON格式存储于仓库中，无需依赖外部数据库，用户只需克隆仓库并执行简单的安装命令即可搭建本地或云端服务。

特点

该数据集的核心亮点在于其丰富的视觉素材与精细的教学注释。项目共收录593段真人示范视频，覆盖10个身体部位和13种器械类型，且视频分辨率均达到全高清标准。相较于其他免费健身API仅提供文字或动图，本数据集为每项动作提供了面向男性与女性的独立视频，极大增强了教学的真实性与包容性。此外，每项动作还配备了结构化的动作要点、常见错误和呼吸指导，这些由专业团队生成和整理的元数据，使其成为健身应用开发、运动分析研究及AI训练中不可多得的资源。

使用方法

使用者可通过RESTful API方便地访问该数据集。API端点无需身份验证，支持按身体部位、器械、目标肌肉、难度级别等维度进行筛选与分页查询，返回包含视频链接、缩略图及完整教学信息的JSON数据。本地部署仅需执行'git clone'、'npm install'和'npm run dev'三步命令，即可在本地运行。此外，项目提供一键部署至Vercel的选项，并附带Shell脚本用于批量下载所有视频与缩略图至本地，满足离线使用或自建CDN的需求。

背景与挑战

背景概述

Free Exercise DB with Videos 是一个于近年创建并开源的综合性锻炼动作数据库与REST API，由开发者 Amiin Wani 主导构建。该数据集的核心研究问题在于填补现有免费锻炼API在高质量演示视频方面的空白——大多数同类资源仅提供动作名称或GIF示意图，缺乏真实、全面的可视化指导。项目收录了317个锻炼动作，并针对每个动作分别拍摄了男性和女性模特的全高清（1080p）演示视频，总计593段。此外，每条记录还包含了分步骤指导、动作要领提示、常见错误说明以及呼吸建议等丰富的教练元数据。该数据集采用MIT开源协议，无需API密钥和数据库支持，支持一键自托管部署，极大降低了获取高质量锻炼知识的技术门槛，为健身应用开发、运动分析研究及个性化训练推荐等领域提供了可靠的数据基础。

当前挑战

该数据集所面对的领域挑战在于解决运动可视化指导的稀缺性与多样性需求——传统锻炼数据集通常仅提供静态图像或文字描述，无法精准传达动作的连续动态细节，而现有视频资源又因版权和成本限制难以大规模获取。为此，项目在构建过程中面临了多重挑战：首先，如何确保317个动作的演示视频在男性和女性模特间保持一致性，同时兼顾不同身体形态下的动作演示效果；其次，需要为每个动作精炼出分步骤指导、常见错误及呼吸技巧等结构化知识，这要求对运动生物力学有深入理解并完成大量人工校审；此外，系统设计需在无数据库和无API密钥的条件下运行，并保证593段高清视频的流畅加载与低延迟分发；最后，还需确保所有开源内容的版权合规，避免侵权风险。

常用场景

经典使用场景

在运动科学与计算机视觉交叉研究中，Free Exercise DB with Videos 凭借其涵盖317种动作、593段1080p全高清示范视频的丰富资源，成为姿态估计与动作识别任务的理想基准数据集。研究者可借助该数据集中男女双视角的规范演示视频，结合详细的步骤说明、形态提示与常见错误分析，训练和评估人体关键点检测、运动序列对齐以及动作质量评估等算法模型，推动智能健身与康复领域的自动化技术发展。

衍生相关工作

基于该数据集衍生的经典工作主要集中于动作识别模型的迁移学习与多模态健身助手的开发。例如，研究者利用其视频和关键点数据微调姿态估计网络（如OpenPose、MediaPipe），开发出针对特定肌群训练动作的细粒度分类器；另有工作将其与自然语言处理技术结合，构建能够解析用户自然语言指令（如“做三组每组12个的哑铃弯举”）并检索对应示范视频的对话式健身代理。开源社区亦围绕其构建了轻量化边端推理管线，推动MIT开源协议在健身科技领域的生态繁荣。

数据集最近研究

最新研究方向

运动科学领域正迎来数字化转型浪潮，Free Exercise DB with Videos数据集以开源共享模式，集成了317项动作的593段全高清真人演示视频与精细化教学元数据，填补了传统公共运动数据库仅有文字或动图的空白。近期研究热点集中于如何利用该数据集赋能个性化运动推荐系统，通过整合动作分类标签、姿态纠正提示及常见错误分析，为AI驱动的运动姿态评估与智能教练开发提供高质量标注样本。同时，其男女双模体态演示的设计契合了运动生物力学中性别差异研究的现实需求，为构建更公平、更具包容性的数字化健身生态奠定了基础。该数据集结合MIT许可与零基础设施自托管部署能力，极大了降低了科研与商业应用的准入门槛，有望加速运动医学、康复工程与计算运动学领域的交叉创新。