Code Samples & Integration Guides

#!/usr/bin/env python3 """ H‑ear.World API - Python Example Classify audio from URL or local file """ import requests import base64 import sys API_KEY = "ncm_YOUR_API_KEY" API_URL = "https://api.h-ear.world/api/v1" def classify_from_url(audio_url: str) -> dict: """Classify audio from a public URL""" response = requests.post( f"{API_URL}/classify", headers={ "X-NCM-Api-Key": API_KEY, "Content-Type": "application/json" }, json={ "url": audio_url, "threshold": 0.3 # Optional: confidence threshold }, timeout=300 # 5 min timeout for processing ) response.raise_for_status() return response.json() def classify_from_file(file_path: str) -> dict: """Classify audio from local file (base64 encoded)""" with open(file_path, "rb") as f: audio_base64 = base64.b64encode(f.read()).decode("utf-8") response = requests.post( f"{API_URL}/classify", headers={ "X-NCM-Api-Key": API_KEY, "Content-Type": "application/json" }, json={ "base64": audio_base64, "fileName": file_path.split("/")[-1] }, timeout=300 ) response.raise_for_status() return response.json() if __name__ == "__main__": # Example usage result = classify_from_url("https://example.com/dog-barking.mp3") print(f"Request ID: {result['requestId']}") print(f"Duration: {result['duration']}s") print(f"Events found: {result['eventCount']}") print("\nClassifications:") for c in result.get("classifications", []): print(f" - {c['class']}: {c['confidence']:.1%}") print(f"\nStatus: {result.get('status', 'N/A')}")