接口返回200，PDF却没进模型：合同附件怎么验收

相关工具：合同审查助手 Skill 腾讯电子签 Skill MCP-Doc Word 文档处理

法务系统把合同 PDF 送给大模型，接口返回 HTTP 200，并不代表模型读到了附件。HTTP 200 只表示请求成功到达；阿里云百炼的 PDF 理解文档明确说明，当前通过 Responses API 提交 PDF，虽然会返回 200，文件却不会传给模型。若系统只看状态码就把任务标成“完成”，签收单、验收报告或扫描页可能根本没进入抽取流程，缺失的交付日期、数量和异议记录也就不会被发现。

验收应从一份测试文件开始。准备不含敏感信息的 PDF，既有可复制文字，也有扫描页；在已获支持的接口和地域下调用，再核对已知内容是否出现在模型输出中。百炼文档列出的 PDF 输入方式是 OpenAI 兼容的 Chat Completions 或 DashScope，支持模型包括 qwen3.8-max、qwen3.8-max-0902、qwen3.8-flash 和 qwen3.8-27b，PDF 理解目前仅在中国（北京）地域提供。模型、地域、工作空间和接口都要与实际配置相符，不能只看模型名称。用文件 URL 时，确认服务端能访问该地址；使用 Base64 时，按接口要求传递文件内容。两种方式都只是传输手段，不会替代对材料授权、保密义务和数据地域的审查。

验收时别把四种状态混成一个

流程至少要区分：请求送达、PDF解析、模型拿到内容、业务字段核对。HTTP 200 只回答请求有没有成功返回，不能单独证明后三步完成。OpenAI 兼容调用需在请求顶层启用 include_tool_usage，响应才会提供 usage.x_tools.pdf_page_parser.count；DashScope 的解析页数位于 usage.plugins.pdf_page_parser.count。这个数字表示解析器报告处理的页数，不等于模型逐页理解正确，也不等于合同要素抽取准确。

因此，每次任务应留下接口类型、地域、模型 ID、文件编号或哈希、文件总页数、解析页数、业务状态及错误信息。测试文件还应放入已知字段，让系统核对模型是否返回正确内容。解析页数为零、没有返回，或与预期明显不符时，应把任务标记为失败并转人工，不能继续生成“已完成”的抽取结果。

关键条款仍要回到原件

解析页数只能证明解析步骤报告了处理量，不能证明识别无误。金额、期限、交付数量、验收结论和违约责任等字段，应由承办人员回看对应 PDF 页面；尤其是扫描件、表格和盖章页，不要只凭模型摘要入库或对外出具意见。试点阶段用上述测试文件分别验证接口、解析计数和字段结果，再决定是否接入批量流程。

实际操作可以归结为一句话：HTTP 状态码不作为附件读取的验收结论。只有接口选对、解析记录完整、测试字段通过，并且关键条款回到原件核验，法务团队才有依据把这项抽取任务记为完成。

资料来源

• 阿里云百炼：PDF 文件理解
• 阿里云百炼：模型价格与计费说明