Skip to main content
AIBase 开发者 API 面向企业与开发者提供标准化接口能力。所有开放服务使用统一任务入口,通过 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 个接口的请求参数、响应字段与示例。

处理错误与状态

查看业务状态码、任务状态字典与重试建议。