图形验证码识别API

API端点

GET https://api.vitphp.cn/Yzcode/

请求参数

响应格式

API返回JSON格式的数据，包含以下字段：

{
  "code": 1,
  "message": "success",
  "captcha": "9045"
}

错误代码

当code字段不为1时，表示请求出错，可能的错误代码如下：

支持的验证码类型

图形验证码识别API支持以下类型的验证码：

使用限制

• 免费版每分钟最多可调用5次API
• 图片大小不能超过5MB
• 图片格式必须为JPG、PNG或GIF
• 对于特别复杂的验证码，识别准确率可能会有所下降
• 请合理使用API，避免频繁调用

JavaScript示例

async function recognizeCaptcha(imageUrl) {
    try {
        const response = await fetch(`https://api.vitphp.cn/Yzcode/?img=${encodeURIComponent(imageUrl)}`);
        const data = await response.json();

        if (data.code === 1) {
            console.log("识别结果:", data.captcha);
            return data.captcha;
        } else {
            console.error("请求错误:", data.message);
            return null;
        }
    } catch (error) {
        console.error("发生异常:", error);
        return null;
    }
}

// 使用示例
const imageUrl = "https://shop.mzapp.cn/captcha.html";
recognizeCaptcha(imageUrl).then(result => {
    if (result) {
        console.log("验证码识别成功:", result);
    }
});

PHP示例

function recognizeCaptcha($imageUrl = null, $imageBase64 = null) {
    $url = "https://api.vitphp.cn/Yzcode/";

    if ($imageUrl) {
        $params = ["img" => $imageUrl];
    } elseif ($imageBase64) {
        $params = ["img" => "data:image/jpeg;base64," . $imageBase64];
    } else {
        echo "请提供图片URL或Base64编码的图片数据";
        return null;
    }

    $query = http_build_query($params);
    $fullUrl = $url . '?' . $query;

    $options = [
        'http' => [
            'method' => 'GET',
            'timeout' => 30,
        ]
    ];

    $context = stream_context_create($options);
    $response = file_get_contents($fullUrl, false, $context);

    if ($response === false) {
        echo "请求失败";
        return null;
    }

    $data = json_decode($response, true);

    if ($data['code'] == 1) {
        echo "识别结果: " . $data['captcha'];
        return $data['captcha'];
    } else {
        echo "请求错误: " . $data['message'];
        return null;
    }
}

// 使用示例 - 通过URL识别
$imageUrl = "https://shop.mzapp.cn/captcha.html";
$result = recognizeCaptcha($imageUrl);

cURL示例

# 通过URL识别验证码
curl "https://api.vitphp.cn/Yzcode/?img=https%3A%2F%2Fshop.mzapp.cn%2Fcaptcha.html"

# 响应示例
{
  "code": 1,
  "message": "success",
  "captcha": "9045"
}

识别准确率如何？

本API的识别准确率取决于验证码的复杂程度。对于简单的数字验证码，准确率可以达到99%以上；对于包含字母、算术表达式的验证码，准确率约为95%；对于包含复杂干扰线、扭曲变形的验证码，准确率约为90%。

我们不断优化识别算法，提高识别准确率，如果您遇到识别准确率较低的情况，请提供验证码样本，我们会针对性地进行优化。

API如何收费？

我们提供灵活的收费方案：

• 免费版：每月1000次调用，适合个人开发者测试使用
• 基础版：99元/月，10万次调用，适合小型项目
• 企业版：299元/月，50万次调用，适合中型项目
• 定制版：根据需求定制，适合大型项目

所有套餐均不限请求频率，如需更高调用量或其他特殊需求，请联系我们获取定制方案。

有使用限制吗？

是的，不同版本有不同的调用限制：

• 免费版：每分钟最多5次请求，每月最多1000次请求
• 基础版：每分钟最多50次请求，每月最多10万次请求
• 企业版：每分钟最多200次请求，每月最多50万次请求
• 定制版：根据合同约定

图片大小不能超过5MB，图片格式必须为JPG、PNG或GIF。

支持哪些类型的验证码？

本API支持多种类型的验证码，包括：

• 数字验证码
• 字母验证码
• 数字字母混合验证码
• 算术表达式验证码
• 扭曲变形验证码
• 干扰线验证码
• 干扰点验证码

对于特别复杂的验证码，识别准确率可能会有所下降。

响应时间是多久？

API的平均响应时间在300毫秒到1秒之间，具体取决于验证码的复杂程度和服务器负载情况。对于简单的验证码，响应时间通常在300毫秒左右；对于复杂的验证码，响应时间可能会延长到1秒左右。

遇到问题如何解决？

如果您在使用API过程中遇到问题，可以按照以下步骤解决：

1. 检查请求参数是否正确，特别是图片URL是否有效
2. 查看响应中的错误代码和错误信息，参考"错误代码"部分进行排查
3. 检查网络连接是否正常
4. 检查API调用频率是否超过限制
5. 如果以上方法无法解决问题，请联系我们的技术支持团队，提供详细的请求信息和错误信息

我们的技术支持团队会在24小时内回复您的问题。