POST/createTask
{
"clientKey": "YOUR_API_KEY",
"appId": "app_0123456789",
"task": {
"type": "ImageToTextTask",
"body": "BASE64_IMAGE"
}
}| Field | Type | Required | Notes |
|---|---|---|---|
clientKey |
string | yes | API key in the body |
appId |
string | no | Developer AppID, app_ followed by 10 hexadecimal characters. Leading/trailing whitespace is trimmed; matching is case-insensitive. |
task |
object | yes | Task parameters |
task.type |
string | yes | Case-sensitive type string |
callbackUrl |
string | no | Public HTTP(S) URL only. At-least-once delivery; dedupe with Idempotency-Key or X-Captcha-Callback-Id, whose value is the task ID (taskId). |
You can also send AppID in the X-App-Id header. A root-level appId in the body takes precedence, including when its value is invalid.
Invalid, unknown, pending, rejected, or disabled AppIDs, AppIDs longer than 64 characters, and AppIDs whose developer is suspended are silently ignored. Task creation and billing work the same with or without an AppID. A CapSolver AppID can be left in the request and will be ignored if it does not identify an enabled Kaptra application.
status is processing, ready, or failure.