¿Qué significa source en V2?
source identifica la vía que produjo el resultado final: conjunto de datos almacenado, inferencia de IA o ausencia de una fuente seleccionada. No es una atribución al editor original, una licencia ni una garantía de exactitud.
Esta guía describe el contrato V2 y una revisión de la propia base de datos de GenderAPI.io. El inventario y las comprobaciones de coherencia siguientes son observaciones medidas; todavía no se ha publicado un catálogo revisado de fuentes originales ni una evaluación independiente de exactitud.
| source | Qué indica | Qué no demuestra |
|---|---|---|
dataset | Se seleccionó un registro; si sus recuentos empatan, el género puede seguir siendo desconocido | Editor original, método de recopilación, licencia, antigüedad o independencia de las observaciones |
ai | El resultado final procede de la vía de IA configurada; gender puede ser null | Muestra contabilizada, atribución al conjunto de datos o exactitud calibrada |
none | No se seleccionó un registro para el resultado final de solo conjunto de datos | Que no exista ninguna asociación del nombre en ningún idioma o comunidad |
Inventario de la base de datos: 26 de septiembre de 2026
Los metadatos se consultaron en 2026-09-26T15:28:18.227Z y las muestras aleatorias en 2026-09-26T15:31:54.045Z. Los recuentos proceden de MongoDB collStats, no de un censo completo independiente. La colección general contiene registros de nombres y la específica contiene pares nombre–país. Sumarlas no produce un total de nombres o personas únicos.
Las comprobaciones agregadas se calcularon en el servidor sobre 5.000 documentos seleccionados aleatoriamente por MongoDB en cada colección. El informe público no contiene nombres ni registros individuales. Son observaciones de GenderAPI.io sobre la base activa, no una auditoría independiente ni una instantánea de evaluación congelada.
| Observación | Registros generales | Registros por país |
|---|---|---|
| Colección | general | country-specific |
| Documentos según metadatos | 2.483.220 | 4.080.692 |
| Clave única almacenada | name | name + country |
| Documentos muestreados aleatoriamente | 5000 | 5000 |
| Incumplimientos numéricos en la muestra | 0 | 0 |
| Discrepancias entre male + female y total | 0 | 0 |
| Registros con male y female iguales | 124 | 94 |
| Documentos de la muestra con updated_at | 667 / 5000 | 741 / 5000 |
Qué permiten comprobar estos controles
El control numérico exige que total sea un entero seguro positivo y que male y female sean finitos y estén entre cero y total. Otra comprobación compara male + female con total. Todos los contadores muestreados superaron estos controles; no demuestra que todos los registros sean coherentes ni que las predicciones sean correctas.
En la muestra general hubo 124 registros con male y female iguales; en la específica por país, 94. Son empates en recuentos almacenados, no identidades verificadas ni la tasa de resultados unknown de la API. La respuesta depende de la entrada, el acceso a Redis, la selección de candidatos y las opciones de IA.
Una inspección separada de la colección general, en 2026-09-26T15:33:13.811Z, encontró 244 valores distintos en country: 239 tenían el formato de dos letras mayúsculas y 5 no. No se midió su pertenencia a ISO, la distribución de registros por país ni la cobertura admitida. No son un recuento de países compatibles.
No se observaron campos de fuente o licencia en las dos muestras. Eso no demuestra su ausencia en todos los registros o en sistemas externos. Algunos registros tenían updated_at numérico; no se analizaron los valores ni su significado, por lo que no permiten deducir antigüedad ni frecuencia de actualización.
V2 consulta el conjunto de datos mediante Redis. GenderAPI.io ha confirmado que MongoDB y Redis contienen el mismo conjunto de datos; esta revisión no volvió a comprobar esa equivalencia. El inventario describe registros, mientras que la cobertura de respuesta depende también de las entradas, las coincidencias y las opciones de IA. Las muestras no tienen semilla fija, instantánea congelada ni referencias independientes. Por tanto, no permiten medir exactitud predictiva, calibración ni cobertura de respuesta.
Lee las evidencias de la respuesta
| Campo | Significado | Límite |
|---|---|---|
input | Refleja el tipo, valor y contexto de país enviados | No es una identidad verificada de forma independiente |
match.name / match.method | Candidato seleccionado y método: normalización, componentes, fragmentos o inferencia del modelo | No garantiza extraer el nombre de pila real de un nombre completo o usuario |
match.scope / match.country | Indica si el registro seleccionado es global o específico del país | Enviar un país no garantiza que exista un registro específico |
sample_count | total del registro seleccionado; null con IA | No tiene por qué representar personas únicas, observaciones independientes ni una muestra de exactitud |
confidence / confidence_kind | Distingue la proporción de recuentos de la puntuación declarada por el modelo | No es una probabilidad verificada de la identidad de género |
country / country_source | Metadatos de país del registro, si existen, o asociación de nombre y país de la IA | No demuestra nacionalidad, residencia, origen verificado ni coincidencia con el país enviado |
Cómo influye la selección de candidatos
La búsqueda normaliza el texto y extrae candidatos. En correos utiliza la parte anterior a @; en usuarios elimina el @ inicial opcional. Las búsquedas estándar de correo y usuario también pueden probar fragmentos de longitud limitada. Si coinciden varios registros, se selecciona el de mayor total, que puede no ser el nombre de pila previsto.
Cuando se envía country, para cada candidato se prueba el registro específico del país y, si no existe, el global. La respuesta muestra la coincidencia seleccionada. Un empate en el registro específico no lo sustituye automáticamente por el global.
El prompt estándar de IA busca un nombre personal reconocible. forceToGenderize también permite asociaciones de alias o apodos personales; en ese modo puede devolverse género con name: null. Son tareas de inferencia distintas y deben evaluarse por separado.
Vías de procesamiento: conjunto de datos e IA
Cuando se invoca IA, el servicio configurado recibe type, value y el contexto de país enviados. Para correos, el prompt indica que ignore el dominio y el sufijo que empieza por +; eso no significa que se eliminen antes del envío. Para trabajar solo con el conjunto de datos, utiliza ai_mode: off sin forceToGenderize.
La validación de IA comprueba campos JSON, tipos y coherencia entre campos. No demuestra que el nombre, el género o la asociación de país sean correctos. La respuesta pública no incluye identidad o versión del modelo ni atribución a fuentes de la inferencia.
| Opción | Vía de procesamiento | Evidencia devuelta |
|---|---|---|
| ai_mode: off | Solo conjunto de datos | Registro seleccionado o resultado desconocido sin registro |
| ai_mode: fallback | Primero datos; IA si no se devuelve género | Evidencia de la vía final, no una muestra combinada de datos e IA |
| ai_mode: always | Directamente la IA configurada | Puntuación del modelo o desconocido con confianza null; sample_count siempre null |
| forceToGenderize: true | Primero datos; después IA capaz de interpretar alias si no se resuelve | Evidencia del registro o asociación de alias del modelo; name puede ser null |
Documentación de fuentes aún no publicada
No se publica aquí un catálogo revisado de fuentes originales. El contrato y el comportamiento de la aplicación no verifican por sí solos el origen, los permisos, la representatividad ni la calidad de las etiquetas. Las afirmaciones sobre fuentes concretas requieren documentar y revisar los registros siguientes.
Esta revisión no concluye si las fuentes tienen o no licencia ni si están completas; explica los límites de la evidencia pública. Contacta con GenderAPI.io si tu uso requiere una evaluación específica de las fuentes.
| Evidencia | Registro necesario | Estado publicado |
|---|---|---|
| Origen y permisos | Fuente o editor, periodo de recopilación, licencia o base documentada de uso | No se ha publicado un catálogo revisado |
| Historial de procesamiento | Transformación, normalización, deduplicación, combinación y aportaciones sintéticas o de modelos | source: dataset no describe estos procesos |
| Cobertura de comunidades | Países y escrituras, selección, definiciones de etiquetas y sesgos | No hay cifras de cobertura evaluadas independientemente publicadas |
| Actualización | Identificadores de instantánea, fechas de las fuentes y calendario documentado | La respuesta V2 no incluye antigüedad del registro ni identificador de instantánea |
| Calidad y correcciones | Validación, solapamientos, corrección o eliminación y responsables de revisión | No hay resultados de auditoría por fuente publicados |
Privacidad, procesamiento y uso responsable
El origen de los datos, su tratamiento y las condiciones legales son asuntos distintos. Consulta las políticas vigentes para conocer funciones, conservación, proveedores y condiciones contractuales. Esta guía técnica no añade promesas de conservación ni certificaciones legales.
Envía solo lo necesario para tu proceso. Conserva los tipos de confianza y los resultados desconocidos; no presentes una inferencia como una declaración de identidad de la persona. No la utilices como fundamento de decisiones con consecuencias importantes para alguien.
Evidencia de exactitud e historial de revisión
La etiqueta de fuente describe la vía de inferencia, no una calidad medida. Consulta la guía de exactitud para distinguir confianza, cobertura, errores y evaluación reproducible.
| Fecha | Versión del documento | Cambio |
|---|---|---|
| 2026-09-28 | 1.0.0 | Adaptación al español del inventario MongoDB fechado, los controles muestrales y las evidencias V2 e IA. La equivalencia con Redis se basa en la confirmación de GenderAPI.io. No se añaden porcentajes de exactitud ni afirmaciones sobre licencias. |