# 高考教育信息智能助手
> 来源页面: https://www.gugudata.com/api/details/gaokao-chat
## 概览
- API 标识: `gaokao-chat`
- 分类: 教育/高考
- 描述: 高考教育信息智能问答助手
- 标签: 智能问答 / 知识库检索 / 多轮对话
- 短标签: AI / 高考 / 高考录取 / 高等教育
- 数据更新时间: 数据校验更新于 7 小时前
- 价格: 9999元/年
- 限时折扣: 4999元/年
- 详情页: https://www.gugudata.com/api/details/gaokao-chat
- 数据预览: https://www.gugudata.com/preview/gaokao-chat
## API 功能
- RAG 智能体，强大的 AI 问答能力，支持高校基础信息查询、招生政策解读、专业介绍与选择建议等；
- 支持招生政策解读、报考指南与志愿填报建议；
- 支持多轮对话，通过 session_id 保持对话上下文；
- 支持知识库检索（RAG），可指定检索范围；
- 支持流式输出（SSE），实时返回 AI 生成内容；
- 支持多种请求方式：JSON、Form、Query String；
- 全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；
- 全面兼容 Apple ATS；
- 全国多节点 CDN 部署；
- 接口极速响应，多台服务器构建 API 接口负载均衡。
- 接口调用状态与状态监控: https://www.gugudata.com/status
## API 文档
- 接口地址: `https://api.gugudata.com/ai/gaokao/chat`
- 返回格式: `application/json; charset=utf-8`
- 请求方式: `POST`
- 请求协议: `HTTPS`
- 请求示例: `https://api.gugudata.com/ai/gaokao/chat?appkey=YOUR_APPKEY`
- 接口测试: https://api.gugudata.com/ai/gaokao/chat/demo
- Apifox: https://doc.gugudata.com/
- Postman: https://www.postman.com/gugudata/gugudata-official/collection/1163860-ee114343-4622-4a54-a39b-994173c27dac/?action=share&creator=1163860&active-environment=1163860-a95b31ef-324f-43db-b2fc-faa41f45bd35
- OpenAPI: https://www.gugudata.com/openapi/gugudata.openapi.3.1.json
## 请求参数
| 参数名 | 参数类型 | 是否必须 | 默认值 | 备注 |
| --- | --- | --- | --- | --- |
| appkey | string | 是 | YOUR_APPKEY | 付费后获取的 APPKEY，可通过 Query 参数或 JSON body 传入 |
| prompt | string | 是 | 你好，请介绍一下你自己 | 用户输入的问题，支持通过 JSON body 或 Form 参数传入 |
| session_id | string | 否 | | 会话ID，用于多轮对话。首次请求可不传，系统会自动生成并返回；后续请求使用返回的 session_id 可保持对话上下文 |
| streaming | string | 否 | false | 是否启用流式输出（true/false），流式输出采用 SSE (Server-Sent Events) 格式，可通过 Query 参数或 JSON body 传入 |
## 返回参数
| 参数名 | 参数类型 | 备注 |
| --- | --- | --- |
| DataStatus.StatusCode | integer | 接口返回状态码，100 表示成功 |
| DataStatus.StatusDescription | string | 接口返回状态说明 |
| DataStatus.ResponseDateTime | string | 接口数据返回时间 |
| DataStatus.DataTotalCount | integer | 此条件下的总数据量，一般用于分页计算 |
| Data.text | string | 回复的文本内容 |
| Data.session_id | string | 会话ID，用于多轮对话。首次请求会自动生成，后续请求使用此 ID 可保持对话上下文 |
| Data.finish_reason | string | 完成原因，通常为 'stop' 表示正常完成 |
| Data.request_id | string | 请求ID，用于追踪和调试 |
## 接口 HTTP 响应标准状态码
| 状态码 | 状态码解释 | 备注 |
| --- | --- | --- |
| 200 | 接口正常响应 | 请求成功，业务状态请结合响应体中的自定义业务码判断。 |
| 400 | 请求参数错误 | 请求参数缺失、格式错误或参数组合不合法。 |
| 401 | 鉴权失败 | 缺少 appkey 或 appkey 无效。 |
| 403 | 无权限访问 | 订单到期、权限不足或接口额度不可用。 |
| 404 | 资源不存在 | 请求路径不存在。 |
| 405 | 请求方法不允许 | 当前路径不支持该 HTTP 方法。 |
| 415 | 请求内容类型不支持 | 上传或请求体的内容类型不符合接口要求。 |
| 429 | 请求频率受限 | 一般建议同一个 IP 每秒请求不超过 5 次 (QPS<=5)，我们不限制同一个 key 的请求总次数，但当单位时间内同一个 IP 请求次数过多，或 AI CDN 判定为恶意抓取数据、流量攻击等异常时，CDN 会返回此状态码，请适当降低请求频率。如有特殊大并发请求场景需求，可联系我们添加白名单处理。 |
| 500 | 服务内部错误 | 服务端处理异常，请稍后重试。 |
| 502 | 上游依赖错误 | 上游依赖服务不可用或返回异常。 |
## 接口自定义状态码
| 自定义状态码 | 自定义状态码解释 | 备注 |
| --- | --- | --- |
| 100 | 正常返回 | |
| 101 | 参数错误 | 请检查传递的参数是否完整，prompt 和 appkey 为必填参数 |
| 102 | 请求频率受限 | 一般建议同一个 IP 每秒请求不超过 5 次 (QPS<=5)，我们不限制同一个 key 的请求总次数，但当单位时间内同一个 IP 请求次数过多，或 AI CDN 判定为恶意抓取数据、流量攻击等异常时，CDN 会返回此状态码，请适当降低请求频率。如有特殊大并发请求场景需求，可联系我们添加白名单处理。 |
| 103 | 账号欠费 | |
| 104 | APPKEY 错误 | 请检查传递的 APPKEY 是否为开发者中心获取到的值 |
| 110 | 接口响应错误 | 阿里云百炼智能体调用失败，请稍后重试 |
## cURL 请求示例
```bash
curl --location --request POST 'https://api.gugudata.com/ai/gaokao/chat?appkey=YOUR_APPKEY' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'prompt=你好，请介绍一下你自己' \
--data-urlencode 'session_id=' \
--data-urlencode 'streaming=false'
```
## 常见问题 Q&A
### Q: 数据请求有缓存吗？
A: 我们为所有数据请求提供实时响应。对于定期更新的数据，我们在其更新周期内实施缓存策略，以优化性能。
### Q: 如何保证请求时 key 的安全性？
A: 建议将 API 请求放置在您的应用程序后端，避免在前端暴露密钥。
### Q: 接口可以用于哪些开发语言？
A: 支持所有可以进行网络请求的开发语言，便于快速集成。
### Q: 接口性能可以保证吗？
A: 接口后台使用商业级架构，您可通过测试接口评估性能。
## 服务协议以及服务免责声明
- [服务协议](https://www.gugudata.com/license)
- [服务免责声明](https://www.gugudata.com/disclaimer)
## 技术支持
- 技术支持邮箱: support@gugudata.com
- 微信客服: https://work.weixin.qq.com/kfid/kfcf9a60a6afe3337b7