# Migrar de GenderAPI v1 a v2

> Mover una integración GenderAPI de v1 a v2 usando la misma clave y equilibrio API. Asigne campos de solicitud, rutas por lotes, respuestas, errores y comportamiento de reintento.

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

Last reviewed: 2026-09-25

## Mover una integración de v1 a v2

V1 permanece disponible. Migre integraciones individuales cuando esté listo usando la misma clave y saldo de crédito. V2 es un contrato de solicitud y respuesta diferente, por lo que cambiar solo la URL no es suficiente.

| Concepto V1 | Equivalente V2 |
| --- | --- |
| Puntos finales separados de nombre, correo electrónico y nombre de usuario | POST /api/v2/gender con type y value |
| Separar múltiples puntos finales | POST /api/v2/gender/batch con items |
| askToAI | options.ai_mode: fallback; Las solicitudes únicas ya están predeterminadas en fallback. |
| forceToGenderize | Mismo campo opcional para los tres tipos; primero el conjunto de datos, luego la IA con reconocimiento de apodos |
| Campos de respuesta planos | data para el resultado; meta para acceso y facturación |
| probability porcentaje | confidence en una escala de 0 a 1 más confidence_kind; Las puntuaciones de IA no son probabilidades calibradas |
| total_names | data.sample_count, nullable |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| Formato de error heredado | Estado de HTTP más Problem Details code y action |
| POST reintentos | Cada reintento es una nueva operación con facturación normal |

- [Leer la referencia v1](https://www.genderapi.io/es/api-documentation/v1)
- [Utilice el contrato v2 OpenAPI](https://api.genderapi.io/api/v2/openapi.json)

## Actualiza y verifica tu cliente

Utilice el contrato de solicitud y respuesta v2 para la integración que está migrando. Verifique meta.access.mode, conserve los resultados de JSON null, inspeccione los errores de lote por elemento y verifique la facturación antes de volver a intentarlo. Mantenga las integraciones v1 en sus rutas existentes hasta que sus clientes hayan sido actualizados.

- [Comenzar con autenticación](https://www.genderapi.io/es/docs/v2/authentication)
- [Leer una respuesta v2](https://www.genderapi.io/es/docs/v2/responses)
- [Manejar reintentos](https://www.genderapi.io/es/docs/v2/errors-and-retries)