# GenderAPI v1 から v2 への移行

> 同じ API キーとバランスを使用して、GenderAPI 統合を v1 から v2 に移動します。リクエスト フィールド、バッチ ルート、応答、エラー、および再試行動作をマップします。

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

Last reviewed: 2026-09-25

## 統合を v1 から v2 に移動する

V1 は引き続き利用可能です。準備ができたら、同じキーとクレジット残高を使用して個々の統合を移行します。 V2 はリクエストとレスポンスのコントラクトが異なるため、URL のみを変更するだけでは十分ではありません。

| V1コンセプト | V2相当 |
| --- | --- |
| 名前、電子メール、ユーザー名の個別のエンドポイント | POST /api/v2/gender と type および value |
| 複数のエンドポイントを分離する | POST /api/v2/gender/batch と items |
| askToAI | options.ai_mode: fallback;単一リクエストはすでにデフォルトで fallback に設定されています |
| forceToGenderize | 3 つのタイプすべてで同じオプションのフィールド。最初にデータセット、次にニックネーム認識 AI |
| フラット応答フィールド | 結果については data。アクセスと請求用の meta |
| probability パーセンテージ | 0 ～ 1 スケールの confidence に confidence_kind を加えたもの。 AI スコアは調整された確率ではありません |
| total_names | data.sample_count、null 可能 |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| レガシーエラー形式 | HTTP ステータスと Problem Details code および action |
| POST が再試行します | 各再試行は通常の課金による新しい操作です |

- [v1 リファレンスを読む](https://www.genderapi.io/ja/api-documentation/v1)
- [v2 OpenAPI コントラクトを使用する](https://api.genderapi.io/api/v2/openapi.json)

## クライアントを更新して検証する

移行する統合には、v2 リクエストおよびレスポンス コントラクトを使用します。再試行する前に、meta.access.mode を確認し、JSON null の結果を保存し、項目ごとのバッチ エラーを検査し、請求を確認します。クライアントが更新されるまで、v1 統合を既存のパスに保持します。

- [認証から始める](https://www.genderapi.io/ja/docs/v2/authentication)
- [v2 レスポンスを読み取る](https://www.genderapi.io/ja/docs/v2/responses)
- [ハンドルの再試行](https://www.genderapi.io/ja/docs/v2/errors-and-retries)