POST/createTask
{
"clientKey": "YOUR_API_KEY",
"appId": "app_0123456789",
"task": {
"type": "ImageToTextTask",
"body": "BASE64_IMAGE"
}
}| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
clientKey |
string | 是 | 放在 body 里的 API 密钥 |
appId |
string | 否 | 开发者 AppID,格式为 app_ 加 10 位十六进制字符。去除首尾空白,比对不区分大小写。 |
task |
object | 是 | 任务参数 |
task.type |
string | 是 | 区分大小写的类型字符串 |
callbackUrl |
string | 否 | 仅允许公网 HTTP(S)。至少一次投递;用 Idempotency-Key 或 X-Captcha-Callback-Id 去重,值就是任务号(taskId)。 |
也可以通过 X-App-Id 请求头传入 AppID。请求体根节点的 appId 优先,即使该值无效也不会回退到请求头。
格式错误、不存在、待审核、已驳回、已禁用、超过 64 字符或开发者已暂停分润的 AppID 都会被静默忽略。带不带 AppID,任务创建与扣费完全一致。从 CapSolver 迁移时可以保留原 appId;它不对应已启用的 Kaptra 应用时会被忽略。
status 为 processing、ready 或 failure。