Preveja nomes de usuários e apelidos com GenderAPI v2. Aprenda forceToGenderize, pesquisa inicial do conjunto de dados, campos de resposta de IA e a tarifa de 1 ou 2 créditos.
Antes de enviar a solicitação
Envie JSON para POST https://api.genderapi.io/api/v2/gender. Use sua chave API existente em Authorization: Bearer YOUR_API_KEY e Content-Type: application/json. Cada solicitação é processada de forma independente.
Escolha seu idioma no exemplo de código. Configure GENDERAPI_API_KEY no ambiente do processo antes de executá-lo. Chaves ausentes ou não reconhecidas podem usar a avaliação IP compartilhada, portanto, confirme que meta.access.mode é api_key ao integrar uma conta.
Use type: username para um nome de usuário ou apelido. Configure forceToGenderize como true para inferir o gênero a partir do significado de um alias como prenses, mesmo quando nenhum nome real puder ser extraído. O conjunto de dados é verificado primeiro. Uma previsão de apelido pode retornar um gênero mesmo quando name: null.
Escolha uma linguagem de programação.Configure sua chave API, e execute o exemplo em seu servidor.
Cada solicitação de previsão é uma nova operação faturável, incluindo novas tentativas. Esses exemplos não repetem automaticamente. Verifique o status do faturamento antes de enviar outra solicitação.
Antes de executar: acesso e tratamento de erros
Execute estes exemplos em seu servidor. Configure GENDERAPI_API_KEY no ambiente de processo para sua chave API existente. Confirme que meta.access.mode é api_key: uma chave não reconhecida pode retornar à avaliação IP.
As respostas HTTP 4xx e 5xx JSON preservam o corpo do erro e retornam um status de saída diferente de zero. Verifique code, action e meta.usage.billing_status antes de tentar novamente.
import jsonimport osimport sysimport urllib.errorimport urllib.requestapi_key = os.environ.get("GENDERAPI_API_KEY")if not api_key: raise RuntimeError("Set GENDERAPI_API_KEY")body = json.loads("{\"type\":\"username\",\"value\":\"prenses\",\"country\":\"TR\",\"forceToGenderize\":true}")class NoRedirect(urllib.request.HTTPRedirectHandler): def redirect_request(self, req, fp, code, msg, headers, newurl): return Nonerequest = urllib.request.Request( "https://api.genderapi.io/api/v2/gender", method="POST", data=json.dumps(body).encode("utf-8"), headers={ "Authorization": "Bearer " + api_key, "Content-Type": "application/json", },)opener = urllib.request.build_opener(NoRedirect())try: response = opener.open(request, timeout=30)except urllib.error.HTTPError as error: response = error # Keep the Problem Details body on non-2xx responses.with response: status = response.status raw = response.read().decode("utf-8") if "json" not in response.headers.get("Content-Type", ""): raise RuntimeError(f"HTTP {status}: expected a JSON response") result = json.loads(raw)print(json.dumps(result, indent=2), file=sys.stderr if status >= 300 else sys.stdout)if not 200 <= status < 300: sys.exit(1) # Inspect code, action and billing before retrying.# For batches, inspect every item even when HTTP status is 200.
import java.net.URI;import java.net.http.HttpClient;import java.net.http.HttpRequest;import java.net.http.HttpResponse;import java.nio.charset.StandardCharsets;import java.time.Duration;public class GenderApiExample { private static String requiredEnv(String name) { String value = System.getenv(name); if (value == null || value.isBlank()) throw new IllegalStateException("Set " + name); return value; } public static void main(String[] args) throws Exception { String apiKey = requiredEnv("GENDERAPI_API_KEY"); String body = "{\"type\":\"username\",\"value\":\"prenses\",\"country\":\"TR\",\"forceToGenderize\":true}"; HttpClient client = HttpClient.newBuilder() .connectTimeout(Duration.ofSeconds(10)) .followRedirects(HttpClient.Redirect.NEVER) .build(); HttpRequest request = HttpRequest.newBuilder(URI.create("https://api.genderapi.io/api/v2/gender")) .timeout(Duration.ofSeconds(30)) .header("Authorization", "Bearer " + apiKey) .header("Content-Type", "application/json") .POST(HttpRequest.BodyPublishers.ofString(body, StandardCharsets.UTF_8)) .build(); HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString(StandardCharsets.UTF_8)); if (!response.headers().firstValue("content-type").orElse("").contains("json")) { throw new IllegalStateException("HTTP " + response.statusCode() + ": expected JSON"); } // JSON text; parse with your application's JSON library when integrating. if (response.statusCode() < 200 || response.statusCode() >= 300) { System.err.println(response.body()); // Includes Problem Details. System.exit(1); } System.out.println(response.body()); // For batches, inspect each item's data or error, including on HTTP 200. }}
Java 17+; cliente HTTP padrão. Salve como GenderApiExample.java e execute java GenderApiExample.java. Documentação de tempo de execução
C# / .NET
using System;using System.Net.Http;using System.Net.Http.Headers;using System.Text;using System.Text.Json;string RequiredEnv(string name) => !string.IsNullOrWhiteSpace(Environment.GetEnvironmentVariable(name)) ? Environment.GetEnvironmentVariable(name)! : throw new InvalidOperationException($"Set {name}");var apiKey = RequiredEnv("GENDERAPI_API_KEY");using var handler = new HttpClientHandler { AllowAutoRedirect = false };using var client = new HttpClient(handler) { Timeout = TimeSpan.FromSeconds(30) };using var request = new HttpRequestMessage(HttpMethod.Post, "https://api.genderapi.io/api/v2/gender");request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", apiKey);request.Content = new StringContent("{\"type\":\"username\",\"value\":\"prenses\",\"country\":\"TR\",\"forceToGenderize\":true}", Encoding.UTF8, "application/json");using var response = await client.SendAsync(request);var raw = await response.Content.ReadAsStringAsync();if (!(response.Content.Headers.ContentType?.MediaType?.Contains("json") ?? false)) throw new InvalidOperationException($"HTTP {(int)response.StatusCode}: expected JSON");using var result = JsonDocument.Parse(raw);if (!response.IsSuccessStatusCode){ Console.Error.WriteLine(result.RootElement); // Preserve Problem Details. Environment.ExitCode = 1;}else{ Console.WriteLine(result.RootElement); // For batches, inspect every item even on HTTP 200.}
Esta resposta sintética ilustra o formato JSON, não a precisão medida ou um resultado ao vivo garantido. Mostra acesso de teste IP; uma operação autenticada relata os campos de cota somente de avaliação meta.access.mode: api_key e null. Ler dados para inferência e meta.usage para resultado do faturamento da operação.
Este exemplo usa forceToGenderize: true. Se o conjunto de dados identificar um gênero, o custo será de 1 crédito. Caso contrário, a IA interpreta o pseudónimo e um pedido concluído custa 2 créditos no total, mesmo que o género permaneça desconhecido. Omita ai_mode ou configure-o como fallback. Usar off ou always junto com forceToGenderize retorna HTTP 422.
No modo apelido, é permitida uma previsão de gênero com name: null. Isso significa que nenhum nome real foi extraído, e não que a análise falhou. Se AI retornar um gênero, sample_count: null e confidence_kind: model_reported serão retornados. A pontuação não é uma probabilidade calibrada e não verifica a identidade pessoal.
Sem forceToGenderize, uma única pesquisa de nome de usuário ainda é padronizada para AI fallback comum para um total de 1 crédito, mas requer um nome real utilizável. Use options.ai_mode: off para processamento somente de conjunto de dados.