同步解析

产品简介

文件解析服务能力升级，解析效果与 Prime 持平，速度更快，支持同步调用，用户可灵活选择，更高效、更全面！

智谱同步解析接口提供“一次请求即返回结果”的文件解析能力，支持多格式文档文本/表格/图片/版面结构识别，并输出纯文本或下载链接（图片 + Markdown + 布局 JSON）。

支持多种复杂版式（双栏、混排、三栏等）

• 高精度解析图文、公式、段落、表格、页眉页脚等
• 适配复杂排版
• 精度表现优异，适合高解析要求

适用场景

• 需要低延迟、即时拿到解析结果的在线处理链路（如用户上传后立刻问答、预览）。
• 单次文件不大、结构复杂度适中，或对纯文本抽取需求为主。

服务类型	支持格式	最大文件大小	解析结果	计费方式
Prime-sync	wps,pdf,doc,docx, ppt,pptx,md,txt, xls,xlsx,csv,html, png,jpg,jpeg,bmp, gif,webp,heic,eps, icns,im,pcx,ppm, tiff,xbm,heif,jp2	WPS/PDF/DOC/DOCX/PPT/PPTX ≤100MB MD/TXT/XLS/XLSX/CSV ≤10MB 其他 ≤20MB	下载链接（图片 + Markdown 文件 + 包含布局信息的 json 文件）；纯文本	按解析页数消耗后付费 优惠后 0.12 元/页

不适用或建议改用异步的场景：

超大文件、极复杂版面、并发量高且可后台处理的批量任务。此时建议使用 异步解析 ：创建任务 → 保存task_id → 轮询查询结果。

使用资源

接口文档：API 调用方式

接口使用方法

1. 调用接口创建解析任务，获取 task_id；
2. 保存并记录下 task_id；
3. 使用该 task_id 轮询查询接口，获取解析结果。

字段属性

字段名称	字段描述
file	本地待解析文件
tool_type	使用的解析工具类型: prime-sync
file_type	文件类型: WPS、PDF、DOC、DOCX、PPT、PPTX、MD、TXT、XLS、XLSX、CSV、HTML、PNG、JPG、JPEG、BMP、GIF、WEBP、HEIC、EPS、ICNS、IM、PCX、PPM、TIFF、XBM、HEIF、JP2
taskId	文件解析任务 ID

调用示例

调用示例里面的参数属性参考上方字段属性和对应的 API 文档。

cURL

curl --location --request POST 'https://open.bigmodel.cn/api/paas/v4/files/parser/sync' \
--header  'Authorization: Bearer YOUR_API_KEY' \
--form 'file=@example-file' \
--form 'tool_type="prime-sync"' \
--form 'file_type="PDF"'

Python

# 安装最新版本
pip install zai-sdk

# 或指定版本
pip install zai-sdk==0.2.3

from zai import ZhipuAiClient

client = ZhipuAiClient(api_key="YOUR_API_KEY")

def file_parser_sync_example():
    """
    示例：提交文件解析任务并等待结果返回。
    """
    # 创建解析任务
    # 请修改为本地文件路径
    file_path = 'your file path'
    with open(file_path, 'rb') as f:
        print("正在提交文件解析任务 ...")
        response = client.file_parser.create_sync(
            file=f,
            file_type="pdf",
            tool_type="prime-sync",
        )
        print("任务创建成功，响应如下：")
        print(response)

    print("File parser demo completed.")

if __name__ == "__main__":
    print("=== 文件同步解析快速演示（仅限 Prime） ===\n")
    file_parser_sync_example()

Java

安装 SDK

Maven

<dependency>
    <groupId>ai.z.openapi</groupId>
    <artifactId>zai-sdk</artifactId>
    <version>0.3.5</version>
</dependency>

  import ai.z.openapi.ZhipuAiClient;
  import ai.z.openapi.service.fileparsing.FileParsingDownloadResponse;
  import ai.z.openapi.service.fileparsing.FileParsingUploadReq;
  import ai.z.openapi.utils.StringUtils;

  public class FileParsingSyncExample {

      public static void main(String[] args) {
          // 初始化客户端
          ZhipuAiClient client = ZhipuAiClient.builder().ofZHIPU()
              .apiKey("YOUR_API_KEY")
              .build();

          try {
              System.out.println("=== 示例：创建文件解析任务 ===");

              String filePath = "your file path";
              FileParsingDownloadResponse result = syncFileParsingTaskExample(client, filePath, "pdf", "prime-sync");

              System.out.println("解析任务创建成功，TaskId: " + result.getData().getTaskId());
              System.out.println("文件内容: " + result.getData().getContent());
              System.out.println("下载链接: " + result.getData().getParsingResultUrl());

          } catch (Exception e) {
              System.err.println("发生异常: " + e.getMessage());
              e.printStackTrace();
          }
      }

      /**
      * 示例方法：创建解析任务（上传文件并进行解析）
      *
      * @param client ZhipuAiClient 实例
      * @return 解析任务的 taskId
      */
      private static FileParsingDownloadResponse syncFileParsingTaskExample(ZhipuAiClient client, String filePath, String fileType, String toolType) {
          if (StringUtils.isEmpty(filePath)) {
              System.err.println("文件路径无效。");
              return null;
          }
          try {
              FileParsingUploadReq uploadReq = FileParsingUploadReq.builder()
                      .filePath(filePath)
                      .fileType(fileType)  // 支持类型：pdf、docx 等
                      .toolType(toolType)  // 解析工具类型只支持：prime-sync
                      .build();

              System.out.println("上传文件并创建解析任务...");
              return client.fileParsing().syncParse(uploadReq);
          } catch (Exception e) {
              System.err.println("文件解析任务出错: " + e.getMessage());
          }
          // 返回 null 表示任务创建失败
          return null;
      }


  }

响应示例

{
    "status": "succeeded",
    "message": "结果获取成功",
    "content": "parsed result text",
    "task_id": "your task_id",
    "parsing_result_url": "download url"
}