在哪里创建 API Key？
在哪里创建 API Key？
在 AIBase 用户中心进入 开发者 API → API 密钥。创建时可以设置权限、有效期和可选的 IP 白名单。完整流程见创建 API Key。
为什么创建后看不到完整 API Key？
为什么创建后看不到完整 API Key？
完整 API Key 仅在创建成功后展示一次。应在创建时立即复制到服务端密钥管理系统；凭证疑似泄露时应停用或重新生成。
为什么所有 API 地址都一样？
为什么所有 API 地址都一样？
AIBase 使用统一任务提交入口，实际调用的业务能力由请求体中的
apiCode 决定。详细调用流程见通用接口调用。不同 apiCode 的 data 能一样吗？
不同 apiCode 的 data 能一样吗？
不能假设一样。每个业务 API 都应以自己的接口文档定义为准；当前“AI 对话问题挖掘”只定义了
keyword 业务参数。result 是通用的吗？
result 是通用的吗？
外层
data.result 是统一响应中的业务结果位置，但内部字段由 apiCode 对应的业务决定。“AI 对话问题挖掘”的 result 包含 aiQuestions 和 baiduQuestions。怎样判断一次调用是否成功？
怎样判断一次调用是否成功？
同时检查 HTTP 状态和响应体中的业务
code。不要仅根据 msg 文本判断，并为网络异常、超时和空响应设置处理逻辑。当前接口需要分页吗？
当前接口需要分页吗？
不需要。当前已上线的“AI 对话问题挖掘”不涉及分页，平台也没有预设统一分页字段。未来列表接口会在各自页面说明分页规则。
收到 429 应该怎么处理？
收到 429 应该怎么处理？
降低调用频率并控制并发，采用有限次数重试和指数退避。具体建议见调用限制。
hotValue 为 0 是否表示接口失败？
hotValue 为 0 是否表示接口失败？
不是。
hotValue = 0 是有效业务数据；是否调用成功应根据 HTTP 状态和业务 code 判断。SYNC 和 ASYNC 模式有什么区别？
SYNC 和 ASYNC 模式有什么区别？
SYNC（同步模式）会在任务提交接口中直接返回最终业务结果；ASYNC（异步模式）在提交后仅返回
requestId 和 taskId，需要调用通用任务查询接口 GET /v1/openapi/tasks/{taskId} 进行轮询。建议 ASYNC 模式每隔 10 秒查询一次。详见同步与异步任务模式。任务状态 status 是什么类型？各个枚举值代表什么？
任务状态 status 是什么类型？各个枚举值代表什么？
status 为 Integer 类型。当前状态枚举定义为：1 = PENDING（处理中）、2 = SUCCESS（成功完成）、3 = FAILED（失败）、4 = TIMEOUT（超时）、5 = CANCELLED（取消）。仅在 status = 2 时从 data.result 读取结果。为什么提交异步接口后 data.result 为空？
为什么提交异步接口后 data.result 为空？
ASYNC 模式在第一阶段仅负责创建后台任务并返回
taskId，不会直接生成大模型分析结果。请保存 taskId 并轮询任务查询接口，任务完成后方可在查询接口的 data.result 中读取完整数据。