Skip to content
CaptchaSonic

SDK C# (.NET)

SDK oficial em C#/.NET para a CaptchaSonic — transporte binário gRPC, async em primeiro lugar, exceções tipadas.

SDK oficial em C# / .NET para a API de resolução de CAPTCHA da CaptchaSonic.

Transporte

Usa gRPC nativo via Grpc.Net.Client. As imagens são enviadas como binário bruto, sem overhead de base64.

Instalação

dotnet add package CaptchaSonic

Início 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));

Construtor simples

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

Configuração

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
});

O cliente é thread-safe — crie uma instância e reutilize-a em toda a aplicação.


Resolvedores de imagem

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 automação com token

Eles enviam uma tarefa e fazem polling até que um token seja retornado (até 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 utilitários

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

Tratamento de erros

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 */ }

Repete automaticamente em Unavailable, ResourceExhausted, DeadlineExceeded com backoff exponencial.