高考教育信息问答 API：会话参数、资料引用与流式响应

GuGuData 高考教育信息智能助手 API 用于高考政策、院校、专业及招生信息问答，支持会话追问、同步 JSON 和流式响应，并返回公开资料引用。回答供信息核对，不能代替适用年份的官方公告或录取决定。

接口概览

项目	说明
请求方法	POST
接口地址	`https://api.gugudata.com/ai/gaokao/chat`
返回格式	JSON，UTF-8；流式模式按对应文档处理
调用凭据	对应产品 AppKey，示例使用 Header 传递

请求参数

参数名	参数类型	是否必须	默认值	备注
appkey	string	否	无	调用凭据必需，可通过 Query、请求体、受支持的 Header 或 Bearer 提供；多处提供时须一致，不在业务参数回显中返回
prompt	string	是	无	非空问题，最多 4000 字符；涉及地方政策时请写明省份和适用年份。示例：填报志愿前应核对哪些官方信息？
session_id	string	否	无	可选，最多 256 字符；继续对话时传入上次返回的会话 ID，首次请求不传
streaming	boolean	否	false	默认 false 返回 JSON；true 返回 SSE，包含 content、唯一 done 完整结果及 event: end 的 $DONE$ 结束标记；中断或错误不代表完成

政策问题应写明省份和适用年份。接口响应时间不代表引用资料的发布时间；引用内容是否仍适用，需要打开原文核对。

请求示例

下面是文档示例，不是已执行的真实测试结果。YOUR_APPKEY 为占位符；实际凭据保存在服务端，不写入网页、公开仓库或日志。中文参数使用 URL 编码；请求体示例使用 JSON。

bash 复制代码

curl --request POST 'https://api.gugudata.com/ai/gaokao/chat' \
  --header 'X-GUGUDATA-APPKEY: YOUR_APPKEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "请说明 2026 年江苏考生填报志愿前应核对哪些官方资料，并给出引用。",
  "streaming": false
}'

返回字段

参数名	参数类型	备注
DataStatus.RequestParameter	string	实际业务请求参数，不包含调用凭据
DataStatus.StatusCode	integer	业务状态码，100 表示成功
DataStatus.StatusDescription	string	业务状态说明
DataStatus.ResponseDateTime	string	响应时间
DataStatus.DataTotalCount	integer	本次响应数据量
Data.text	string	完整问答内容；不是官方招生决定或录取保证，具体政策以对应官方原文为准
Data.session_id	string	会话 ID
Data.finish_reason	string	回答完成状态
Data.request_id	string	请求 ID
Data.doc_references	array	引用资料对象数组，包含 title、doc_url 和可选 page_number；原文链接供核实适用年份和政策内容，不保证资料具有作者或发布日期

字段口径与使用边界

首次请求不传 session_id，后续追问使用上次返回值，业务侧应隔离不同用户会话。涉及地方政策时在 prompt 中说明省份和年份，避免默认套用其他地区规则。Data.doc_references 返回 title、doc_url 和可选 page_number；链接可核对不等于资料一定具备作者、发布日期或仍适用。streaming=true 时按 SSE 处理 content、唯一 done 完整结果以及 event: end 的 $DONE$ ；网络中断或错误不代表完成。

错误与结果核对

先检查 HTTP 状态，再检查 DataStatus.StatusCode；100 表示业务成功。参数、鉴权、订单权益、限流和服务异常应分别处理。不要把失败响应展示成"没有数据"，也不要因收到 HTTP 200 就直接读取业务结果。错误码和 QPS 以当前接口文档及套餐为准，不沿用旧文章中的统一频率承诺。

成功后继续核对 text、finish_reason、session_id 和引用原文。资料不足时保留不确定性，不补造分数、招生计划或政策条件；流式模式只有收到正常结束信号，才能标记回答完成。

官方文档与预览

本文由 GuGuData 产品方整理，接口契约核对日期为 2026 年 11 月 1 日。用于接口集成与资料核对；实际招生政策、选科与报考要求以适用年份的省级考试院和院校正式公告为准。