POST/createTask
{
"clientKey": "YOUR_API_KEY",
"appId": "app_0123456789",
"task": {
"type": "ImageToTextTask",
"body": "BASE64_IMAGE"
}
}| Campo | Tipo | Obligatorio | Notas |
|---|---|---|---|
clientKey |
cadena | sí | Clave API en el cuerpo |
appId |
cadena | no | AppID de desarrollador: app_ seguido de 10 caracteres hexadecimales. Se eliminan los espacios iniciales y finales; la comparación no distingue mayúsculas y minúsculas. |
task |
objeto | sí | Parámetros de la tarea |
task.type |
cadena | sí | Cadena de tipo que distingue mayúsculas y minúsculas |
callbackUrl |
cadena | no | Solo URL HTTP(S) pública. Entrega al menos una vez; elimina duplicados con Idempotency-Key o X-Captcha-Callback-Id, cuyo valor es el ID de la tarea (taskId). |
También puedes enviar el AppID en el encabezado X-App-Id. El appId en la raíz del cuerpo tiene prioridad, incluso si su valor no es válido.
Los AppID con formato no válido, inexistentes, pendientes de revisión, rechazados o deshabilitados, de más de 64 caracteres o cuyo desarrollador tiene suspendido el reparto de ingresos se ignoran sin error. La creación de tareas y la facturación funcionan igual con o sin AppID. Si migras desde CapSolver, puedes dejar el appId existente en la solicitud: se ignorará si no corresponde a una aplicación de Kaptra habilitada.
status es processing, ready o failure.