OCR 图片文字识别 YT 接口文档

接口说明

本接口用于将图片上的文字识别并输出文本内容。支持通过图片链接传入图片，返回识别出的文字内容以及按段落划分的结构化结果。

• 接口名称：ocr图片文字识别YT
• 调用地址：https://openapi.xunjinlu.fun/apis/ytocr
• 请求方式：GET
• 密钥要求：必须提供有效密钥
• 计费方式：免费
• 所属分类：图片工具

鉴权方式

本接口支持以下三种鉴权方式，调用方可根据自身场景选择其中一种：

请求参数

参数列表

参数说明

• key：调用方在本平台申请的访问密钥，用于身份鉴权与计费统计。若未开启密钥访问，该参数可不传；但本接口要求必须提供有效密钥。
• file：待识别图片的网络地址。该地址需可被本平台正常访问，建议使用 HTTPS 协议以确保传输安全。若图片链接失效或无法访问，接口将返回相应错误信息。

请求示例

示例一：Query 参数鉴权

GET https://openapi.xunjinlu.fun/apis/ytocr?key=sk_xxxxxxxxxxxxxxxx&file=https://img.meituan.net/video/b8db844ed88889dadda8e634ca1441182117.png HTTP/1.1
Host: openapi.xunjinlu.fun

示例二：Header 鉴权（X-API-Key）

GET https://openapi.xunjinlu.fun/apis/ytocr?file=https://img.meituan.net/video/b8db844ed88889dadda8e634ca1441182117.png HTTP/1.1
Host: openapi.xunjinlu.fun
X-API-Key: sk_xxxxxxxxxxxxxxxx

示例三：Bearer Token 鉴权

GET https://openapi.xunjinlu.fun/apis/ytocr?file=https://img.meituan.net/video/b8db844ed88889dadda8e634ca1441182117.png HTTP/1.1
Host: openapi.xunjinlu.fun
Authorization: Bearer sk_xxxxxxxxxxxxxxxx

示例四：PHP 调用示例

// OCR 图片文字识别 YT 接口调用示例

$url = "https://openapi.xunjinlu.fun/apis/ytocr";
$key = "sk_xxxxxxxxxxxxxxxx";
$file = "https://img.meituan.net/video/b8db844ed88889dadda8e634ca1441182117.png";

// 方式一：Query 参数鉴权
$requestUrl = $url . "?key=" . urlencode($key) . "&file=" . urlencode($file);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $requestUrl);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_TIMEOUT, 30);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);

if ($result["code"] == 200) {
    echo "识别内容：" . $result["data"]["content"];
} else {
    echo "错误：" . $result["msg"];
}

响应说明

成功响应

HTTP 状态码：200

响应示例：

{
  "code": 200,
  "data": {
    "content": "资源来源于网\r\n络，24小时内册\r\n除，请及时保存.\r\ntxt\r\n",
    "paragraphs": [
      {
        "paragraphid": 0,
        "word": "资源来源于网络，24小时内册除，请及时保存."
      },
      {
        "paragraphid": 1,
        "word": "txt"
      }
    ]
  },
  "msg": "请求成功",
  "time": "2026-04-28 14:42:52",
  "ip": "221.213.113.124"
}

响应字段说明

错误响应

当请求出现异常时，接口将返回相应的错误信息。

错误响应示例：

{
  "code": 0,
  "msg": "未提供调用密钥",
  "errcode": 11001
}

错误响应字段说明

业务错误码

以下为全部业务错误码及其含义：

调用注意事项

1. 密钥安全：请妥善保管您的访问密钥，避免泄露。建议不要在客户端代码中硬编码密钥。
2. 图片链接：传入的图片链接需为可公开访问的 URL，若链接需要鉴权或已过期，可能导致识别失败。
3. 请求频率：本接口存在 QPM（每分钟请求数）限制，请合理控制调用频率，避免触发限流。
4. 超时设置：建议调用方设置合理的请求超时时间（建议 30 秒），避免因网络问题导致请求长时间挂起。
5. 错误处理：调用方应根据返回的 code 和 errcode 字段进行相应的错误处理，而非仅依赖 HTTP 状态码。

常见问题

Q：接口返回 errcode 为 11001 怎么办？
A：表示请求中未提供调用密钥。请检查是否在 Query 参数、Header 或 Bearer Token 中正确传递了密钥。

Q：接口返回 errcode 为 11002 怎么办？
A：表示提供的密钥错误或无效。请确认密钥是否正确，或重新申请新的密钥。

Q：接口返回 errcode 为 11005 怎么办？
A：表示请求过于频繁，已触发 QPM 限制。请降低请求频率，稍后再试。

Q：识别结果不准确怎么办？
A：识别效果受图片质量、文字清晰度、字体、背景复杂度等因素影响。建议使用清晰度高、文字对比度好的图片以获得更好的识别效果。

Q：支持识别哪些语言？
A：本接口支持常见的中英文混合识别，具体语言支持情况以实际识别效果为准。