SDK C# (.NET)
SDK C#/.NET resmi untuk CaptchaSonic — transport biner gRPC, async-first, exception bertipe.
SDK C# / .NET resmi untuk API penyelesaian CAPTCHA CaptchaSonic.
Transport
Menggunakan gRPC native melalui Grpc.Net.Client. Gambar dikirim sebagai biner mentah, tanpa overhead base64.
Instalasi
dotnet add package CaptchaSonic
Mulai Cepat
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));
Konstruktor sederhana
await using var client = new CaptchaSonicClient("sonic_your_api_key");
Konfigurasi
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
});
Client bersifat thread-safe — buat satu instance dan gunakan ulang di seluruh aplikasi Anda.
Solver Gambar
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
Metode Otomasi Token
Metode ini mengirim task lalu melakukan polling hingga token dikembalikan (maksimal 120 detik).
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
Metode Utilitas
double balance = await client.GetBalanceAsync();
var health = await client.HealthCheckAsync();
var result = await client.GetTaskResultAsync(taskId);
var response = await client.CreateTaskAsync(task);
Penanganan Error
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 */ }
Mencoba ulang secara otomatis pada Unavailable, ResourceExhausted, DeadlineExceeded dengan exponential backoff.