Skip to content
On this page
Home
>API接口
>createTask:创建任务

createTask:创建识别任务

WARNING

创建一个验证码识别任务,在参数里面指定识别哪一种验证码。例如:ImageToTextTask 文字验证码。

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

请求示例

json
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值"
    }
}

参数结构

参数类型必须说明
clientKeyString帐户密钥,可以在个人中心找到
appIdStringDeveloper特定参数
taskObject验证码类型
callbackUrlString验证码会发送(post)到这个url

响应示例

异步任务响应示例

当创建任务为令牌任务或者特殊异步任务时,任务结果通过getTaskResult进行获取

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

识别同步任务响应示例

当创建任务类型为图片识别,语音识别或者部分特殊任务时,任务结果直接返回。可通过 status 是否等于 ready 进行判断

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

响应数据

参数类型说明
errorIdInteger错误提示: 0 - 没有错误,1 - 有错误
errorCodeString错误代码对照表
errorDescriptionString错误详细描述
statusString同步任务会返回状态,只可能为空值或者ready
solutionObject同步任务会返回结果
taskIdString创建的任务ID,可通过获取任务结果