跳转到主要内容
获取令牌时遇到问题吗
联系支持

ImageToText

查看全部价格

这是常规验证码，即包含文本的图片，需要输入相应的文本。

注意！

此任务无需使用代理服务器。

请求参数​


重要提示：请在创建任务前立即获取图像的 base64，以避免在解决过程中出现错误（见下方 CAPTCHA 图像 base64 获取示例）。
type<string>required

ImageToTextTask

body<string>required

以 base64* 编码的验证码文件内容。请确保该值以单行形式发送，不包含换行。

capMonsterModule<string>optional

模块名称，例如 “yandex”。传递模块名称的替代方式以及所有可用模块的列表可在此处查看。
示例：yandex、special 等。

recognizingThreshold<integer>optional

验证码识别阈值，可取 0 到 100。例如，如果向系统发送的值为 90，而任务解决置信度为 80，则不会扣除解决费用。在这种情况下，用户将收到 ERROR_CAPTCHA_UNSOLVABLE 响应。设置扣费阈值的另一种方法请参阅文章。

case<boolean>optional

解决时是否区分大小写。可选值：true、false

numeric<integer>optional

1 - 如果验证码仅由数字组成。
可选值：0、1

math<boolean>optional

false — 默认未设置；
true — 验证码要求执行数学运算（例如验证码 2 + 6 将返回值 8）。

重要： 对于 captcha_math 模块，请勿使用参数 math: true。


Base64 是一种数据编码方法，允许将二进制数据表示为文本。以下是使用开发者工具中的控制台获取验证码图像的 base64 格式的示例：

const captchaUrl = 'https://example.com/captcha.jpg';

function loadAndEncodeCaptchaToBase64(url) {
    fetch(url)
        .then(response => response.blob())
        .then(blob => {
            const reader = new FileReader();
            reader.readAsDataURL(blob);

            reader.onloadend = function() {
                const base64Data = reader.result;                
                console.log('Base64 编码的验证码:, base64Data);

                          };
        })
        .catch(error => {
            console.error('加载或编码验证码时出错:', error);
        });
}

loadAndEncodeCaptchaToBase64(captchaUrl);

创建任务方法​

POST
https://api.capmonster.cloud/createTask

请求示例

{
  "clientKey": "API_KEY",
  "task": {
    "type": "ImageToTextTask",
    "body": "BASE64_BODY_HERE!"
  }
}

响应示例

{
  "errorId":0,
  "taskId":407533072
}

获取任务结果方法​

使用getTaskResult方法获取验证码的解决方案。根据系统负载，您将在300毫秒到6秒的时间范围内收到答案。

POST
https://api.capmonster.cloud/getTaskResult

请求示例

{
  "clientKey":"API_KEY",
  "taskId": 407533072
}

响应示例

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "text": "answer"
  }
}

属性类型描述
textString验证码答案

如何查找任务创建所需的所有参数​

手动方式​

  1. 请在浏览器中访问您的网站，该网站包含验证码功能。
  2. 右键点击验证码元素，选择 检查（Inspect）。

base64​

在 DOM 树中找到所需的元素并将鼠标悬停在其上——base64 编码的图片会直接显示在元素的属性中：

base64elements

如果图片引用的是外部 URL，而不是包含 base64 编码的数据，你可以在网络请求（Network）中找到它。右键点击相关请求，选择 复制图片为数据 URI。这会将 base64 编码的图片数据复制到剪贴板。

base64network

自动方法​

为了自动化获取所需参数，可以通过 浏览器（普通模式或 headless 模式，例如使用 Playwright）进行提取，或直接从 HTTP 请求中获取。由于动态参数的有效时间较短，建议在获取后尽快使用。

重要

所提供的代码片段仅作为获取必要参数的基础示例。具体实现方式取决于包含验证码的网站、本身的页面结构，以及所使用的 HTML 元素和选择器。

显示代码（浏览器端）
(async () => {
  const img = document.querySelector('img'); // 示例选择器

  const imageUrl = img.src;

  const response = await fetch(imageUrl);

  if (!response.ok) {
    throw new Error("加载图片失败");
  }

  const buffer = await response.arrayBuffer();

  // 将二进制数据转换为 base64
  const base64Image = btoa(String.fromCharCode(...new Uint8Array(buffer)));

  console.log(base64Image); 
})();
显示代码（Node.js）
(async () => {
  const imageUrl = "https://example/img/.jpg"; // 图片 URL

  const response = await fetch(imageUrl);

  if (!response.ok) {
    throw new Error("加载图片失败");
  }

  const buffer = await response.arrayBuffer();

  // 转换数据为 base64
  const base64Image = Buffer.from(buffer).toString("base64");

  console.log(base64Image);
})();

使用 SDK 库​

显示代码（用于浏览器）
// https://github.com/ZennoLab/capmonstercloud-client-js

import { CapMonsterCloudClientFactory, ClientOptions, ImageToTextRequest, CapMonsterModules } from '@zennolab_com/capmonstercloud-client';

document.addEventListener('DOMContentLoaded', async () => {
    const cmcClient = CapMonsterCloudClientFactory.Create(
        new ClientOptions({ clientKey: 'YOUR_API_KEY' }) // 输入您的 CapMonster Cloud API 密钥
    );

    // 如有必要，可以检查余额
    const balance = await cmcClient.getBalance();
    console.log("Balance:", balance);

    const imageToTextRequest = new ImageToTextRequest({
        body: 'some base64 body', // 替换为实际值
        // 可选参数
        CapMonsterModule: CapMonsterModules.YandexWave, // 可以选择模块，例如 YandexWave
        Case: true, 
        numeric: 1,  
        recognizingThreshold: 65, 
        math: false   
    });

    const result = await cmcClient.Solve(imageToTextRequest);
    console.log("Solution:", result);
});
显示代码 (Node.js)
// https://github.com/ZennoLab/capmonstercloud-client-js

import { CapMonsterCloudClientFactory, ClientOptions, ImageToTextRequest, CapMonsterModules } from '@zennolab_com/capmonstercloud-client';

const API_KEY = "YOUR_API_KEY"; // 输入您的 CapMonster Cloud API 密钥

async function solveImageToText() {
    const cmcClient = CapMonsterCloudClientFactory.Create(
        new ClientOptions({ clientKey: API_KEY })
    );

    // 如有必要，可以检查余额
    const balance = await cmcClient.getBalance();
    console.log("Balance:", balance);

    const imageToTextRequest = new ImageToTextRequest({
        body: 'some base64 body', // 替换为实际值
        // 可选参数
        CapMonsterModule: CapMonsterModules.YandexWave, // 可以选择模块，例如 YandexWave
        Case: true,  
        numeric: 1, 
        recognizingThreshold: 65,  
        math: false 
    });

    const result = await cmcClient.Solve(imageToTextRequest);
    console.log("Solution:", result);
}

solveImageToText().catch(console.error);
这篇文章有帮助吗？
查看 AI CAPTCHA 求解器的价格