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

ImageToTextTask

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

请求参数

type<string>required

ImageToTextTask


body<string>required

以base64编码的文件主体。确保发送时没有换行符。


capMonsterModule<string>optional

识别模块的名称,例如“yandex”。可以通过这里找到模块名称及所有可用模块的列表。
示例: yandex, special 及其他


recognizingThreshold<integer>optional

验证码识别阈值,可取值范围为0到100。例如,如果将 recognizingThreshold 设置为90,并且任务以80的置信度解决,则不会收费。在这种情况下,用户会收到 ERROR_CAPTCHA_UNSOLVABLE 的响应。 种设置扣款阈值的替代方法在 该文章 中有描述。


case<boolean>optional

true - 如果验证码区分大小写。


numeric<integer>optional

1 - 如果验证码仅包含数字。
可能的值: 0, 1


math<boolean>optional

false — 未定义;
true — 如果验证码需要数学操作(例如:验证码 2 + 6 = 将返回值 8)。


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验证码答案

使用 SDK 库

// https://github.com/ZennoLab/capmonstercloud-client-js

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

document.addEventListener('DOMContentLoaded', async () => {
const cmcClient = CapMonsterCloudClientFactory.Create(new ClientOptions({ clientKey: '<your capmonster.cloud API key>' }));
console.log(await cmcClient.getBalance());

const imageToTextRequest = new ImageToTextRequest({
body: 'some base64 body',
CapMonsterModule: CapMonsterModules.YandexWave,
Case: true,
numeric: 1,
recognizingThreshold: 65,
math: false,
});

console.log(await cmcClient.Solve(imageToTextRequest));
});