快速开始

① 获取 API Key

还没有 Key？先到 申请页 填写用途，审核通过后邮件收到形如 opk_tier_xxxx… 的 Key。

② 端点与鉴权

基础地址（Base URL）：

https://open.zhichan-ai.com

所有请求在请求头携带 Key：

X-API-Key: opk_xxxxxxxxxxxxxxxxxxxxxxxx

③ 第一次调用（cURL）

实时五运六气时间结构：

curl -s https://open.zhichan-ai.com/v1/yunqi/now \
  -H "X-API-Key: $AI4ES_KEY"

气象立方体（指定气象站，上海=101020100）：

curl -s https://open.zhichan-ai.com/v1/weather/cube/101020100 \
  -H "X-API-Key: $AI4ES_KEY"

环境健康汇合度：

curl -s https://open.zhichan-ai.com/v1/convergence/now \
  -H "X-API-Key: $AI4ES_KEY"

④ Python 示例

import requests

BASE = "https://open.zhichan-ai.com"
HEADERS = {"X-API-Key": "opk_your_key_here"}

r = requests.get(f"{BASE}/v1/yunqi/now", headers=HEADERS, timeout=15)
r.raise_for_status()
print(r.json())

套餐与配额

套餐	速率（次/分）	月配额（次）	适用
Free	60	10,000	个人探索
Basic	120	50,000	小团队 / 课题
Pro	300	200,000	业务系统
Enterprise	1,000	1,000,000	机构 / 私有化

常见错误码

码	含义	处理
401	缺少或错误的 Key	检查 X-API-Key
402	欠费 / 月配额用尽	升级套餐或等待次月
403	无权访问该资源	资源需更高 tier
429	触发速率限制	退避重试

想边看边调？用 在线调试台。