Forudsigelser i batch for navne, e-mailadresser og brugernavne

Navne, e-mailadresser og brugernavne i batch

Parameter	Type	Påkrævet	Standard	Beskrivelse
`items`	`array<object>`	Ja	`—`	Mellem 1 og 50 elementer til forudsigelse, højst 10 med IP-prøveadgangen. Resultaterne bevarer inputrækkefølgen.
`items[].type`	`string`	Ja	`—`	Inputkategori: name, email eller username.
`items[].value`	`string`	Ja	`—`	Påkrævet. 1–254 tegn, ikke tom og uden kontroltegn. E-mailværdier skal have gyldig e-mailsyntaks.
`items[].country`	`string`	Nej	`—`	Valgfri ISO 3166-1 alpha-2-kode med store bogstaver, for eksempel TR eller US. Et landespecifikt opslag kan falde tilbage til det globale datasæt.
`items[].forceToGenderize`	`boolean`	Nej	`false`	Prøv datasættet først og derefter AI, der tager højde for kaldenavne, hvis der ikke findes et resultat. Understøttes for name, email og username.
`items[].options`	`object`	Nej	`—`	Beholder til AI-indstillingerne for det enkelte input.
`items[].options.ai_mode`	`string`	Nej	`off`	Tilladte værdier: off, fallback, always. Med forceToGenderize: true skal du udelade feltet eller bruge fallback.
`items[].id`	`string`	Nej	`—`	Valgfri identifikator på 1–64 tegn i POST-JSON. Returneres sammen med hvert resultat i en batch og skal være unik inden for batchen. Accepteres ved enkelte forudsigelser, men returneres ikke. Understøttes ikke i GET-forespørgsler.

POST /gender/batch accepterer et items-array med 1–50 elementer ved adgang med API-nøgle eller højst 10 med IP-prøveadgangen. Du kan sende kun navne, kun e-mailadresser, kun brugernavne eller en blanding af alle tre. Hvert element har sine egne country, forceToGenderize og options. Id'er er valgfrie og skal være unikke.

Resultaterne bevarer inputrækkefølgen og indeholder index, dit valgfrie id, charged_credits og præcis ét af felterne data eller error. HTTP 200 kan indeholde fejl for enkelte elementer, så kontrollér hvert element. meta.summary angiver total, succeeded, identified, unknown og failed. En ukendt forudsigelse er et gennemført element, der koster kreditter.

En fejl i valideringen eller planlægningen af forespørgslen afviser batchen, før der trækkes kreditter. Hvis alle udførte elementer fejler, returnerer API'et et Problem-svar med en status uden for 2xx samt et data-array og det ældre alias results. Mislykkede elementer koster nul efter en bekræftet refusion. Hvis opkrævningen ikke er bekræftet, må du ikke gå ud fra, at opkrævningen for elementerne er endelig.

Vælg et programmeringssprog. Konfigurér din API-nøgle, og kør derefter eksemplet på din server.

Hver forespørgsel om en forudsigelse er en ny operation, der koster kreditter, også når den gentages. Eksemplerne prøver ikke automatisk igen. Kontrollér opkrævningsstatus, før du sender en ny forespørgsel.

Før du kører: adgang og fejlhåndtering

Kør eksemplerne på din server. Sæt GENDERAPI_API_KEY i procesmiljøet til din eksisterende API-nøgle. Bekræft, at meta.access.mode er api_key: En nøgle, der ikke genkendes, kan føre til IP-prøveadgangen.

JSON-svar med HTTP 4xx og 5xx bevarer fejlens body og returnerer en exitstatus, der ikke er nul. Kontrollér code, action og meta.usage.billing_status, før du prøver igen. Kontrollér også data eller error for hvert element i batchsvar med HTTP 200.

Guide til fejl og nye forsøg →

curl --silent --show-error --fail-with-body --max-time 30 \
  --request POST 'https://api.genderapi.io/api/v2/gender/batch' \
  --header "Authorization: Bearer ${GENDERAPI_API_KEY:?Set GENDERAPI_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{
  "items": [
    {
      "id": "contact-1",
      "type": "name",
      "value": "Freja",
      "country": "DK"
    },
    {
      "id": "contact-2",
      "type": "email",
      "value": "alice.smith@example.com",
      "options": {
        "ai_mode": "fallback"
      }
    },
    {
      "id": "contact-3",
      "type": "username",
      "value": "prenses",
      "country": "TR",
      "forceToGenderize": true
    }
  ]
}'

cURL 7.76+ i en POSIX-shell. Kør i din terminal. Dokumentation for kørselsmiljøet

// 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 = {
  "items": [
    {
      "id": "contact-1",
      "type": "name",
      "value": "Freja",
      "country": "DK"
    },
    {
      "id": "contact-2",
      "type": "email",
      "value": "alice.smith@example.com",
      "options": {
        "ai_mode": "fallback"
      }
    },
    {
      "id": "contact-3",
      "type": "username",
      "value": "prenses",
      "country": "TR",
      "forceToGenderize": true
    }
  ]
};

const response = await fetch("https://api.genderapi.io/api/v2/gender/batch", {
  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+, indbygget fetch. Gem som example.mjs, og kør node example.mjs. Dokumentation for kørselsmiljøet

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("{\"items\":[{\"id\":\"contact-1\",\"type\":\"name\",\"value\":\"Freja\",\"country\":\"DK\"},{\"id\":\"contact-2\",\"type\":\"email\",\"value\":\"alice.smith@example.com\",\"options\":{\"ai_mode\":\"fallback\"}},{\"id\":\"contact-3\",\"type\":\"username\",\"value\":\"prenses\",\"country\":\"TR\",\"forceToGenderize\":true}]}")

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/batch",
    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+, standardbiblioteket. Gem som example.py, og kør python3 example.py. Dokumentation for kørselsmiljøet

<?php
$apiKey = getenv('GENDERAPI_API_KEY');
if (!$apiKey) {
    throw new RuntimeException('Set GENDERAPI_API_KEY');
}
$body = json_decode('{"items":[{"id":"contact-1","type":"name","value":"Freja","country":"DK"},{"id":"contact-2","type":"email","value":"alice.smith@example.com","options":{"ai_mode":"fallback"}},{"id":"contact-3","type":"username","value":"prenses","country":"TR","forceToGenderize":true}]}', true, 512, JSON_THROW_ON_ERROR);

$ch = curl_init('https://api.genderapi.io/api/v2/gender/batch');
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+ med cURL-udvidelsen. Gem som example.php, og kør php example.php. Dokumentation for kørselsmiljøet

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 = "{\"items\":[{\"id\":\"contact-1\",\"type\":\"name\",\"value\":\"Freja\",\"country\":\"DK\"},{\"id\":\"contact-2\",\"type\":\"email\",\"value\":\"alice.smith@example.com\",\"options\":{\"ai_mode\":\"fallback\"}},{\"id\":\"contact-3\",\"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/batch"))
            .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+, standard-HTTP-klienten. Gem som GenderApiExample.java, og kør java GenderApiExample.java. Dokumentation for kørselsmiljøet

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/batch");
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", apiKey);
request.Content = new StringContent("{\"items\":[{\"id\":\"contact-1\",\"type\":\"name\",\"value\":\"Freja\",\"country\":\"DK\"},{\"id\":\"contact-2\",\"type\":\"email\",\"value\":\"alice.smith@example.com\",\"options\":{\"ai_mode\":\"fallback\"}},{\"id\":\"contact-3\",\"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.
}

Konsolapplikation med .NET 8+. Brug som Program.cs i et konsolprojekt, og kør derefter dotnet run. Dokumentation for kørselsmiljøet

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 := "{\"items\":[{\"id\":\"contact-1\",\"type\":\"name\",\"value\":\"Freja\",\"country\":\"DK\"},{\"id\":\"contact-2\",\"type\":\"email\",\"value\":\"alice.smith@example.com\",\"options\":{\"ai_mode\":\"fallback\"}},{\"id\":\"contact-3\",\"type\":\"username\",\"value\":\"prenses\",\"country\":\"TR\",\"forceToGenderize\":true}]}"
    request, err := http.NewRequest("POST", "https://api.genderapi.io/api/v2/gender/batch", 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+, standardbiblioteket. Gem som main.go, og kør go run main.go. Dokumentation for kørselsmiljøet

Læs et batchsvar

Dette eksempel kombinerer to rigtige resultater, der blev hentet den 1. oktober 2026, et match i datasættet og et ukendt resultat, med en illustrativ fejl hos udbyderen. Det viser et HTTP 200-svar med delvis succes, ikke det forventede resultat af batchforespørgslen ovenfor. De to gennemførte elementer koster 1 kredit hver, og det mislykkede element har en bekræftet opkrævning på nul.

{
  "data": [
    {
      "index": 0,
      "id": "known",
      "charged_credits": 1,
      "data": {
        "input": {
          "type": "name",
          "value": "Freja",
          "country": "DK"
        },
        "name": "freja",
        "gender": "female",
        "country": "DK",
        "confidence": 1,
        "confidence_kind": "observed_frequency",
        "sample_count": 18,
        "source": "dataset",
        "result_status": "identified",
        "reason": null,
        "country_source": "dataset",
        "match": {
          "name": "freja",
          "method": "normalized",
          "scope": "country",
          "country": "DK"
        }
      }
    },
    {
      "index": 1,
      "id": "missing",
      "charged_credits": 1,
      "data": {
        "input": {
          "type": "name",
          "value": "zzzxxyy",
          "country": null
        },
        "name": null,
        "gender": null,
        "country": null,
        "confidence": null,
        "confidence_kind": null,
        "sample_count": null,
        "source": "none",
        "result_status": "unknown",
        "reason": "not_found",
        "country_source": null,
        "match": {
          "name": null,
          "method": null,
          "scope": null,
          "country": null
        }
      }
    },
    {
      "index": 2,
      "id": "failed",
      "charged_credits": 0,
      "error": {
        "type": "urn:genderapi:problem:ai_upstream_error",
        "title": "ai upstream error",
        "status": 502,
        "detail": "The AI provider could not complete the request.",
        "instance": "urn:uuid:11111111-1111-4111-8111-111111111111",
        "code": "ai_upstream_error",
        "request_id": "11111111-1111-4111-8111-111111111111",
        "documentation": "https://api.genderapi.io/api/v2/errors",
        "action": "inspect_billing_before_retry"
      }
    }
  ],
  "meta": {
    "request_id": "11111111-1111-4111-8111-111111111111",
    "duration_ms": 12,
    "access": {
      "mode": "ip_trial",
      "reason": "api_key_missing"
    },
    "usage": {
      "charged_credits": 2,
      "remaining_credits": 6,
      "billing_status": "confirmed",
      "resets_at": "2026-09-26T12:00:00.000Z",
      "limit": 10,
      "period_seconds": 86400
    },
    "summary": {
      "total": 3,
      "succeeded": 2,
      "identified": 1,
      "unknown": 1,
      "failed": 1
    }
  }
}

Felter i batchresultatet

Felt	Type	Kan være null	Eksempel	Beskrivelse
`data`	`array<object>`	Nej	`[…]`	Ordnede resultater. Hvert element indeholder en forudsigelse eller en fejl, så kontrollér hvert element.
`data[].index`	`integer`	Nej	`0`	Position i det sendte items-array, talt fra nul.
`data[].id`	`string`	Nej	`"contact-1"`	Din identifikator for inputtet. Findes kun, når du har angivet den.
`data[].charged_credits`	`integer`	Nej	`1`	Nettoopkrævning for elementet efter bekræftede refusioner. Betragt den ikke som endelig, hvis den samlede opkrævning ikke er bekræftet.
`data[].data`	`object`	Nej	`{…}`	Findes for et gennemført element, også ved ukendte resultater. Bruger felterne for forudsigelser, der er beskrevet i guiden om svar.
`data[].error`	`object`	Nej	`{…}`	Findes i stedet for data for et mislykket element. Bruger felterne fra Problem Details, der er beskrevet i guiden om fejl.

Felter i batchopsummeringen

Felt	Type	Kan være null	Eksempel	Beskrivelse
`meta.summary.total`	`integer`	Nej	`3`	Samlet antal elementer i batchen.
`meta.summary.succeeded`	`integer`	Nej	`2`	Gennemførte elementer, inklusive ukendte forudsigelser.
`meta.summary.identified`	`integer`	Nej	`1`	Gennemførte elementer med et køn, der ikke er null.
`meta.summary.unknown`	`integer`	Nej	`1`	Gennemførte elementer med gender null. Disse resultater koster kreditter.
`meta.summary.failed`	`integer`	Nej	`1`	Mislykkede elementer. total = succeeded + failed; succeeded = identified + unknown.

Metadata om adgang, opkrævning og forespørgslen

Felt	Type	Kan være null	Eksempel	Beskrivelse
`meta.request_id`	`string`	Nej	`"550e8400-e29b-41d4-a716-446655440000"`	Entydigt id for dette HTTP-forsøg. Sendes også i X-Request-ID.
`meta.duration_ms`	`integer`	Nej	`42`	Behandlingstid for forespørgslen i millisekunder.
`meta.access.mode`	`string`	Nej	`"api_key"`	api_key, ip_trial eller unauthenticated. Kontrollér, at værdien er api_key, når du bruger en betalt konto.
`meta.access.reason`	`string`	Ja	`null`	Årsag til IP-prøveadgangen: api_key_missing, api_key_invalid eller api_key_not_found, ellers null.
`meta.usage.charged_credits`	`integer`	Ja	`1`	Opkrævede kreditter netto. Nul før opkrævning eller efter en fuld bekræftet refusion, null, når opkrævningen ikke er bekræftet.
`meta.usage.remaining_credits`	`integer`	Ja	`99`	Saldo, når operationen afsluttes. Kan være negativ. null, når den ikke er tilgængelig, eller opkrævningen ikke er bekræftet.
`meta.usage.billing_status`	`string`	Nej	`"confirmed"`	not_charged, confirmed eller unconfirmed. Kontrollér dette, før du prøver en mislykket forudsigelse igen.
`meta.usage.resets_at`	`string`	Ja	`"2026-09-27T12:00:00.000Z"`	Tidspunkt for nulstilling af IP-prøveadgangen i UTC (ISO 8601). null for konti med API-nøgle, eller når det ikke er kendt.
`meta.usage.limit`	`integer`	Ja	`10`	Kreditter i IP-prøveadgangen. null for konti med API-nøgle.
`meta.usage.period_seconds`	`integer`	Ja	`86400`	Periode for IP-prøveadgangen i sekunder. null for konti med API-nøgle.

Planlæg kreditter og nye forsøg for batches

Godkend med din eksisterende API-nøgle i Bearer-headeren, og send Content-Type: application/json. Hver sendt batch er en ny operation. Hvis du prøver igen efter en delvis fejl, skal du kun sende de mislykkede elementer, når du har kontrolleret opkrævningen. Gennemførte elementer, der sendes igen, opkræves igen.

Elementer i en batch har som standard AI slået fra (off) og koster 1 kredit pr. gennemført element. Eksplicit fallback koster også 1 i alt, inklusive AI. always koster 2. forceToGenderize koster 1 for et resultat fra datasættet eller 2, hvis AI bruges. Gennemførte ukendte resultater opkræves. Én positiv startkredit er nok til at starte batchen, og den endelige opkrævning kan give en negativ saldo.

Behandl en kontaktliste uden at miste en eneste række

Batch-endpointet håndterer lister med kun navne, lister med kun e-mailadresser og blandede input. Med en API-nøgle deler du arbejdet op i batches på højst 50 elementer. IP-prøveadgangen tillader højst 10 pr. forespørgsel. Hold styr på, hvor langt du er i arbejdet, og giv hvert element et id, der er unikt inden for batchen. Det returnerede index starter ved nul inden for den sendte batch, ikke inden for hele kontaktlisten.

Trin	Hvad du skal gemme eller kontrollere	Hvorfor det er vigtigt
1. Forbered hver batch	Gem kilderækken og elementets id. Angiv country og AI-indstillinger for hvert element.	Gå ikke ud fra, at et navn er unikt på tværs af alle kontakter.
2. Læs hele svaret	Gem meta.request_id, og knyt hvert element i data[] til sin række via id eller index.	Et HTTP 200-svar kan indeholde både gennemførte forudsigelser og fejl for enkelte elementer.
3. Gem gennemførte resultater	Bevar identificerede og ukendte forudsigelser, inklusive JSON-værdien null og evidensfelterne.	Et ukendt resultat er gennemført og koster kreditter. Det er ikke en mislykket række, der automatisk skal sendes igen.
4. Afstem fejl og kreditter	Kontrollér hver error og meta.usage.billing_status, før du beslutter, om der skal sendes en ny forespørgsel.	Når opkrævningen er bekræftet, skal du kun prøve de mislykkede elementer igen, hvis fejlen berettiger det. Gennemførte elementer ville blive opkrævet igen.
5. Udskyd usikre nye forsøg	Gem forespørgslens id, hvis opkrævningen ikke er bekræftet, eller hvis en netværksfejl gør udfaldet ukendt.	Send ikke hele batchen igen i blinde. Følg først vejledningen om fejl og opkrævning.

Vælg en forudsigelsestilstand for hver kontakt

Denne kørbare forespørgsel bruger tre forskellige regler: kun datasæt for et fulde navn, almindelig automatisk AI-fallback for en e-mailadresse og automatisk AI-fallback med fortolkning af kaldenavne for et brugernavn. Det er eksempler på input, ikke et løfte om, at alle tre kontakter får et køn. Vælg et programmeringssprog over koden, og angiv GENDERAPI_API_KEY, før du kører eksemplet.

Uden forceToGenderize er AI som standard slået fra (off) for elementer i en batch, i modsætning til enkeltopslag. Angiv fallback eksplicit, hvis du vil bruge den almindelige automatiske AI-fallback. Både off og almindelig fallback koster 1 kredit pr. gennemført element. always springer datasættet over og koster 2. forceToGenderize koster 1 for et resultat fra datasættet eller 2 i alt, hvis AI bruges. Gennemførte ukendte resultater koster også kreditter. Kombinér ikke forceToGenderize med off eller always.