HumanDesign.aiPersonal打开应用 ↗
为你自己打造帮助中心

HumanDesign.ai Agent HTTP API 参考

API2026 年 11 月 13 日更新阅读约需 2 分钟

概览

Agent HTTP 通过 HTTP 端点提供相同的六种计算和参考操作。当应用需要具名 HTTP 调用而非 MCP 协议时,可使用该接口。

基础路径: https://api.humandesign.ai/agent/v1/tools

身份验证

每项请求均使用下列其中一种凭证: Authorization: Bearer YOUR_HDAI_API_KEY 或 X-Api-Key: YOUR_HDAI_API_KEY。不支持在查询字符串中提供凭证。

端点

  • POST。路径: /resolve-timezone。用途:将地点解析为时区和地理元数据。
  • POST。路径: /generate-chart。用途:生成出生图表。
  • POST。路径: /generate-composite-chart。用途:生成双人复合图表。
  • POST。路径: /get-reference-item。用途:读取闸门、通道、中心或档案记录。
  • POST。路径: /get-transits。用途:获取预测或本命与行运对比响应。
  • POST。路径: /search-celebrities。用途:搜索公众人物目录。

响应格式

成功响应使用带版本的封装:

{
  "version": "v1",
  "tool": "generate_chart",
  "data": {},
  "meta": {},
  "error": null
}

“ meta 对象包含请求和配额信息。响应字段应视为结构化数据;不要将摘要文本作为真实数据来源进行解析。

访问权限和配额

API 会在执行操作前检查权限。每个成功请求消耗一个共享 API 单位。可用操作和限制取决于当前 API 等级;请通过经过身份验证的 MCP 目录或账户工具查询当前可用情况,不要依赖复制保存的定价表。

返回顶部 ↑需要帮助?联系支持团队 ↗

找到你的下一个答案。