---
title: "OCR 服务"
method: POST
path: "/paas/v4/files/ocr"
tags: ["工具 API"]
---

# OCR 服务

`POST /paas/v4/files/ocr`

上传图片文件，使用指定工具类型进行 OCR（光学字符识别），支持手写体、文字等识别模式，见 [OCR 服务](/cn/guide/tools/zhipu-ocr)。点击 **Try it** 按钮可快速试用。

## Response `200`

结果获取成功

- OCRResultResponse
  - `task_id` string, required — OCR识别任务ID
  - `message` string, required — 结果状态描述
  - `status` 'succeeded' | 'failed', required — 任务处理状态
  - `words_result_num` integer, required — 识别到的文本块/行数
  - `words_result` object[] — 每个识别文本块/行的详细结果
    - `location` object, required
      - `left` integer, required
      - `top` integer, required
      - `width` integer, required
      - `height` integer, required
    - `words` string, required — 识别出的文本内容
    - `probability` object, required — 置信度信息
      - `average` number, required
      - `variance` number, required
      - `min` number, required

## Other responses

- `default` — 请求失败。

---

[API](https://skmtc.net/bigmodel/apis/zhipu-ai-api.md) · [All operations](https://skmtc.net/bigmodel/apis/zhipu-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bigmodel/zhipu-ai-api/revisions/37de2d7b73de/schema)