API 文档 · 404 网络

快速开始

在控制台创建 API 密钥，再把它作为 Bearer 令牌调用接口。

请求方式: POST
内容类型: multipart/form-data

鉴权

请求必须携带 API 密钥。密钥只在创建成功时显示一次，请妥善保存，不要提交到代码仓库或打包进客户端。

Authorization: Bearer 404wl_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

创建 API 密钥

PaddleOCR API

POST https://api.404wl.com/v1/ocr

上传一张图片，返回图片中的完整文本和每个文字区域的位置，每张图片消耗 1 页额度。

请求参数

字段	类型	说明
`file`	`file`	必填。支持 JPEG、PNG、WEBP、BMP、TIFF，单文件最大 10 MiB。

调用示例

cURL

curl --request POST 'https://api.404wl.com/v1/ocr' \
  --header 'Authorization: Bearer 404wl_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
  --form 'file=@./example.png'

JavaScript

const form = new FormData();
form.append('file', file);

const response = await fetch('https://api.404wl.com/v1/ocr', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${apiKey}`,
  },
  body: form,
});

const result = await response.json();

PHP

$handle = curl_init('https://api.404wl.com/v1/ocr');
curl_setopt_array($handle, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer 404wl_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
    ],
    CURLOPT_POSTFIELDS => [
        'file' => new CURLFile(__DIR__.'/example.png'),
    ],
    CURLOPT_RETURNTRANSFER => true,
]);

$result = curl_exec($handle);
curl_close($handle);

响应格式

成功响应的 items 会列出每个识别到的文字区域，box 是原图尺寸上的四点坐标。

{
  "success": true,
  "request_id": "provider-request-id",
  "data": {
    "text": "你好",
    "items": [
      {
        "text": "你好",
        "score": 0.99,
        "box": [[1, 2], [30, 2], [30, 20], [1, 20]]
      }
    ],
    "image": {
      "width": 1280,
      "height": 720
    }
  },
  "error": null
}

成功和失败响应都会返回 request_id；响应头中的 X-Request-ID 可用于联系支持时定位请求。

错误码

错误响应统一返回 success: false、request_id、data: null 和 error。

HTTP	code	说明
`401`	`UNAUTHENTICATED`	API 密钥缺失或无效。
`402`	`SUBSCRIPTION_REQUIRED`	当前没有可用额度包。
`402`	`QUOTA_EXHAUSTED`	当前可用额度已用完。
`415`	`UNSUPPORTED_IMAGE`	文件不是受支持的图片格式。
`422`	`INVALID_REQUEST`	缺少文件或请求参数无效。
`429`	`RATE_LIMITED`	请求超过限流频率。
`502`	`PROVIDER_ERROR` `INVALID_PROVIDER_RESPONSE`	OCR 服务内部错误，请稍后重试。
`503`	`PROVIDER_UNAVAILABLE`	OCR 服务暂时不可用，请稍后重试。

PDF 转图片 API

POST https://api.404wl.com/v1/pdf2img

上传一个 PDF，按页返回渲染后的图片，按实际转换的页数消耗额度。