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

请求参数

参数	类型	必填	描述
clientKey	String	是	客户端账户密钥，可在控制台中找到
appId	String	否	您的开发者AppId，在控制台的开发者部分申请
task	Object	是	任务对象
callbackUrl	String	否	token 将 (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",
}

响应结构

参数	类型	描述
errorId	Integer	错误消息： 0 - 无错误 1 - 有错误
errorCode	String	错误代码表
errorDescription	String	错误描述
status	String	返回状态，只能为null或`ready`
solution	Object	同步任务返回的结果
taskId	String	创建任务的ID，获取任务结果

getBalance: 余额 getTaskResult: 任务结果