# คาดการณ์เพศจากชื่ออาหรับ

> ลองส่งชื่อที่เขียนด้วยอักษรอาหรับไปยัง GenderAPI.io V2 และเรียนรู้ว่าเครื่องหมายกำกับเสียง การจับคู่ชื่อเต็ม บริบทประเทศ AI สำรอง และผลลัพธ์ที่ไม่ทราบทำงานอย่างไรก่อนเริ่มเชื่อมต่อ

Canonical HTML: https://www.genderapi.io/th/determine-gender-from-arabic-names

Last reviewed: 2026-09-30

## คงการสะกดภาษาอาหรับไว้และตรวจสอบชื่อที่จับคู่ได้

ส่งชื่อในรูปการสะกด Unicode ดั้งเดิม ช่องกรอกด้านล่างใช้ข้อความภาษาอาหรับที่เขียนจากขวาไปซ้าย ส่วนคู่มือนี้และการตอบกลับ JSON อ่านจากซ้ายไปขวา API รับข้อความนี้ได้โดยไม่ต้องถอดเสียงเป็นอักษรละตินที่ฝั่งไคลเอนต์ก่อน แต่การรับข้อความได้ไม่ได้เป็นการสัญญาว่าชุดข้อมูลมีชื่อนั้นอยู่

การค้นหาในชุดข้อมูลใช้การทำให้เป็นมาตรฐานแบบ Unicode NFKC และการแยกโทเค็น ไม่มีกฎทั่วไปที่ตัดเครื่องหมายกำกับเสียงภาษาอาหรับออกหรือถือว่าการสะกดที่ต่างกันเป็นแบบเดียวกัน เครื่องหมายสระและความต่างของการสะกดอื่นๆ จึงอาจทำให้ได้คีย์ที่จัดเก็บไว้ต่างกัน เก็บค่าดั้งเดิมไว้ และอย่าถือว่าทุกรูปแบบเป็นบุคคลเดียวกันโดยไม่แจ้ง

ชื่อเต็มอาจให้โทเค็นตัวเลือกได้หลายโทเค็น ระบบจะเลือกแถวที่มีจำนวนรวมที่จัดเก็บไว้มากที่สุดในบรรดาแถวที่มีอยู่ จึงไม่รับประกันว่าคำแรกจะเป็นชื่อที่ส่งคืน ตรวจสอบ data.name และ data.match ก่อนนำผลลัพธ์ไปเพิ่มในเรคคอร์ด

| ตัวอย่างข้อมูลนำเข้า | ความหมาย | สิ่งที่ควรตรวจสอบ |
| --- | --- | --- |
| `ليلى الخطيب` | ตัวอย่างชื่อเต็ม | อาจมีการพิจารณาหลายโทเค็น ให้ตรวจสอบการจับคู่ที่ถูกเลือก ตัวอย่างนี้ไม่ได้แสดงผลลัพธ์ของคำขอจริง |
| `ليلى / لَيْلَى` | การสะกดที่ไม่มีและมีเครื่องหมายสระ | ส่งการสะกดจริงตามเดิม ไม่รับประกันว่าสองสตริงนี้จะเชื่อมไปยังแถวที่จัดเก็บไว้แถวเดียวกัน |
| `Layla / Leila` | การสะกดด้วยอักษรละติน | เป็นข้อมูลนำเข้าคนละค่า V2 ไม่ได้สัญญาว่าการถอดเสียงแต่ละแบบจะเทียบเท่ากันโดยอัตโนมัติ |
| `country: SA` | บริบทเดโมของซาอุดีอาระเบีย | บริบทนี้ไม่ใช่ค่าเริ่มต้นสำหรับทุกชุมชนที่ใช้ภาษาอาหรับ หากไม่ทราบประเทศ ให้ละ country ไว้ |

## เลือกบริบทประเทศ SA อย่างระมัดระวัง

เดโมบนหน้านี้ส่งบริบท country: SA (ซาอุดีอาระเบีย) API ไม่ได้เลือกประเทศนี้จากระบบการเขียนของชื่อ ในการเชื่อมต่อของคุณ ให้ใช้บริบทที่ทราบและเกี่ยวข้อง หรือละ country ไว้ อย่าใช้ค่าตัวอย่างนี้เป็นค่าเริ่มต้นสำหรับทุกเรคคอร์ด

สำหรับชื่อตัวเลือกแต่ละรายการ การค้นหาในชุดข้อมูลจะใช้แถวตามประเทศก่อนหากมี หากไม่มีจะพิจารณาแถวส่วนกลาง จากนั้นจะเลือกชื่อตัวเลือกที่มีจำนวนรวมที่จัดเก็บไว้มากที่สุดในบรรดาชื่อตัวเลือกที่ใช้ได้ ตรวจสอบขอบเขตการจับคู่จริงใน data.match.scope และ data.match.country แถวตามประเทศที่กำกวมจะไม่ถูกแทนที่ด้วยผลลัพธ์ส่วนกลางโดยอัตโนมัติ แต่ fallback อาจใช้ AI แทน

data.input.country แสดงบริบทของคำขอ ส่วน data.country และ data.country_source แสดงความเชื่อมโยงที่ส่งคืน ทั้งสองเป็นฟิลด์คนละฟิลด์ และไม่ได้บ่งบอกสัญชาติ เชื้อชาติ หรือถิ่นที่อยู่

- [เอกสารอ้างอิงบริบทประเทศและวิธีจับคู่](https://www.genderapi.io/th/docs/v2/gender-from-name#country-evidence-workflow)

## ส่งชื่ออาหรับด้วย V2

ตั้งค่าคีย์ API ที่มีอยู่ใน GENDERAPI_API_KEY แล้วรันคำขอบนเซิร์ฟเวอร์ ตัวอย่างนี้เปิดใช้ AI สำรองแบบปกติอย่างชัดเจน ตัวอย่างนี้แสดงเพียงรูปแบบของคำขอ ไม่ใช่ผลการคาดการณ์หรือผลความครอบคลุมที่วัดได้ หากต้องการใช้เฉพาะชุดข้อมูล ให้ใช้ options.ai_mode: off

รันตัวอย่างเหล่านี้บนเซิร์ฟเวอร์ของคุณ ตั้งค่า GENDERAPI_API_KEY ในสภาพแวดล้อมของโปรเซสเป็นคีย์ API ที่มีอยู่ ตรวจสอบว่า meta.access.mode เป็น api_key เพราะคีย์ที่ระบบไม่รู้จักอาจทำให้ใช้การทดลองใช้ตาม IP แทน

คำขอคาดการณ์ทุกครั้งเป็นงานใหม่ที่มีการหักเครดิต รวมถึงคำขอที่ส่งซ้ำ ตัวอย่างเหล่านี้ไม่ส่งคำขอซ้ำโดยอัตโนมัติ ตรวจสอบสถานะการหักเครดิตก่อนส่งคำขออีกครั้ง

การตอบกลับ JSON ที่มี HTTP 4xx และ 5xx จะคงเนื้อหาข้อผิดพลาดไว้และจบด้วยสถานะการออกที่ไม่ใช่ศูนย์ ตรวจสอบ code, action และ meta.usage.billing_status ก่อนส่งคำขอซ้ำ

**cURL**

cURL 7.76+ ในเชลล์ POSIX รันในเทอร์มินัล

```bash
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": "SA",
  "options": {
    "ai_mode": "fallback"
  }
}'
```

**JavaScript / Node.js**

Node.js 22+ พร้อม fetch ในตัว บันทึกเป็น example.mjs แล้วรัน node example.mjs

```javascript
// 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": "SA",
  "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.
}
```

**Python**

Python 3.10+ พร้อมไลบรารีมาตรฐาน บันทึกเป็น example.py แล้วรัน python3 example.py

```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\":\"SA\",\"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.
```

**PHP**

PHP 8+ พร้อมส่วนขยาย cURL บันทึกเป็น example.php แล้วรัน php example.php

```php
<?php
$apiKey = getenv('GENDERAPI_API_KEY');
if (!$apiKey) {
    throw new RuntimeException('Set GENDERAPI_API_KEY');
}
$body = json_decode('{"type":"name","value":"ليلى الخطيب","country":"SA","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.
```

**Java**

Java 17+ พร้อมไคลเอนต์ HTTP มาตรฐาน บันทึกเป็น GenderApiExample.java แล้วรัน java GenderApiExample.java

```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\":\"SA\",\"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.
    }
}
```

**C# / .NET**

แอปพลิเคชันคอนโซล .NET 8+ ใช้เป็น Program.cs ในโปรเจกต์คอนโซล แล้วรัน dotnet run

```csharp
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\":\"SA\",\"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.
}
```

**Go**

Go 1.22+ พร้อมไลบรารีมาตรฐาน บันทึกเป็น main.go แล้วรัน go run main.go

```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\":\"SA\",\"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)
    }
}
```

- [พารามิเตอร์คำขอสำหรับชื่อ](https://www.genderapi.io/th/docs/v2/gender-from-name)
- [ตั้งค่าการยืนยันตัวตน](https://www.genderapi.io/th/docs/v2/authentication)

## เก็บผลลัพธ์ไว้คู่กับหลักฐาน

ความเชื่อมโยงที่ได้จากการคาดการณ์ไม่ใช่เพศที่บุคคลระบุด้วยตนเอง เก็บข้อมูลนำเข้าต้นฉบับ หลักฐานที่ส่งคืน และข้อมูลที่บุคคลนั้นให้ไว้แยกจากกัน ผลลัพธ์ที่ไม่ทราบเป็นผลลัพธ์ที่ถูกต้อง จึงไม่ควรเปลี่ยนเป็นหมวดหมู่ที่เดาขึ้นในแอปพลิเคชันของคุณ

| ฟิลด์ | วิธีใช้ |
| --- | --- |
| `data.gender / data.result_status` | ใช้ male หรือ female เฉพาะเมื่อเป็น identified เมื่อผลลัพธ์เป็น unknown ให้คงค่า 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 ผลลัพธ์ที่ไม่ทราบซึ่งดำเนินการสำเร็จจะถูกหักเครดิต การไม่ได้รับการตอบกลับไม่ได้แปลว่าคำขอนั้นไม่มีค่าใช้จ่าย |

- [ฟิลด์ในการตอบกลับและผลลัพธ์ที่ไม่ทราบ](https://www.genderapi.io/th/docs/v2/responses)
- [คำอธิบายความแม่นยำและค่าความเชื่อมั่น](https://www.genderapi.io/th/accuracy-methodology)
- [แหล่งข้อมูลและภาพรวมชุดข้อมูลที่ระบุวันที่](https://www.genderapi.io/th/data-provenance)

## เลือกว่าจะใช้ AI เมื่อใด

forceToGenderize เป็นตัวเลือกที่ไม่บังคับสำหรับชื่อ ที่อยู่อีเมล และชื่อผู้ใช้ เมื่อเปิดใช้ ให้ละ 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 ตีความชื่อเล่นหรือนามแฝงของบุคคลได้แม้ไม่มีชื่อจริง | 1 เมื่อชุดข้อมูลระบุเพศได้ หรือรวม 2 หากใช้ AI |

- [ตัวเลือก AI และการคาดการณ์จากชื่อเล่น](https://www.genderapi.io/th/docs/v2/ai-options)
- [เครดิตและการใช้งาน](https://www.genderapi.io/th/docs/v2/credits-and-usage)

## ประมวลผลรายชื่อโดยไม่สูญเสียบริบท

POST /api/v2/gender/batch รองรับสูงสุด 50 รายการด้วยคีย์ API ที่ลงทะเบียนแล้ว และสูงสุด 10 รายการในการทดลองใช้ตาม IP กำหนด ID ที่ไม่ซ้ำกันให้แต่ละรายการ และเก็บค่าดั้งเดิมของแต่ละแถวไว้ แต่ละรายการกำหนดประเทศและนโยบาย AI แยกกันได้ หากไม่ทราบประเทศ ให้ละ country ไว้

คำขอเดี่ยวใช้ fallback เป็นค่าเริ่มต้น แต่รายการในคำขอแบบกลุ่มใช้โหมดเฉพาะชุดข้อมูลเป็นค่าเริ่มต้น กำหนด options.ai_mode: fallback ให้แต่ละรายการที่ต้องการ AI แม้จะได้รับ HTTP 200 แล้ว ให้ตรวจสอบทุกผลลัพธ์ คงผลลัพธ์ที่ไม่ทราบไว้ตามเดิม และตรวจสอบข้อผิดพลาดของแต่ละรายการและการหักเครดิตก่อนส่งซ้ำ รายการปกติที่สำเร็จใช้รายการละ 1 เครดิต คำขอ HTTP แบบกลุ่มหนึ่งครั้งจึงไม่เท่ากับเครดิตการคาดการณ์หนึ่งเครดิต

- [ตัวอย่างคำขอแบบกลุ่มและความล้มเหลวบางส่วน](https://www.genderapi.io/th/docs/v2/batch#batch-application-workflow)
- [จัดการผลลัพธ์ที่ไม่ทราบในแอปพลิเคชัน](https://www.genderapi.io/th/docs/v2/responses#application-decisions)

## ทำความเข้าใจข้อมูลที่คุณส่ง

เดโมบนหน้านี้จะส่งค่าที่กรอกไปยัง GenderAPI.io เฉพาะเมื่อคุณกดส่งเท่านั้น หากมีการใช้ AI ระบบจะส่ง type, value และบริบทประเทศที่ส่งมาไปยังบริการคาดการณ์ที่กำหนดค่าไว้ หากต้องการคาดการณ์จากชุดข้อมูลเท่านั้น ให้ใช้ options.ai_mode: off โดยไม่ใช้ forceToGenderize ในการเชื่อมต่อของคุณ

นโยบายความเป็นส่วนตัว ข้อตกลงการประมวลผลข้อมูล และรายชื่อผู้ประมวลผลข้อมูลช่วงอธิบายเงื่อนไขการจัดการข้อมูลที่เผยแพร่ไว้ ผลลัพธ์เป็นความเชื่อมโยงที่ได้จากการคาดการณ์ ให้ข้อมูลที่บุคคลนั้นให้ไว้มีความสำคัญกว่า และอย่าใช้ผลลัพธ์เป็นพื้นฐานของการตัดสินใจที่มีผลกระทบสำคัญต่อบุคคล

- [นโยบายความเป็นส่วนตัว](https://www.genderapi.io/th/privacy-policy)
- [ข้อตกลงการประมวลผลข้อมูล](https://www.genderapi.io/th/data-processing-agreement)
- [รายชื่อผู้ประมวลผลข้อมูลช่วง](https://www.genderapi.io/th/subprocessors)

## V2 รับข้อความภาษาอาหรับที่มีเครื่องหมายกำกับเสียงหรือไม่?

รับข้อมูลนำเข้าชื่อแบบ Unicode รวมถึงข้อความภาษาอาหรับ การทำให้เป็นมาตรฐานของชุดข้อมูลโดยทั่วไปไม่ได้ตัดเครื่องหมายสระภาษาอาหรับออก การสะกดที่มีและไม่มีเครื่องหมายสระจึงอาจให้การจับคู่ต่างกันหรือให้ผลลัพธ์ที่ไม่ทราบ

## เครื่องมือนี้ระบุสัญชาติของผู้ที่ใช้ภาษาอาหรับหรือไม่?

ไม่ SA เป็นบริบทประเทศที่ระบุไว้อย่างชัดเจนสำหรับเดโมนี้ ระบบการเขียน ความเชื่อมโยงกับชื่อ และฟิลด์ประเทศที่ส่งคืนไม่ได้บ่งบอกสัญชาติหรือถิ่นที่อยู่

## มีการวัดความแม่นยำสำหรับชื่ออาหรับทุกชื่อหรือไม่?

หน้านี้ไม่ได้เผยแพร่ผลการวัดดังกล่าว การที่ระบบรับข้อมูลนำเข้าได้ จำนวนที่จัดเก็บไว้ และค่าความเชื่อมั่นไม่ใช่เกณฑ์มาตรฐานความแม่นยำที่เป็นอิสระ ดูหลักฐานที่มีอยู่และการวัดที่ยังไม่ได้เผยแพร่ได้ในหน้าวิธีการ

## ผลลัพธ์ที่ไม่ทราบใช้เครดิตหรือไม่?

ผลลัพธ์ที่ไม่ทราบซึ่งดำเนินการสำเร็จก็ถูกหักเครดิต โหมดชุดข้อมูลแบบปกติหรือโหมด fallback ใช้รวม 1 เครดิต หากใช้ forceToGenderize จะใช้ 1 เครดิตเมื่อได้ผลจากชุดข้อมูล หรือรวม 2 เครดิตเมื่อใช้ AI รวมถึงผลลัพธ์ที่ไม่ทราบจาก AI ข้อผิดพลาดมีกฎการหักเครดิตแยกต่างหาก ให้ตรวจสอบ meta.usage
