GenderAPI.io V2 · Οδηγός

Προσδιορισμός φύλου από ινδικά ονόματα

Δοκιμάστε ονόματα που χρησιμοποιούνται στην Ινδία με το GenderAPI.io V2. Διατηρήστε την αρχική γραφή, επιλέξτε συνειδητά το πλαίσιο IN και ερμηνεύστε σωστά τις αντιστοιχίσεις πλήρων ονομάτων, τα αποτελέσματα του AI και τα άγνωστα αποτελέσματα.

Τελευταία ενημέρωση:

Δοκιμάστε το API V2

Ανάλυση ονόματος

Σύνολο δεδομένων + AI

Στείλτε μια τιμή και δείτε ολόκληρη την απόκριση, μαζί με τα άγνωστα αποτελέσματα και τις πιστώσεις που χρησιμοποιήθηκαν.

Το εργαλείο χρησιμοποιεί ένα παράδειγμα πλαισίου χώρας: Ινδία (IN). Δεν είναι προεπιλογή για όλα τα ονόματα αυτής της γλώσσας ούτε απόδειξη εθνικότητας.

Κανονικό αίτημα: 1 πίστωση, μαζί με την εφεδρική χρήση AI και τα άγνωστα αποτελέσματα. Με ανάλυση ψευδωνύμων: 1 πίστωση αν το αποτέλεσμα προέρχεται από το σύνολο δεδομένων ή 2 συνολικά αν χρησιμοποιηθεί AI, ακόμη και όταν το αποτέλεσμα είναι άγνωστο.

Η τιμή που στέλνετε (το όνομα) διαβιβάζεται στο GenderAPI.io και μπορεί να προωθηθεί στη ρυθμισμένη υπηρεσία AI, αν χρειαστεί η εφεδρική χρήση AI. Περισσότερα για την επεξεργασία των δεδομένων.

Δεν έχει αποθηκευτεί κλειδί API. Μπορείτε να χρησιμοποιήσετε την κοινόχρηστη δοκιμαστική πρόσβαση IP όσο διαθέτει πιστώσεις.

Η παρακάτω απόκριση είναι ενδεικτικό παράδειγμα. Πατήστε Ανάλυση για να στείλετε ένα αίτημα.

Παράδειγμα απόκρισης V2 · όχι αποτέλεσμα σε πραγματικό χρόνο
Όνομα—
ΦύλοΆγνωστο
Βεβαιότητα—
ΠηγήΜοντέλο AI
Πιστώσεις που χρησιμοποιήθηκαν1

Οι συχνότητες, οι τιμές και το υπόλοιπο του παραδείγματος δείχνουν τη μορφή της απόκρισης. Οι πραγματικές τιμές μπορεί να διαφέρουν. Μια πρόβλεψη δεν είναι επιβεβαιωμένη ταυτότητα.

Χρήση του αρχικού ονόματος χωρίς την υπόθεση μίας μόνο γραφής ή σταθερής σειράς

Η επίδειξη χρησιμοποιεί ένα παράδειγμα σε ντεβαναγκάρι και το πλαίσιο χώρας IN. Είναι παράδειγμα εισόδου και όχι ορισμός όλων των ονομάτων που χρησιμοποιούνται στην Ινδία. Το API δέχεται συμβολοσειρές Unicode, οπότε μπορείτε να στείλετε τη γραφή που υπάρχει στην εγγραφή της εφαρμογής σας χωρίς να τη μετατρέψετε πρώτα σε λατινικούς χαρακτήρες.

Η αναζήτηση χρησιμοποιεί κανονικοποιημένα μέρη. Δεν κάνει γενική μετατροπή ανάμεσα σε γραφές και δεν εγγυάται ότι μια λατινική γραφή και μια γραφή στο αρχικό αλφάβητο οδηγούν στην ίδια εγγραφή. Διατηρήστε την αρχική είσοδο μαζί με το όνομα που επιστράφηκε. Το ότι μια γραφή γίνεται δεκτή δεν σημαίνει ότι υπάρχει ανεξάρτητα μετρημένη ακρίβεια για κάθε γλώσσα ή κοινότητα.

Μη θεωρείτε δεδομένο ότι το πρώτο ή το τελευταίο μέρος έχει πάντα τον ίδιο ρόλο. Το V2 επιλέγει τον διαθέσιμο υποψήφιο με το υψηλότερο αποθηκευμένο συνολικό πλήθος και δεν εγγυάται συγκεκριμένη θέση του μικρού ονόματος. Αρχικά γράμματα, σύντομα μέρη και αποθηκευμένες εγγραφές που λείπουν μπορεί να αφήσουν χωρίς απάντηση το αποτέλεσμα του συνόλου δεδομένων. Η εφεδρική χρήση AI μπορεί να ερμηνεύσει ολόκληρη την τιμή που στάλθηκε.

Παράδειγμα εισόδουΤι αντιπροσωπεύειΤι να ελέγξετε
प्रिया शर्माΠλήρες όνομα σε ντεβαναγκάριΠερισσότερα μέρη μπορεί να γίνουν υποψήφιοι. Ελέγξτε το όνομα που επιλέχθηκε και την αντιστοίχιση αντί να υποθέσετε ότι επικρατεί το πρώτο μέρος.
Priya SharmaΠαράδειγμα με λατινικούς χαρακτήρεςΕίναι διαφορετική γραφή. Δεν είναι εγγυημένη πανομοιότυπη αντιστοίχιση ανάμεσα σε γραφές.
A. KumarΑρχικό γράμμα και ένα ακόμη μέροςΈνα αρχικό γράμμα δεν γίνεται υποψήφιος του συνόλου δεδομένων. Μια αντιστοίχιση στο άλλο μέρος δεν επιβεβαιώνει το αναμενόμενο μικρό όνομα.
country: INΠαράδειγμα πλαισίου: ΙνδίαΧρησιμοποιήστε το όταν η εγγραφή σας έχει σχετικό πλαίσιο χώρας και όχι μόνο επειδή το όνομα εμφανίζεται σε αυτόν τον οδηγό.

Συνειδητή επιλογή του πλαισίου χώρας IN

Η ζωντανή επίδειξη στέλνει country: IN (Ινδία). Το API δεν επιλέγει τη χώρα με βάση τη γραφή στην οποία είναι γραμμένο το όνομα. Στην ενσωμάτωσή σας χρησιμοποιήστε γνωστό και σχετικό πλαίσιο χώρας ή παραλείψτε το country. Μην κάνετε αυτή την τιμή του παραδείγματος προεπιλογή για όλες τις εγγραφές.

Για κάθε υποψήφιο, η αναζήτηση επιλέγει την εγγραφή της συγκεκριμένης χώρας, αν υπάρχει, και διαφορετικά εξετάζει τη γενική εγγραφή. Έπειτα επιλέγει τον διαθέσιμο υποψήφιο με το υψηλότερο αποθηκευμένο συνολικό πλήθος. Το πραγματικό εύρος της αντιστοίχισης αναφέρεται στα data.match.scope και data.match.country. Μια εγγραφή συγκεκριμένης χώρας με ισόπαλες συχνότητες δεν αντικαθίσταται αυτόματα από το γενικό αποτέλεσμα. Αν η εφεδρική χρήση είναι ενεργή, μπορεί να χρησιμοποιηθεί αντί γι' αυτό το AI.

Το data.input.country περιγράφει το πλαίσιο που στάλθηκε στο αίτημα. Τα data.country και data.country_source περιγράφουν τη συσχέτιση με χώρα που επιστράφηκε και την προέλευσή της. Είναι διαφορετικά πεδία και δεν δείχνουν ούτε την ιθαγένεια ούτε την εθνοτική καταγωγή ούτε τον τόπο διαμονής.

Αποστολή αιτήματος V2 για όνομα από την εφαρμογή σας

Ορίστε το GENDERAPI_API_KEY στο υπάρχον κλειδί σας και εκτελέστε το παράδειγμα στον διακομιστή σας. Το αίτημα ενεργοποιεί ρητά την κανονική εφεδρική χρήση AI. Δείχνει τη μορφή του αιτήματος και όχι μετρημένη ακρίβεια ή επιβεβαιωμένη κάλυψη. Για πρόβλεψη μόνο με το σύνολο δεδομένων, ορίστε options.ai_mode: off.

Επιλέξτε γλώσσα προγραμματισμού. Ρυθμίστε το κλειδί API σας, και έπειτα εκτελέστε το παράδειγμα στον διακομιστή σας.

Κάθε αίτημα πρόβλεψης είναι μια νέα χρεώσιμη λειτουργία, ακόμη και όταν πρόκειται για νέα προσπάθεια. Αυτά τα παραδείγματα δεν επαναλαμβάνουν αυτόματα το αίτημα. Ελέγξτε την κατάσταση χρέωσης πριν στείλετε άλλο αίτημα.

Πριν από την εκτέλεση: πρόσβαση και χειρισμός σφαλμάτων

Εκτελέστε αυτά τα παραδείγματα στον διακομιστή σας. Ορίστε στο περιβάλλον της διεργασίας το GENDERAPI_API_KEY με το υπάρχον κλειδί API σας. Ελέγξτε ότι το meta.access.mode έχει την τιμή api_key, επειδή ένα κλειδί που δεν αναγνωρίζεται μπορεί να οδηγήσει στη δοκιμαστική πρόσβαση IP.

Στις αποκρίσεις JSON με HTTP 4xx και 5xx διατηρείται το σώμα του σφάλματος και το παράδειγμα τερματίζει με μη μηδενικό κωδικό εξόδου. Ελέγξτε τα code, action και meta.usage.billing_status πριν δοκιμάσετε ξανά.

Οδηγός για σφάλματα και νέες προσπάθειες →
cURL
curl --silent --show-error --fail-with-body --max-time 30 \
  --request POST 'https://api.genderapi.io/api/v2/gender' \
  --header "Authorization: Bearer ${GENDERAPI_API_KEY:?Set GENDERAPI_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{
  "type": "name",
  "value": "प्रिया शर्मा",
  "country": "IN",
  "options": {
    "ai_mode": "fallback"
  }
}'

cURL 7.76+ σε κέλυφος POSIX. Εκτελέστε το στο τερματικό. Τεκμηρίωση του περιβάλλοντος εκτέλεσης

JavaScript / Node.js
// Server-side Node.js. Save as example.mjs.
const apiKey = process.env.GENDERAPI_API_KEY;
if (!apiKey) throw new Error("Set GENDERAPI_API_KEY");
const body = {
  "type": "name",
  "value": "प्रिया शर्मा",
  "country": "IN",
  "options": {
    "ai_mode": "fallback"
  }
};

const response = await fetch("https://api.genderapi.io/api/v2/gender", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify(body),
  signal: AbortSignal.timeout(30_000),
  redirect: "error",
});
const raw = await response.text();
if (!(response.headers.get("content-type") ?? "").includes("json")) {
  throw new Error(`HTTP ${response.status}: expected JSON; request ID ${response.headers.get("x-request-id")}`);
}
const result = JSON.parse(raw); // Also accepts application/problem+json.
if (!response.ok) {
  console.error(`HTTP ${response.status}`, result);
  process.exitCode = 1; // A retry is a new operation; inspect billing first.
} else {
  console.log(JSON.stringify(result, null, 2));
  // For batches, inspect every item: HTTP 200 may contain item errors.
}

Node.js 22+ με ενσωματωμένο fetch. Αποθηκεύστε ως example.mjs και εκτελέστε node example.mjs. Τεκμηρίωση του περιβάλλοντος εκτέλεσης

Python
import json
import os
import sys
import urllib.error
import urllib.request

api_key = os.environ.get("GENDERAPI_API_KEY")
if not api_key:
    raise RuntimeError("Set GENDERAPI_API_KEY")
body = json.loads("{\"type\":\"name\",\"value\":\"प्रिया शर्मा\",\"country\":\"IN\",\"options\":{\"ai_mode\":\"fallback\"}}")

class NoRedirect(urllib.request.HTTPRedirectHandler):
    def redirect_request(self, req, fp, code, msg, headers, newurl):
        return None

request = 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.

Python 3.10+ με την τυπική βιβλιοθήκη. Αποθηκεύστε ως example.py και εκτελέστε python3 example.py. Τεκμηρίωση του περιβάλλοντος εκτέλεσης

PHP
<?php
$apiKey = getenv('GENDERAPI_API_KEY');
if (!$apiKey) {
    throw new RuntimeException('Set GENDERAPI_API_KEY');
}
$body = json_decode('{"type":"name","value":"प्रिया शर्मा","country":"IN","options":{"ai_mode":"fallback"}}', true, 512, JSON_THROW_ON_ERROR);

$ch = curl_init('https://api.genderapi.io/api/v2/gender');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_FOLLOWLOCATION => false,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . $apiKey,
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode($body, JSON_THROW_ON_ERROR),
]);
$raw = curl_exec($ch);
if ($raw === false) {
    throw new RuntimeException(curl_error($ch));
}
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$contentType = curl_getinfo($ch, CURLINFO_CONTENT_TYPE) ?: '';
curl_close($ch);
if (strpos($contentType, 'json') === false) {
    throw new RuntimeException("HTTP $status: expected a JSON response");
}
$result = json_decode($raw, true, 512, JSON_THROW_ON_ERROR);
$output = json_encode($result, JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR) . PHP_EOL;
if ($status < 200 || $status >= 300) {
    fwrite(STDERR, $output); // Preserve the Problem Details body.
    exit(1);
}
echo $output;
// For batches, inspect every item; HTTP 200 can contain item errors.

PHP 8+ με την επέκταση cURL. Αποθηκεύστε ως example.php και εκτελέστε php example.php. Τεκμηρίωση του περιβάλλοντος εκτέλεσης

Java
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\":\"name\",\"value\":\"प्रिया शर्मा\",\"country\":\"IN\",\"options\":{\"ai_mode\":\"fallback\"}}";
        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+ με τον τυπικό πελάτη HTTP. Αποθηκεύστε ως GenderApiExample.java και εκτελέστε java GenderApiExample.java. Τεκμηρίωση του περιβάλλοντος εκτέλεσης

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\":\"name\",\"value\":\"प्रिया शर्मा\",\"country\":\"IN\",\"options\":{\"ai_mode\":\"fallback\"}}", 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.
}

Εφαρμογή κονσόλας .NET 8+. Χρησιμοποιήστε το ως Program.cs σε ένα έργο κονσόλας και έπειτα εκτελέστε dotnet run. Τεκμηρίωση του περιβάλλοντος εκτέλεσης

Go
package main

import (
    "encoding/json"
    "fmt"
    "io"
    "net/http"
    "os"
    "strings"
    "time"
)

func requiredEnv(name string) string {
    value := os.Getenv(name)
    if value == "" { panic("Set " + name) }
    return value
}

func run() error {
    apiKey := requiredEnv("GENDERAPI_API_KEY")
    body := "{\"type\":\"name\",\"value\":\"प्रिया शर्मा\",\"country\":\"IN\",\"options\":{\"ai_mode\":\"fallback\"}}"
    request, err := http.NewRequest("POST", "https://api.genderapi.io/api/v2/gender", strings.NewReader(body))
    if err != nil { return err }
    request.Header.Set("Authorization", "Bearer " + apiKey)
    request.Header.Set("Content-Type", "application/json")
    client := &http.Client{
        Timeout: 30 * time.Second,
        CheckRedirect: func(req *http.Request, via []*http.Request) error {
            return http.ErrUseLastResponse
        },
    }
    response, err := client.Do(request)
    if err != nil { return err }
    defer response.Body.Close()
    raw, err := io.ReadAll(response.Body)
    if err != nil { return err }
    if !strings.Contains(response.Header.Get("Content-Type"), "json") || !json.Valid(raw) {
        return fmt.Errorf("HTTP %d: expected a JSON response", response.StatusCode)
    }
    if response.StatusCode < 200 || response.StatusCode >= 300 {
        return fmt.Errorf("HTTP %d: %s", response.StatusCode, raw)
    }
    fmt.Println(string(raw))
    // For batches, inspect every item even on HTTP 200.
    return nil
}

func main() {
    if err := run(); err != nil {
        fmt.Fprintln(os.Stderr, err) // Keep Problem Details for error handling.
        os.Exit(1)
    }
}

Go 1.22+ με την τυπική βιβλιοθήκη. Αποθηκεύστε ως main.go και εκτελέστε go run main.go. Τεκμηρίωση του περιβάλλοντος εκτέλεσης

Αποθήκευση του αποτελέσματος μαζί με τα τεκμήρια

Μια συσχέτιση που συνάγεται δεν είναι το φύλο που δηλώνει ένα άτομο. Αποθηκεύστε χωριστά την αρχική είσοδο, τα τεκμήρια που επιστράφηκαν και ό,τι έχει δηλώσει το ίδιο το άτομο. Ένα άγνωστο αποτέλεσμα είναι έγκυρο αποτέλεσμα και δεν πρέπει να γίνει μια μαντεμένη κατηγορία στην εφαρμογή σας.

ΠεδίοΧρήση
data.gender / data.result_statusΧρησιμοποιήστε male ή female μόνο μαζί με identified. Σε άγνωστο αποτέλεσμα διατηρήστε την εγγενή τιμή JSON null.
data.name / data.matchΕλέγξτε το όνομα που επιστράφηκε και τον υποψήφιο που επιλέχθηκε. Μια αντιστοίχιση σε υποσυμβολοσειρά δεν αποδεικνύει ότι η είσοδος ανήκει σε άτομο με αυτό το όνομα.
data.confidence / data.confidence_kindΟ βαθμός βεβαιότητας εκφράζεται σε κλίμακα από 0 έως 1 ή είναι null. Το observed_frequency βασίζεται σε αποθηκευμένες συχνότητες, ενώ το model_reported είναι τιμή που αναφέρει το AI. Αξιολογήστε τα όρια χωριστά για κάθε τύπο.
data.source / data.sample_countΔιακρίνετε τα dataset, ai και none. Τα αποτελέσματα του AI δεν έχουν αποθηκευμένο μέγεθος δείγματος. Ένα μέγεθος δείγματος δεν είναι μετρημένη ακρίβεια.
meta.access.modeΣε μια ενσωμάτωση με λογαριασμό ελέγξτε ότι επιστρέφεται api_key. Τα κλειδιά που λείπουν ή δεν αναγνωρίζονται μπορεί αντί γι' αυτό να χρησιμοποιήσουν την κοινόχρηστη δοκιμαστική πρόσβαση IP.
meta.usageΔιαβάστε τα charged_credits και billing_status. Ένα επιτυχές άγνωστο αποτέλεσμα χρεώνεται. Μια απόκριση που χάθηκε δεν αποδεικνύει ότι το αίτημα ήταν δωρεάν.

Πότε να χρησιμοποιείται AI

Το forceToGenderize είναι προαιρετικό για ονόματα, διευθύνσεις email και ονόματα χρήστη. Όταν είναι ενεργό, παραλείψτε το ai_mode ή χρησιμοποιήστε fallback. Τα off και always δεν συνδυάζονται με αυτή την επιλογή και επιστρέφουν 422. Ένα θετικό αρχικό υπόλοιπο αρκεί για να ξεκινήσει ένα αίτημα, ακόμη κι αν η τελική χρέωση κάνει το υπόλοιπο αρνητικό.

Η λειτουργία ψευδωνύμων μπορεί να επιστρέψει φύλο μαζί με name: null. Μπορεί επίσης να δώσει άγνωστο αποτέλεσμα. Ούτε η κανονική εφεδρική χρήση AI ούτε η ανάλυση ψευδωνύμων εγγυώνται σωστή απάντηση ή τιμή διαφορετική από null.

Επιλογή αιτήματοςΣυμπεριφοράΠιστώσεις για επιτυχή αναζήτηση
options.ai_mode: offΧρησιμοποιεί μόνο το σύνολο δεδομένων.1, και για άγνωστο αποτέλεσμα
options.ai_mode: fallbackΕλέγχει πρώτα το σύνολο δεδομένων και έπειτα χρησιμοποιεί κανονικό AI, αν δεν επιστραφεί φύλο. Είναι η προεπιλογή για τα μεμονωμένα αιτήματα.1 συνολικά, μαζί με την εφεδρική χρήση AI
options.ai_mode: alwaysΧρησιμοποιεί απευθείας AI.2
forceToGenderize: trueΕλέγχει πρώτα το σύνολο δεδομένων και έπειτα αφήνει το AI να ερμηνεύσει ένα προσωπικό ψευδώνυμο ή ένα alias, ακόμη και χωρίς πραγματικό μικρό όνομα.1 για αποτέλεσμα από το σύνολο δεδομένων, 2 συνολικά αν χρησιμοποιηθεί AI

Επεξεργασία μιας λίστας ονομάτων χωρίς απώλεια του πλαισίου

Στείλτε έως 50 στοιχεία με κλειδί API ή έως 10 με τη δοκιμαστική πρόσβαση IP μέσω POST /api/v2/gender/batch. Δώστε σε κάθε στοιχείο ένα μοναδικό id και διατηρήστε την αρχική τιμή κάθε γραμμής. Κάθε στοιχείο μπορεί να έχει τις δικές του επιλογές για χώρα και AI. Παραλείψτε τη χώρα όταν δεν είναι γνωστή.

Σε αντίθεση με τα μεμονωμένα αιτήματα, που χρησιμοποιούν από προεπιλογή την εφεδρική χρήση, τα στοιχεία μιας παρτίδας χρησιμοποιούν από προεπιλογή μόνο το σύνολο δεδομένων. Ορίστε options.ai_mode: fallback σε κάθε στοιχείο που χρειάζεται AI. Ελέγξτε κάθε αποτέλεσμα, ακόμη και μετά από HTTP 200, διατηρήστε τα άγνωστα αποτελέσματα και ελέγξτε τα σφάλματα και τη χρέωση πριν από νέα αποστολή. Κάθε κανονικό επιτυχές στοιχείο κοστίζει 1 πίστωση. Ένα αίτημα HTTP για παρτίδα δεν αντιστοιχεί σε μία πίστωση ανά πρόβλεψη.

Να γνωρίζετε τι στέλνετε

Η ζωντανή επίδειξη στέλνει την τιμή που εισάγετε στο GenderAPI.io μόνο όταν την υποβάλετε εσείς. Αν χρησιμοποιηθεί AI, τα type, value και το πλαίσιο χώρας που στάλθηκαν διαβιβάζονται στη ρυθμισμένη υπηρεσία προβλέψεων. Για πρόβλεψη μόνο με το σύνολο δεδομένων, ορίστε στην ενσωμάτωσή σας options.ai_mode: off χωρίς forceToGenderize.

Η πολιτική απορρήτου, η σύμβαση επεξεργασίας δεδομένων και ο κατάλογος των υπεργολάβων επεξεργασίας περιγράφουν τους δημοσιευμένους όρους επεξεργασίας. Ένα αποτέλεσμα είναι μια συσχέτιση που συνάγεται και ό,τι δηλώνει ένα άτομο έχει προτεραιότητα. Μην το χρησιμοποιείτε ως βάση για αποφάσεις με σημαντικές συνέπειες για ένα άτομο.

Συχνές ερωτήσεις

Δέχεται η επίδειξη για ινδικά ονόματα μόνο ονόματα στα χίντι;

Η επίδειξη χρησιμοποιεί ένα παράδειγμα σε ντεβαναγκάρι, αλλά το API δέχεται ονόματα ως συμβολοσειρές Unicode. Αυτή η δυνατότητα δεν σημαίνει ούτε πλήρη κάλυψη του συνόλου δεδομένων ούτε μετρημένη ακρίβεια για κάθε γλώσσα που χρησιμοποιείται στην Ινδία.

Επιστρέφει η λατινική γραφή το ίδιο αποτέλεσμα με την αρχική γραφή;

Δεν είναι εγγυημένο. Η τρέχουσα αναζήτηση δεν προβλέπει γενική αντιστοιχία μεταξύ μεταγραφών. Διατηρήστε κάθε γραφή που στάλθηκε μαζί με τις πληροφορίες source, match και confidence που επιστράφηκαν.

Έχει δημοσιευθεί ανεξάρτητη αξιολόγηση της ακρίβειας για αυτή την ομάδα ονομάτων;

Αυτή η σελίδα δεν δημοσιεύει τέτοια αξιολόγηση. Η αποδοχή της εισόδου, η εμφάνιση αποθηκευμένων συχνοτήτων ή η επιστροφή ενός βαθμού βεβαιότητας δεν αποτελούν ανεξάρτητη μέτρηση της ακρίβειας. Η μεθοδολογία περιγράφει ποια δεδομένα είναι διαθέσιμα και ποιες μετρήσεις δεν έχουν δημοσιευθεί ακόμη.

Καταναλώνει πιστώσεις ένα αποτέλεσμα χωρίς πρόβλεψη;

Ένα επιτυχές άγνωστο αποτέλεσμα χρεώνεται. Η κανονική λειτουργία με το σύνολο δεδομένων ή με την εφεδρική χρήση κοστίζει 1 πίστωση συνολικά. Με το forceToGenderize το αίτημα κοστίζει 1 πίστωση αν το αποτέλεσμα προέρχεται από το σύνολο δεδομένων ή 2 συνολικά αν χρησιμοποιηθεί AI, ακόμη και για άγνωστο αποτέλεσμα. Για τα σφάλματα ισχύουν χωριστοί κανόνες χρέωσης. Ελέγξτε το meta.usage.

Συνέχεια δοκιμών

Χρησιμοποιήστε το κλειδί GenderAPI

Επικολλήστε το κλειδί API από τον λογαριασμό σας στο GenderAPI για να συνεχίσετε τις δοκιμές όταν εξαντληθούν οι κοινόχρηστες πιστώσεις της δοκιμαστικής πρόσβασης IP 24 ωρών. Η αποθήκευση του κλειδιού δεν στέλνει αίτημα. Στείλτε ξανά το αίτημα όταν είστε έτοιμοι.

Αποθηκεύεται μόνο σε αυτή την καρτέλα και διαγράφεται όταν την κλείσετε.