# API v2 JSON の応答と信頼性

> GenderAPI v2 データとメタ フィールドを理解します: 性別、不明な理由、信頼度、データセットの証拠、AI スコア、アクセス モード、請求メタデータ。

Canonical HTML: https://www.genderapi.io/ja/docs/v2/responses

Last reviewed: 2026-09-25

## JSON 応答を理解する

成功した単一応答には、data および meta が含まれます。以下のデータセットの応答は説明のための例であり、製品の精度の測定や同じ実際の結果を保証するものではありません。 IPトライアルアクセスを示しています。アカウント キーで認証されたリクエストは access.mode: api_key を返します。トライアルにのみ適用されるフィールドの値は null です。

| フィールド | 意味 |
| --- | --- |
| data.input | タイプ、値、国を入力します。 trueの場合はforceToGenderizeが付属します。 |
| data.name | 一致または抽出された名前。利用可能なものが存在しない場合は、null。 |
| data.gender | male、female、または JSON null。これは予測であり、個人の身元を証明するものではありません。 |
| data.result_status / reason | result_status が identified の場合、reason は null となります。ステータスが unknown の場合、理由は not_found、no_name_candidate、ambiguous、または insufficient_evidence です。 |
| data.confidence | 0–1 スコアまたは null。ヌルジェンダーはnullに自信を持っています。 |
| data.confidence_kind | observed_frequency: 選択したデータセット内の主要な性別の数を合計数で割ったもの。 model_reported: 調整された確率ではなく、AI スコア。使用できない場合、値は null です。 |
| data.sample_count | データセットのサンプル サイズまたは null。 AI はサンプル数を発明しません。 |
| data.source | dataset、ai、または none。 |
| data.country / country_source | データセット、ai_association、または null からの国との関連付け。国籍、居住地、民族を確立しません。 |
| data.match | データセット内の一致した名前、照合方法（normalized、token、substring、model_inference）、範囲（country または global）、一致した国を示します。取得できない根拠は null になります。 |
| meta.request_id / duration_ms | 操作識別子と処理時間 (ミリ秒単位)。 |
| meta.access | アクセスが許可された方法と、トライアルフォールバックの理由 (存在する場合)。 |
| meta.usage | 正味料金、完了時間残高、請求ステータス、トライアルリセット情報。 |

```json
{
  "data": {
    "input": {
      "type": "name",
      "value": "Onur",
      "country": "TR"
    },
    "name": "onur",
    "gender": "male",
    "country": "TR",
    "confidence": 0.9,
    "confidence_kind": "observed_frequency",
    "sample_count": 100,
    "source": "dataset",
    "result_status": "identified",
    "reason": null,
    "country_source": "dataset",
    "match": {
      "name": "onur",
      "method": "normalized",
      "scope": "country",
      "country": "TR"
    }
  },
  "meta": {
    "request_id": "11111111-1111-4111-8111-111111111111",
    "duration_ms": 12,
    "access": {
      "mode": "ip_trial",
      "reason": "api_key_missing"
    },
    "usage": {
      "charged_credits": 1,
      "remaining_credits": 9,
      "billing_status": "confirmed",
      "resets_at": "2026-09-26T12:00:00.000Z",
      "limit": 10,
      "period_seconds": 86400
    }
  }
}
```

- [完全な応答スキーマとバッチの例](https://api.genderapi.io/api/v2/openapi.json)

## 成功した不明な結果

HTTP 200 は操作が完了したことを意味します。性別を保証するものではありません。 male、female、空の文字列、または信頼度ゼロに変換するのではなく、JSON null を保持します。 data.result_status および data.reason は、HTTP エラーとは別に確認してください。

このデータセットのみの例は、source: none および reason: not_found を返しますが、依然として 1 クレジットがかかります。 2 つの性別のデータセット数が等しい場合、結果には sample_count を保持しながら reason: ambiguous が含まれる可能性があります。不明な AI 結果では、source: ai および reason: insufficient_evidence が使用されます。

```json
{
  "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
    }
  },
  "meta": {
    "request_id": "11111111-1111-4111-8111-111111111111",
    "duration_ms": 12,
    "access": {
      "mode": "ip_trial",
      "reason": "api_key_missing"
    },
    "usage": {
      "charged_credits": 1,
      "remaining_credits": 8,
      "billing_status": "confirmed",
      "resets_at": "2026-09-26T12:00:00.000Z",
      "limit": 10,
      "period_seconds": 86400
    }
  }
}
```

## 信頼性と一致する証拠を解釈する

0.9 の信頼度は、0 ～ 1 のスケールで表されます。 observed_frequency の場合、これは支配的なカウントを選択したデータセットの合計で割った値を意味します。エンドツーエンドの製品精度は測定されません。 model_reported スコアは AI によって提供され、データセットの頻度に対して調整されていません。

独自の評価データと confidence_kind を使用して、アプリケーションのしきい値を選択します。データセットと AI スコアを、同じものを測定したかのように直接ランク付けしないでください。データセット行が選択されていないため、AI match.name、match.scope、および match.country は null になります。 match.methodはmodel_inferenceです。

完全な名前の場合、データセットの結果は完全な文字列ではなくコンポーネントから取得される場合があります。 data.input は送信された値を保存します。 data.name は返される名前を示し、data.match は候補と検索範囲を示します。

## 関連ガイド

- [バッチ応答と項目ごとのエラー](https://www.genderapi.io/ja/docs/v2/batch#batch-response)
- [請求状況とクレジット残量](https://www.genderapi.io/ja/docs/v2/credits-and-usage)
- [応答の互換性と再試行](https://www.genderapi.io/ja/docs/v2/errors-and-retries#retries)