Skip to content
CaptchaSonic

SDK de C# (.NET)

SDK oficial de C#/.NET para CaptchaSonic — transporte binario gRPC, asíncrono por defecto, excepciones tipadas.

SDK oficial de C# / .NET para la API de resolución de CAPTCHA de CaptchaSonic.

Transporte

Usa gRPC nativo a través de Grpc.Net.Client. Las imágenes se envían como binario sin formato, sin la sobrecarga de base64.

Instalación

dotnet add package CaptchaSonic

Inicio rápido

using CaptchaSonic;

await using var client = new CaptchaSonicClient(new CaptchaSonicOptions
{
    ApiKey = "sonic_your_api_key"
});

double balance = await client.GetBalanceAsync();
Console.WriteLine($"Balance: ${balance:F4}");

byte[] tile = await File.ReadAllBytesAsync("tile.png");
var result = await client.SolvePopularCaptchaAsync(
    images: new[] { tile },
    question: "Select all traffic lights",
    questionType: "objectClassify"
);
Console.WriteLine(string.Join(", ", result.TypedSolution.Grid.Objects));

Constructor simple

await using var client = new CaptchaSonicClient("sonic_your_api_key");

Configuración

var client = new CaptchaSonicClient(new CaptchaSonicOptions
{
    ApiKey      = "sonic_your_api_key",          // required, must start with "sonic_"
    Endpoint    = "https://api.captchasonic.com", // optional, default shown
    CallTimeout = TimeSpan.FromSeconds(30),       // optional, per-call gRPC deadline
});

El cliente es seguro para subprocesos: crea una instancia y reutilízala en toda tu aplicación.


Solucionadores de imágenes

SolvePopularCaptchaAsync()

await client.SolvePopularCaptchaAsync(
    images: new[] { tile },
    question: "Select all traffic lights",
    questionType: "objectClassify",   // "objectClassify" | "objectClick" | "objectDrag" | "grid"
    examples: null,                   // optional reference images
    screenshot: false,                // optional
    websiteUrl: "https://example.com", // optional, billing context
    websiteKey: null                  // optional, billing context
);

SolveRecaptchaV2Async()

await client.SolveRecaptchaV2Async(
    images: new[] { tile },
    question: "traffic lights",       // or "/m/015qff"
    questionType: "split_33",         // "split_33" | "33" | "44". Optional.
    websiteUrl: null,                 // optional
    websiteKey: null                  // optional
);

SolveGeetestAsync()

await client.SolveGeetestAsync(
    geetestType: "nine",              // "nine" | "click" | "slide" | "match" | "winlinze"
    question: "the bear",             // required for "nine" and "click"
    images: new[] { tile },           // required for "nine", "click", "slide"
    examples: null,                   // optional reference images
    image: null,                      // slice piece for "slide"
    gtv: 3,                           // Geetest version, default 3
    websiteUrl: null                  // optional
);

SolveOcrAsync()

await client.SolveOcrAsync(
    images: new[] { tile },
    module: "common",                 // "common" | "mtcaptcha" | "bls" | "morocco"
    websiteUrl: null                  // optional
);
// Returns: result.TypedSolution.Text.Texts[0]

SolveTikTokAsync()

await client.SolveTikTokAsync(
    type: "whirl",                    // "click" | "whirl" | "slide"
    question: "",                     // optional
    images: new[] { tile },
    examples: null,                   // required for "whirl" and "slide"
    websiteUrl: null                  // optional
);

SolveBinanceAsync()

await client.SolveBinanceAsync(
    type: "grid",                     // "grid" | "slide"
    question: "Select the bicycle",   // required for "grid"
    images: new[] { tile },
    examples: null,                   // optional
    websiteUrl: null                  // optional
);

SolveAwsWafAsync()

await client.SolveAwsWafAsync(
    images: new[] { tile },
    question: "grid:vehicles:cars",
    websiteUrl: null,                 // optional
    websiteKey: null                  // optional
);

SolveSlideImageAsync()

await client.SolveSlideImageAsync(images: new[] { background, piece });
// Returns: result.TypedSolution.Slide.X — pixel offset

Métodos de automatización de tokens

Estos envían una tarea y sondean hasta que se devuelve un token (hasta 120 s).

await client.SolveTurnstileAsync(websiteUrl, websiteKey, proxy?);
await client.SolvePopularCaptchaTokenAsync(websiteUrl, websiteKey, proxy?);
await client.SolveRecaptchaV2TokenAsync(websiteUrl, websiteKey, proxy?);
await client.SolveRecaptchaV3TokenAsync(websiteUrl, websiteKey, proxy?);
await client.SolveCloudflareAsync(websiteUrl, websiteKey, proxy);  // proxy required

Métodos de utilidad

double balance = await client.GetBalanceAsync();
var health     = await client.HealthCheckAsync();
var result     = await client.GetTaskResultAsync(taskId);
var response   = await client.CreateTaskAsync(task);

Manejo de errores

try
{
    var result = await client.SolvePopularCaptchaAsync(images, question, questionType);
}
catch (InvalidApiKeyException)         { /* errorId=1 */ }
catch (InsufficientBalanceException)   { /* errorId=2 */ }
catch (DailyLimitExceededException)    { /* errorId=3 */ }
catch (MinuteLimitExceededException)   { /* errorId=4 */ }
catch (QuotaExceededException)         { /* errorId=5 */ }
catch (PlanExpiredException)           { /* errorId=6 */ }
catch (CaptchaSonicException)          { /* other errors */ }

Reintenta automáticamente en Unavailable, ResourceExhausted y DeadlineExceeded con retroceso exponencial.