人类设计 API

基于与 HumanDesign.ai 相同的经过验证的版本化计算服务，通过 REST、规范化的代理 HTTP 工具和 MCP 提供支持。每个方案在所有界面上都保持其已公布的限额和基于层级的访问边界。

API入门

登录并订阅 API 套餐，即可获得您的私有 API 密钥并开始构建。

登录

选择您的计划

您的 API 密钥适用于 REST、Agent HTTP 和 MCP。每月配额在所有接口的计费请求中共享。限制与humandesignapi.com/pricing中的规定一致。

免费
$0/月
端点： 核心图表（v1）、关系、库、位置搜索、代理 HTTP 和 MCP 核心
  • 每月 100 万次 API 调用
  • 完整的 Creator 功能集
  • 无需信用卡
开始免费
创造者
$25/月
端点： 免费版 + 商业用途 + 控制面板
  • 每月 10,000 万次 API 调用
  • 商业用途
  • API 控制面板和使用情况跟踪
选择套餐
最受欢迎的产品
创业公司
$50/月
端点： Creator 中的所有内容 + 完整的 v3 图表、过境、回归、行进
  • 每月 100,000 万次 API 调用
  • 完整预测及收益
  • 电子邮件支持
选择套餐
业务
$200/月
端点： 创业公司+名人、批次、日历中的所有内容
  • 每月 1,000,000 万次 API 调用
  • 批量处理
  • 电子邮件和电话支持
选择套餐
企业版
定制化
端点： 通过 REST、代理 HTTP 和 MCP 以及自定义协议实现完全业务访问权限
  • 无限制/自定义配额
  • 自定义端点和合约
  • 专用支持
联系我们

API文档

面向 REST 端点、代理 HTTP 工具和 MCP 访问的分层感知参考。

General (将军)
所有计划
Startup+
商业+

介绍

HumanDesign.ai API 公开了与 HumanDesign.ai 相同的经过验证、版本化的计算服务。您可以使用 REST 进行直接集成，使用 Agent HTTP 连接操作客户端，或者将 MCP 客户端连接到规范的根端点。

基本网址

https://api.humandesign.ai
https://api.humandesign.ai/agent/v1/tools/*
https://mcp.humandesign.ai/

计算请求在 REST、Agent HTTP 和 MCP 之间共享一个配额，并且仅在其所有输入验证完毕后才使用一个单位。发现、参考查找、MCP initialize, ping和 tools/list 消耗零单位。

按计划访问端点

类别创造者创业公司业务企业版
所有计划
核心图表（v1）✓✓✓✓
关系图✓✓✓✓
参考图书馆✓✓✓✓
位置搜寻✓✓✓✓
代理 HTTP 和 MCP（创建工具）✓✓✓✓
Startup+
增强型图表（v2、v3） - ✓✓✓
交通与预测 - ✓✓✓
收益图表 - ✓✓✓
代理 HTTP 和 MCP（启动工具） - ✓✓✓
商业+
日历和日程安排 - - ✓✓
名人数据库 - - ✓✓
批量处理 - - ✓✓
代理 HTTP 和 MCP（业务工具） - - ✓✓

认证

每个请求都必须在请求头中包含您的 API 密钥，以防止凭据通过 URL 或查询日志泄露。与帐户关联的 MCP 使用 OAuth 认证。

请求头认证（推荐）

X-Api-Key: your_api_key_here
Authorization: Bearer your_api_key_here

请勿将 API 密钥放在链接、屏幕截图、分析数据或应用程序日志中。

错误代码： 401（缺少密钥）、403（密钥无效或级别不足）、429（超出每月配额）、400（请求错误/参数无效）。

核心图表

的GET https://api.humandesign.ai/hd-data
升级到 Creator 版本即可解锁
生成图表（v1）
返回完整的人类设计图，包括类型、权威、策略、概况、定义和所有闸门激活。
参数类型其他要求描述
dateISO 8601 是出生日期和时间（例如 1990-05-15T14:30:00）
timezone绳子是IANA 时区（例如 America/New_York）
的GET https://api.humandesign.ai/v2/hd-data
升级到 Startup 版本即可解锁
增强型图表（v2） Startup+
增强版出生星盘，包含详细属性、扩展的中心和通道数据。
参数类型其他要求描述
dateISO 8601 是出生日期和时间
timezone绳子是IANA 时区
的GET https://api.humandesign.ai/v3/hd-data
升级到 Startup 版本即可解锁
完整图表（v3） Startup+
最全面的图表，包含星座、逆行状态、闸门类别和完整的变量术语。
参数类型其他要求描述
dateISO 8601 是出生日期和时间
timezone绳子是IANA 时区

关系图

的GET https://api.humandesign.ai/hd-data-composite
升级到 Creator 版本即可解锁
综合图表（v1）
返回两个单独的图表和一个合并的复合图表，显示关系动态。
参数类型其他要求描述
dateISO 8601 是A 的出生日期和时间
timezone绳子是人 A 时区
date1ISO 8601 是B的出生日期和时间
timezone1绳子是B 的时区
的GET https://api.humandesign.ai/v2/hd-data-composite
升级到 Creator 版本即可解锁
增强型复合材料（v2）
增强型综合评分，包含化学评分、详细分析和GATE对比。
参数类型其他要求描述
dateISO 8601 是A 的出生日期和时间
timezone绳子是人 A 时区
date1ISO 8601 是B的出生日期和时间
timezone1绳子是B 的时区
解决方案&帖子 https://api.humandesign.ai/group-composite
升级到 Creator 版本即可解锁
团体复合
生成3-12人的综合图表。非常适合团队分析和小组辅导。
参数类型其他要求描述
members排列是包含 {日期，时区} 对象的数组（3-12 人）

交通与预测 Startup+

将行星过境位置叠加到出生星盘上，获取当前行星位置，并生成多日预测。

的GET https://api.humandesign.ai/hd-data-transit
升级到 Startup 版本即可解锁
交通图
获取一张行星过运图，图中会将你的本命星盘与行星过运位置叠加显示。
参数类型其他要求描述
dateISO 8601 是出生日期和时间
timezone绳子是出生时区
TransitDateISO 8601 是运输日期和时间
TransitTimezone绳子是交通枢纽时区
的GET https://api.humandesign.ai/planetary-positions
升级到 Startup 版本即可解锁
行星位置
获取当前行星位置、尊贵状态、逆行状态和闸门激活情况。
参数类型其他要求描述
dateISO 8601 没有日期和时间（默认为当前UTC时间）
timezone绳子没有IANA 时区（默认为 UTC）
的GET https://api.humandesign.ai/planetary-forecast
升级到 Startup 版本即可解锁
行星预测
每日预报显示指定日期范围内（最多 31 天）的闸门转换情况。
参数类型其他要求描述
StartDateISO 8601 是预测开始日期
EndDateISO 8601 是预测结束日期（最多 31 天）
timezone绳子没有IANA 时区（默认为 UTC）

收益图表 Startup+

太阳回归、月亮回归、土星回归和凯龙星回归，以及次限推运。

的GET https://api.humandesign.ai/solar-return
升级到 Startup 版本即可解锁
太阳能返回
这张星盘显示了太阳在特定年份回到你出生位置的确切时刻。
参数类型其他要求描述
dateISO 8601 是出生日期和时间
timezone绳子是出生时区
Year整数是太阳回归年份（例如 2024 年）
的GET https://api.humandesign.ai/lunar-return
升级到 Startup 版本即可解锁
农历回归
特定月份月亮何时回归你出生时的月亮位置的图表。
参数类型其他要求描述
dateISO 8601 是出生日期和时间
timezone绳子是出生时区
Month绳子是月份格式为 YYYY-MM（例如 2024-06）
的GET https://api.humandesign.ai/saturn-return
升级到 Startup 版本即可解锁
土星回归
土星回归信息和图表（约29年、约58年）。
参数类型其他要求描述
dateISO 8601 是出生日期和时间
timezone绳子是出生时区
的GET https://api.humandesign.ai/chiron-return
升级到 Startup 版本即可解锁
凯龙星回归
凯龙星回归信息和图表（约50年）。
参数类型其他要求描述
dateISO 8601 是出生日期和时间
timezone绳子是出生时区
的GET https://api.humandesign.ai/progressed-chart
升级到 Startup 版本即可解锁
进度图
次要进展图显示随时间推移的演变过程。
参数类型其他要求描述
dateISO 8601 是出生日期和时间
timezone绳子是出生时区
ProgressedToISO 8601 是目标进展日期

日历和日程安排 商业+

登机口日历、航班提醒、月相和 iCal 导出。

的GET https://api.humandesign.ai/gate-calendar
升级到商务版即可解锁
门日历
月历显示每日行星位置和闸门激活情况。
参数类型其他要求描述
Year整数是日历年（例如 2024 年）
Month整数是日历月（1-12）
timezone绳子没有IANA 时区（默认为 UTC）
的GET https://api.humandesign.ai/transit-alerts
升级到商务版即可解锁
交通警报
根据出生星盘提供个性化的行运提醒（最长可达 90 天）。
参数类型其他要求描述
dateISO 8601 是出生日期和时间
timezone绳子是出生时区
Days整数没有未来天数（默认值：30，最大值：90）
的GET https://api.humandesign.ai/moon-phases
升级到商务版即可解锁
月相
月相变化及每日月门位置。
参数类型其他要求描述
Year整数是公历年
Month整数是日历月（1-12）
timezone绳子没有IANA 时区（默认为 UTC）
的GET https://api.humandesign.ai/ical-export
升级到商务版即可解锁
iCal出口
以可下载的 .ics 日历文件形式导出运输预测。
参数类型其他要求描述
dateISO 8601 是出生日期和时间
timezone绳子是出生时区
Days整数没有要包含的天数（默认值：30，最大值：90）

参考图书馆

访问完整的 HD 参考数据库——所有 64 个门控、36 个通道、9 个中心和 12 个配置文件。

的GET /library/gates
升级到 Creator 版本即可解锁
列出所有闸门
获取全部 64 个门的概要信息。无需其他参数。
的GET /library/gates/{gateNumber}
升级到 Creator 版本即可解锁
获取登机口详情
详细的登机口信息（1-64），包括线路、主题和描述。
参数类型其他要求描述
gateNumber整数（路径）是登机口编号（1-64）
的GET /library/channels
升级到 Creator 版本即可解锁
列出所有频道
获取全部 36 个频道及其概要信息。
的GET /library/channels/{channelId}
升级到 Creator 版本即可解锁
获取频道详情
详细的频道信息（例如“1-8”）。
参数类型其他要求描述
channelId字符串（路径）是频道 ID（例如“1-8”）
的GET /图书馆/中心
升级到 Creator 版本即可解锁
列出所有中心
获取全部9个中心的汇总信息。
的GET /library/centers/{centerName}
升级到 Creator 版本即可解锁
获取中心详细信息
详细的中心信息（例如“骶骨”、“G”、“太阳神经丛”）。
参数类型其他要求描述
centerName字符串（路径）是中心名称（例如“骶骨”）
的GET /library/profiles
升级到 Creator 版本即可解锁
列出所有个人资料
获取全部 12 个个人资料及摘要信息。
的GET /library/profiles/{profileId}
升级到 Creator 版本即可解锁
获取个人资料详情
详细的个人资料信息（例如“1/3”、“4-6”）。
参数类型其他要求描述
profileId字符串（路径）是配置文件 ID（例如“1/3”或“4-6”）

位置搜寻

的GET https://api.humandesign.ai/locations
升级到 Creator 版本即可解锁
搜索地点和时区
按名称搜索城市。返回包含 IANA 时区数据的匹配位置，以便进行精确的图表计算。支持自动完成式部分查询。
参数类型其他要求描述
query绳子是要搜索的城市或地区（例如“伦敦”）

批量处理 商业+

解决方案&帖子 https://api.humandesign.ai/batch/charts
升级到商务版即可解锁
批次图生成
单次请求最多可生成 50 张图表，实现高效的批量处理。
参数类型其他要求描述
charts排列是包含 {id?, date, timezone} 对象的数组（最多 50 个对象）

名人数据库 商业+

搜索并获取名人的人类图数据。

的GET https://api.humandesign.ai/celebrity/search
升级到商务版即可解锁
搜索名人
按名称搜索。返回包含基本图表数据的匹配结果。
参数类型其他要求描述
query绳子是搜索查询（名称）
limit整数没有最大结果数（默认值：20，最大值：100）
的GET https://api.humandesign.ai/celebrity/{slugOrId}
升级到商务版即可解锁
获取名人详情
通过 slug（例如“elon-musk”）或 UUID 获取完整的名人详细信息。
参数类型其他要求描述
slugOrId字符串（路径）是名人头像或UUID

需要帮助？请联系我们的 API 团队，邮箱地址是[email protected]