PHP接入百度图片识别转文字API全攻略：代码+教程

一、百度OCR文字识别接口概述

百度智能云提供的OCR（Optical Character Recognition）文字识别服务，支持通用场景、高精度、手写体等多种识别模式，能够将图片中的文字内容转换为可编辑的文本格式。其核心优势包括：

• 高精度识别：支持中英文、数字、符号混合识别，准确率达98%以上；
• 多场景适配：覆盖通用文字、身份证、银行卡、营业执照等20+专用场景；
• 快速响应：单张图片识别耗时低于500ms；
• 灵活调用：提供RESTful API接口，支持HTTP/HTTPS协议。

对于PHP开发者而言，通过调用百度OCR接口，可快速实现图片转文字功能，适用于文档数字化、票据识别、内容审核等场景。

二、接入前准备

1. 注册百度智能云账号

访问百度智能云官网，完成实名认证。实名认证后，可免费获得一定额度的OCR服务调用次数（通用文字识别每日500次免费）。

2. 创建OCR应用

1. 登录百度智能云控制台，进入文字识别服务；
2. 点击创建应用，填写应用名称（如“PHP_OCR_Demo”）、选择应用类型（如“Web应用”）；
3. 提交后，系统会生成API Key和Secret Key，这两个参数是后续调用的关键凭证。

3. 环境准备

• PHP 7.0+（推荐7.4或8.0）；
• cURL扩展（PHP默认集成，可通过php -m | grep curl检查）；
• 图片处理库（如GD或Imagick，用于图片预处理）。

三、API调用流程

百度OCR接口采用OAuth2.0授权机制，调用流程分为三步：

1. 获取Access Token：使用API Key和Secret Key换取临时授权令牌；
2. 构造请求参数：包括图片数据、识别类型等；
3. 发送HTTP请求：将参数提交至OCR接口，获取识别结果。

1. 获取Access Token

function getAccessToken($apiKey, $secretKey) {
    $url = "https://aip.baidubce.com/oauth/2.0/token?grant_type=client_credentials&client_id={$apiKey}&client_secret={$secretKey}";
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $response = curl_exec($ch);
    curl_close($ch);
    $data = json_decode($response, true);
    return $data['access_token'] ?? null;
}

说明：

• Access Token有效期为30天，需缓存避免频繁请求；
• 错误时返回{"error": "...", "error_description": "..."}，需处理异常。

2. 构造请求参数

百度OCR支持多种识别类型，常用参数如下：
| 参数名 | 类型 | 必填 | 说明 |
|———————|————|———|—————————————|
| image | string | 是 | 图片数据（Base64编码） |
| access_token | string | 是 | 上一步获取的Token |
| recognize_granularity | string | 否 | 识别粒度（big/small） |
| language_type | string | 否 | 语言类型（CHN_ENG/ENG等）|

图片处理建议：

• 格式：JPG、PNG、BMP等；
• 大小：<4MB；
• 尺寸：建议宽高比接近4:3，避免过度拉伸。

3. 发送HTTP请求

以通用文字识别为例：

function recognizeText($accessToken, $imagePath) {
    // 读取图片并Base64编码
    $imageData = file_get_contents($imagePath);
    $imageBase64 = base64_encode($imageData);
    // 构造请求URL
    $url = "https://aip.baidubce.com/rest/2.0/ocr/v1/general_basic?access_token={$accessToken}";
    // 构造POST数据
    $postData = [
        'image' => $imageBase64,
        'language_type' => 'CHN_ENG' // 中英文混合识别
    ];
    // 发送请求
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($postData));
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        'Content-Type: application/json'
    ]);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $response = curl_exec($ch);
    curl_close($ch);
    return json_decode($response, true);
}

四、完整代码示例

<?php
// 配置参数
$apiKey = '您的API_KEY';
$secretKey = '您的SECRET_KEY';
$imagePath = 'test.jpg'; // 待识别图片路径
// 1. 获取Access Token
$accessToken = getAccessToken($apiKey, $secretKey);
if (!$accessToken) {
    die("获取Access Token失败");
}
// 2. 调用OCR接口
$result = recognizeText($accessToken, $imagePath);
// 3. 处理结果
if (isset($result['words_result'])) {
    echo "识别结果：\n";
    foreach ($result['words_result'] as $item) {
        echo $item['words'] . "\n";
    }
} else {
    echo "识别失败：" . ($result['error_msg'] ?? '未知错误');
}
// 函数定义（同上）
function getAccessToken($apiKey, $secretKey) { /* ... */ }
function recognizeText($accessToken, $imagePath) { /* ... */ }
?>

五、常见问题与优化

1. 错误处理

• HTTP 403：检查Access Token是否过期或无效；
• HTTP 413：图片过大，需压缩或分块处理；
• 结果为空：检查图片是否清晰、文字是否垂直排列。

2. 性能优化

• 缓存Access Token：使用Redis或文件缓存，避免频繁请求；
• 异步调用：高并发场景下，可使用队列（如RabbitMQ）异步处理；
• 图片预处理：二值化、去噪可提升识别率。

3. 高级功能

• 表格识别：使用table_recognition接口；
• 手写体识别：设置recognize_granularity=small；
• 多语言支持：通过language_type指定（如JAP_ENG日英混合）。

六、总结

通过PHP调用百度OCR接口实现图片转文字，核心步骤包括：获取Access Token、构造请求参数、发送HTTP请求。开发者需注意：

1. 妥善保管API Key和Secret Key；
2. 处理图片格式和大小限制；
3. 实现错误处理和日志记录。

实际应用中，可结合Laravel、ThinkPHP等框架封装为服务类，提升代码复用性。百度OCR的丰富场景和高精度特性，能够满足大多数文字识别需求，助力企业快速实现数字化升级。