C#-(.NET-)SDK
Offizielles C#/.NET-SDK für CaptchaSonic — gRPC-Binärtransport, asynchron ausgelegt, typisierte Ausnahmen.
Offizielles C#-/.NET-SDK für die CAPTCHA-Lösungs-API von CaptchaSonic.
Transport
Nutzt natives gRPC über Grpc.Net.Client. Bilder werden als rohe Binärdaten gesendet, ohne Base64-Overhead.
Installation
dotnet add package CaptchaSonic
Schnellstart
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));
Einfacher Konstruktor
await using var client = new CaptchaSonicClient("sonic_your_api_key");
Konfiguration
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
});
Der Client ist threadsicher — erstellen Sie eine Instanz und verwenden Sie sie in Ihrer gesamten Anwendung weiter.
Bildlöser
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
Token-Automatisierungsmethoden
Diese senden einen Task und fragen so lange ab, bis ein Token zurückgegeben wird (bis zu 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
Hilfsmethoden
double balance = await client.GetBalanceAsync();
var health = await client.HealthCheckAsync();
var result = await client.GetTaskResultAsync(taskId);
var response = await client.CreateTaskAsync(task);
Fehlerbehandlung
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 */ }
Bei Unavailable, ResourceExhausted und DeadlineExceeded wird automatisch mit exponentiellem Backoff erneut versucht.