Saltar al contenido principal

API de género por voz

Detecta el género probable de una persona a partir de un archivo de audio o de una URL de audio.

URL base​

https://api.genderrecognition.com

Endpoint para archivos​

POST /v1/voice-gender-recognition/api

Encabezados​

apiKey: YOUR_API_KEY
Content-Type: multipart/form-data

Cuerpo de la solicitud​

CampoTipoObligatorioDescripción
filefileSíArchivo de audio que se analizará.

Ejemplo​

curl -X POST "https://api.genderrecognition.com/v1/voice-gender-recognition/api" \
  -H "apiKey: YOUR_API_KEY" \
  -F "file=@audio.wav"

Endpoint para URL​

POST /v1/voice-gender-recognition/api/url

Encabezados​

apiKey: YOUR_API_KEY
Content-Type: application/json

Cuerpo de la solicitud​

{
  "url": "https://example.com/audio.wav"
}

Respuesta​

Las solicitudes con archivo devuelven la predicción, el porcentaje de confianza y los metadatos actualizados de la cuota.

{
  "success": true,
  "gender": "male",
  "confidence": 97,
  "remainingRequests": 2999
}

Las solicitudes con URL devuelven la predicción y los metadatos de la cuota. Las primeras solicitudes lentas también pueden incluir un mensaje info.

{
  "success": true,
  "gender": "male",
  "remainingRequests": 2999
}

Errores posibles​

Falta la clave API​

{
  "error": "API key is required"
}

Clave API no válida​

{
  "error": "Invalid API key"
}

Falta el archivo​

{
  "error": "No file uploaded"
}

Tipo de archivo no válido​

{
  "error": "Invalid file type. Only audio formats are allowed"
}

Solicitud de URL no válida​

{
  "error": "A valid http or https URL is required"
}

Falta el encabezado de tipo de contenido JSON​

{
  "error": "Content-Type header is required. Please set Content-Type: application/json"
}

Tipo de contenido JSON no admitido​

{
  "error": "Content-Type must be application/json"
}

Cuota excedida​

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "You have exceeded your free tier limit of 50 requests.",
    "detailedMessage": "Insufficient remaining requests. Required: 1, Available: 0",
    "details": {
      "limit": 50,
      "used": 50,
      "reset_date": "2026-07-01T00:00:00.000Z"
    },
    "suggested_action": "Please upgrade to a premium plan to continue using the API."
  }
}

Notas​

  • Las solicitudes con archivo usan datos de formulario multipart.
  • Las solicitudes con URL usan JSON.
  • Envía los archivos de audio en el campo file; no pueden superar los 10 MB.