# API v2 JSON respuestas y confianza > Comprenda los metacampos y los datos de GenderAPI v2: género, motivos desconocidos, confianza, evidencia del conjunto de datos, puntuaciones de IA, modo de acceso y metadatos de facturación. Canonical HTML: https://www.genderapi.io/es/docs/v2/responses Last reviewed: 2026-09-25 ## Comprender la respuesta JSON Las respuestas únicas exitosas contienen data y meta. La respuesta del conjunto de datos a continuación es un ejemplo ilustrativo, no una medición de la precisión del producto ni una promesa del mismo resultado en vivo. Muestra acceso de prueba de IP. Las solicitudes autenticadas con una clave de cuenta devuelven access.mode: api_key; Los campos que se aplican solo a la prueba tienen el valor null. | Campo | Significado | | --- | --- | | data.input | Tipo de entrada, valor y país. forceToGenderize se incluye cuando true. | | data.name | Nombre de pila coincidente o extraído; null cuando no hay ninguno disponible. | | data.gender | male, female o JSON null. Esta es una predicción, no una prueba de la identidad de una persona. | | data.result_status / reason | Cuando result_status es identified, reason es null. Cuando el estado es unknown, el motivo es not_found, no_name_candidate, ambiguous o insufficient_evidence. | | data.confidence | Puntuación 0–1 o null. El género nulo tiene confianza null. | | data.confidence_kind | observed_frequency: el recuento de género dominante dividido por el recuento total en el conjunto de datos seleccionado. model_reported: una puntuación de IA, no una probabilidad calibrada. El valor es null cuando no está disponible. | | data.sample_count | Tamaño de muestra del conjunto de datos o null. La IA no inventa un recuento de muestras. | | data.source | dataset, ai o none. | | data.country / country_source | Asociación de país del conjunto de datos o ai_association, o null. No establece nacionalidad, residencia ni etnia. | | data.match | Nombre coincidente en el conjunto de datos, método (normalized, token, substring o model_inference), ámbito (country o global) y país de la coincidencia. La información no disponible se representa con null. | | meta.request_id / duration_ms | Identificador de operación y duración del procesamiento en milisegundos. | | meta.access | Cómo se otorgó el acceso y el motivo de la reserva de prueba, si corresponde. | | meta.usage | Cargo neto, saldo de tiempo de finalización, estado de facturación e información de reinicio de prueba. | ```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 } } } ``` - [Esquemas de respuesta completos y ejemplos por lotes](https://api.genderapi.io/api/v2/openapi.json) ## Un resultado exitoso desconocido HTTP 200 significa que la operación se completó; no garantiza un género. Conserve JSON null en lugar de convertirlo a male, female, una cadena vacía o confianza cero. Verifique data.result_status y data.reason por separado de los errores HTTP. Este ejemplo de conjunto de datos únicamente devuelve source: none y reason: not_found y aún cuesta 1 crédito. Si los recuentos del conjunto de datos para los dos géneros son iguales, el resultado puede contener reason: ambiguous y conservar sample_count. Un resultado de IA desconocido utiliza source: ai y 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 } } } ``` ## Interpretar la confianza y la evidencia coincidente Una confianza de 0,9 está en una escala de 0 a 1. Para observed_frequency significa el recuento dominante dividido por el total del conjunto de datos seleccionado; no se mide la precisión del producto de un extremo a otro. La IA proporciona una puntuación model_reported y no está calibrada con respecto a las frecuencias del conjunto de datos. Elija cualquier umbral de aplicación utilizando sus propios datos de evaluación y confidence_kind. No clasifique directamente el conjunto de datos y las puntuaciones de IA como si midieran lo mismo. IA match.name, match.scope y match.country son null porque no se seleccionó ninguna fila del conjunto de datos; match.method es model_inference. Para nombres completos, el resultado de un conjunto de datos puede provenir de un componente en lugar de la cadena completa. data.input conserva el valor enviado; data.name describe el nombre devuelto y data.match describe el candidato y el alcance de la búsqueda. ## Guías relacionadas - [Respuesta por lotes y errores por elemento](https://www.genderapi.io/es/docs/v2/batch#batch-response) - [Estado de facturación y créditos restantes](https://www.genderapi.io/es/docs/v2/credits-and-usage) - [Compatibilidad de respuestas y reintentos](https://www.genderapi.io/es/docs/v2/errors-and-retries#retries)