必须使用/document/summary接口，不可替换为/chat/completions；需传base64编码的二进制流，含file_content、file_type、summary_level字段，且file_content不超过10MB；响应含summary、keywords和page_ranges。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要把一份PDF或Word文档丢给智谱清言API，让它在3秒内输出带重点标注的千字以内摘要，而不是手动翻页找关键句——这要求你调用的是文档解析专用接口，不是通用对话接口，且必须传入base64编码后的二进制流，不能只传文件URL。
确认是否调用文档解析专用接口
智谱清言API有两个入口：/chat/completions（通用对话）和 /document/summary（文档解析）。前者接收纯文本提示词，后者才支持上传文件并自动执行语义分块、关键句抽取、逻辑主干识别。如果你用/chat/completions传base64，服务会直接报错400，提示“不支持文件类型”。
【必须使用/document/summary接口，不可替换为/chat/completions】
调用前请检查请求URL是否含/document/summary路径，否则所有后续参数都无效。
构造合法请求体
第一步：将PDF或Word文件读取为二进制数据→Base64编码→去除换行符（\n、\r）；
第二步：组装JSON body，字段必须包含file_content（base64字符串）、file_type（值为"pdf"或"docx"）、summary_level（可选值："brief"、"standard"、"detailed"）；
第三步：设置HTTP Header中Content-Type为application/json，Authorization为Bearer your_api_key；
注意：file_content字段长度超过10MB时，API会拒绝接收，需提前压缩PDF或拆分Word——这不是超时问题，是硬性大小拦截，不会返回重试建议。
获取结构化摘要结果
成功调用后，响应体中summary字段即为纯文本摘要，keywords字段返回3～5个核心关键词，page_ranges字段标明每段摘要对应的原文页码区间（如"1-3,7,12-15"）；
若原始文档含图表，summary中会出现“见图X”“见表Y”占位符，但不会还原图像内容——这是设计行为，非bug；
如果summary为空字符串且无报错，说明文档被判定为“无有效文本”，常见于扫描版PDF未OCR、Word全为图片、加密文档。
