apiCode 选择业务能力,再在 data 中提交该能力需要的参数。
统一入口
所有开放 API 共用一个 POST 地址,减少不同服务之间的接入差异。
apiCode 路由
apiCode 指定实际调用的业务能力,接口页面定义对应参数。同步 / 异步双模式
支持即时返回的 SYNC 模式与高耗时大模型分析的 ASYNC 轮询任务模式。
当前开放能力: 开发者 API 已全面开放 AI 对话问题挖掘(SYNC)、GEO 排名查询工具(ASYNC)、GEO 排名监测(ASYNC)、GEO 品牌得分检测(ASYNC)与 GEO 推广链接检测(ASYNC)。异步任务可通过 异步任务查询 接口获取结果;账号剩余积分与各接口额度使用情况可通过 额度使用情况查询(SYNC · GET)接口获取。
五分钟完成首次调用
1
创建 API Key
在用户中心进入 开发者 API → API 密钥,设置权限、有效期和可选的 IP 白名单。
2
配置身份认证
在请求 Header 中设置
AIBase-API-Key 和 Content-Type: application/json。3
发送第一条请求
向统一入口提交
apiCode(例如 geo.questions_corr_recommend)及业务参数。4
判断执行模式与处理结果
- SYNC 模式:直接检查 HTTP 状态和业务
code,从响应体的data.result读取结果。 - ASYNC 模式:保存返回的
taskId,每隔 10 秒调用任务查询接口,直至status = 2读取最终结果。
统一入口
不同
apiCode 的 data 和 result 结构不同。组装请求前,请进入对应的业务 API 页面核对字段及所属的执行模式。选择下一步
同步与异步模式
深入了解 SYNC/ASYNC 调用机制与 10 秒轮询规范。
Agent Skill 接入
面向 WorkBuddy、Codex、Cursor 等 AI 助手的安装与引导。
发送第一次请求
复制一条可直接修改的 cURL 请求。
创建 API Key
获取并安全保存调用凭证。
查看业务 API
核对全部 5 个接口的请求参数、响应字段与示例。
处理错误与状态
查看业务状态码、任务状态字典与重试建议。