这个品类的数据长什么样
身份证件的数据来源包括用户上传的实体证件扫描件、实拍照片，或政务服务接口返回的结构化核验结果。文档结构分为图像层与结构化字段层，图像层包含人像、证件国徽与版式元素，格式多为JPG或PNG，分辨率通常要求不低于300dpi；结构化字段层包含姓名、公民身份号码、住址、签发机关、有效期限等标准文本字段，无额外特殊单位，更新节奏为单次提交核验或按对接接口的同步周期更新。
这些特征在「工具调用与插件」这一环带来什么约束
身份证件数据同时包含图像与结构化字段两类载体，要求工具调用链路同时覆盖图像解码、版式定位、字段校验三个环节。实体证件图像存在固定版式特征，需在插件中配置版式识别触发规则，避免非目标区域的干扰识别。结构化字段需遵循国家统一标准格式，插件需内置公民身份号码校验码、有效期限格式校验逻辑。对接政务数据源时，需配置接口字段映射规则，将政务接口返回的非标字段转换为平台可识别的标准字段。单次核验的图像数据量较大，需调整工具调用的超时阈值以适配处理时长。
配置怎么定
| 配置项 | 建议取法 | 这样取的依据 |
|---|---|---|
PARSE_IMAGE_TIMEOUT | 60–120 秒 | 身份证件图像解码、版式定位与字段提取的平均处理时长为30–90秒，预留缓冲以覆盖网络延迟场景 |
UPLOAD_FILE_MAX_SIZE | 10 MB | 高清身份证件扫描件的典型文件大小为2–8 MB，限制上限避免占用过多存储与处理资源 |
FIELD_VALIDATION_RULES | 启用身份证号校验码、有效期格式校验 | 匹配国家统一身份证件字段标准，过滤格式错误的核验数据 |
IMAGE_PREPROCESS_THRESHOLD | 0.88–0.92 | 适配轻微模糊、角度偏移的证件图像，平衡版式识别的准确率与召回率 |
STREAM_RESPONSE_TIMEOUT | 180 秒 | 跨政务数据源核验的全流程处理时长较长，需单独调整流响应的超时阈值 |
PLUGIN_AUTH_TYPE | API_KEY 鉴权 | 对接第三方核验接口的通用鉴权方式，符合行业安全规范 |
本页给出的参数取值均为常规建议，用于确定配置的起点。实际取值受材料形态、数据量与业务规则影响，具体问题需具体分析，建议在自有样本上实测后再定。
容易做错的三处
- 现象为调用插件时返回
408 Request Timeout错误，原因是未调整PARSE_IMAGE_TIMEOUT配置，默认超时时长不足以覆盖身份证件图像的解码与识别流程。 - 现象为插件返回的核验结果中公民身份号码字段格式错误，原因是未启用
FIELD_VALIDATION_RULES配置，未对结构化字段执行国家统一标准校验。 - 现象为调用图片解码环节时提示“流响应为空”，原因是未指定适配身份证件图像的解码模型参数，或模型输出格式与平台要求不匹配。
怎么确认配好了
- 上传一张标准身份证件图像，触发插件调用，检查返回的
parse_status字段是否为success，根据实际处理时长调整超时配置。 - 导入一份格式错误的公民身份号码样本，触发字段校验，检查插件是否返回格式错误提示，确认校验规则配置生效。
- 对接第三方核验接口，调用一次完整流程，检查返回字段是否与预设的映射规则一致，调整映射规则至完全匹配。
- 上传超过预设大小的身份证件图像，检查平台是否触发文件大小限制提示，确认上传限制配置生效。
问题素材取自公开社区提问（2026-09-11 去重 4,834 条）。文中的配置项名称与取值区间需以所用版本的实际界面与文档为准；本页核验日 2026-09-14，当时的最新发布版本为 FastGPT v4.17.0。