createTask: 创建任务
WARNING
请求示例
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,获取任务结果 |