图文识别转文本【自营】

服务器24*7运行本地部署。 必选参数（二选一） | 参数名称 | 数据类型 | 是否必选 | 描述 | |---------|---------|---------|------| | `file` | file | 和 `img` 二选一 | 通过 multipart/form-data 上传图片文件 | | `img` | string | 和 `file` 二选一 | 图片的 base64 编码值，不需要 `data:image/...;base64,` 前缀 | **注意**：`file` 和 `img` 必须且只能提供其中一个，不能同时提供，也不能都不提供。 ##### 可选参数 | 参数名称 | 数据类型 | 是否必选 | 默认值 | 描述 | |---------|---------|---------|--------|------| | `compress` | int | 否 | 1600 | 图片压缩参数：<br>- 值为空时，默认将图片最长边压缩到 1600px<br>- 值为 0 时，不压缩图片<br>- 值为非 0 时，将最长边压缩到该值的大小 | | `is_draw` | int | 否 | - | 是否返回标注图片：<br>- 值为 0 时，不返回图片（没有 `data['img_detected']` 字段）<br>- 值为非 0 或未提供时，返回标注图片 | 成功响应（code = 200） | 参数名称 | 数据类型 | 是否必选 | 描述 | |---------|---------|---------|------| | `code` | int | 是 | 识别结果的状态码，识别成功为 200 | | `msg` | string | 是 | 识别结果的文字信息，成功时为 "成功" | | `data` | dict | 否 | 识别结果数据对象 | | `data['img_detected']` | string | 是* | 画出文字区域的图片 base64 值（当 `is_draw` 不为 0 时返回） | | `data['raw_out']` | list | 是 | 识别结果的输出，格式为：<br>`[[[x1, y1, x2, y2], "识别的文字", 置信度], ...]` | | `data['speed_time']` | float | 是 | 识别的耗时（单位：秒） |

接口信息
接口状态: 正常
总调用: 3,275
计费单价: ¥ 0.01/次
添加时间: 2025-11-08
更新时间: 2025-12-07
访问权限: 计费调用，单价 ¥ 0.01/次 （持有密钥的用户可调用，按次扣费）
请求信息
请求地址
https://api.illlt.com/API/roc.php
示例地址
https://api.illlt.com/API/roc.php
请求参数
参数名 类型 必填 说明
apikey string 是 用户接口密钥（登录后自动填充）
file string 否 通过 multipart/form-data 上传图片文件。和 img 二选一
img string 否 图片的 base64 编码值，不需要 data:image/...;base64, 前缀。和 file 二选一
compress string 否 图片压缩参数：<br>- 值为空时，默认将图片最长边压缩到 1600px<br>- 值为 0 时，不压缩图片<br>- 值为非 0 时，将最长边压缩到该值的大小
is_draw string 否 是否返回标注图片：<br>- 值为 0 时，不返回图片（没有 data['img_detected'] 字段）<br>- 值为非 0 或未提供时，返回标注图片
状态码说明
状态码 说明
200 请求成功，服务器已成功处理了请求。
403 服务器拒绝请求。这可能是由于缺少必要的认证凭据（如API密钥）或权限不足。
404 请求的资源未找到。请检查您的请求地址是否正确。
429 请求过于频繁。您已超出速率限制，请稍后再试。
500 服务器内部错误。服务器在执行请求时遇到了问题。
在线测试

此处将显示接口返回结果...

调用示例 
<?php
$url = 'https://api.illlt.com/API/roc.php';
$params = [
    'apikey' => 'YOUR_VALUE',
    'file' => 'YOUR_VALUE',
    'img' => 'YOUR_VALUE',
    'compress' => 'YOUR_VALUE',
    'is_draw' => 'YOUR_VALUE',
];
$url .= '?' . http_build_query($params);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>
import requests

url = "https://api.illlt.com/API/roc.php"
params = {
    'apikey': 'YOUR_VALUE',
    'file': 'YOUR_VALUE',
    'img': 'YOUR_VALUE',
    'compress': 'YOUR_VALUE',
    'is_draw': 'YOUR_VALUE',
}
response = requests.get(url, params=params)
print(response.text)
const url = new URL('https://api.illlt.com/API/roc.php');
const params = {
    'apikey': 'YOUR_VALUE',
    'file': 'YOUR_VALUE',
    'img': 'YOUR_VALUE',
    'compress': 'YOUR_VALUE',
    'is_draw': 'YOUR_VALUE',
};
Object.keys(params).forEach(key => url.searchParams.append(key, params[key]));

fetch(url)
    .then(response => response.text())
    .then(data => console.log(data))
    .catch(error => console.error('Error:', error));
<!-- 方式1: 使用 img 标签直接调用（适用于返回图片的API） -->
<img src="https://api.illlt.com/API/roc.php" alt="API返回结果" />

<!-- 方式2: 使用 form 表单提交 -->
<form action="https://api.illlt.com/API/roc.php" method="GET">
    <input type="text" name="apikey" value="YOUR_VALUE" />
    <input type="text" name="file" value="YOUR_VALUE" />
    <input type="text" name="img" value="YOUR_VALUE" />
    <input type="text" name="compress" value="YOUR_VALUE" />
    <input type="text" name="is_draw" value="YOUR_VALUE" />
    <button type="submit">提交</button>
</form>

<!-- 方式3: 使用 iframe 嵌入 -->
<iframe src="https://api.illlt.com/API/roc.php" width="100%" height="400"></iframe>
API列表