POST/createTask
{
"clientKey": "YOUR_API_KEY",
"appId": "app_0123456789",
"task": {
"type": "ImageToTextTask",
"body": "BASE64_IMAGE"
}
}| 欄位 | 類型 | 必填 | 說明 |
|---|---|---|---|
clientKey |
string | 是 | 放在請求主體中的 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。