指南
createTask: 创建任务

createTask: 创建任务

WARNING

创建一个用于解决指定验证码类型的任务。

在参数中指定要识别的验证码类型。

例如:ImageToTextTask

您可以查看所有支持的任务类型

请求示例

POST https://api.capsolver.com/createTask
Host: api.capsolver.com
Content-Type: application/json
 
{
    "clientKey":"YOUR_API_KEY",
    "appId": "APP_ID",
    "task": {
        "type":"ImageToTextTask",// 在此处填写您需要识别的任务类型
        "body":"BASE64 image"
    }
}

请求参数

参数类型必填描述
clientKeyString客户端账户密钥,可在控制台中找到
appIdString您的开发者AppId,在控制台的开发者部分申请
taskObject任务对象
callbackUrlStringtoken 将 (post) 发送到此端点

响应示例

异步任务响应示例

当任务被创建为token任务或特殊异步任务时,任务结果通过 getTaskResult命令获取。

{
    "errorId": 0,
    "errorCode": "",
    "errorDescription": "",
    "taskId": "37223a89-06ed-442c-a0b8-22067b79c5b4" // 保存此ID以供下一步使用
}

同步任务响应示例

如果任务类型是图片识别、语音识别或某些特殊任务,任务结果将直接返回。 可以通过判断status是否等于ready来确定。

{
    "errorId": 0,
    "errorCode": "",
    "errorDescription": "",
    "status": "ready",
    "solution": {
        "text": "44795sds"
    },
    "taskId": "2376919c-1863-11ec-a012-94e6f7355a0b",
}

响应结构

参数类型描述
errorIdInteger错误消息:
0 - 无错误
1 - 有错误
errorCodeString错误代码表
errorDescriptionString错误描述
statusString返回状态,只能为null或ready
solutionObject同步任务返回的结果
taskIdString创建任务的ID,获取任务结果