{"library":"soniox","title":"Soniox Python SDK","type":"library","description":"The official Python SDK for the Soniox API, providing fully typed access to Async and Real-time Speech-to-Text (STT) capabilities. It simplifies integration by handling authentication, file uploads, transcription polling, and real-time stream helpers. The library is actively maintained with frequent updates, aiming to be a developer-friendly ecosystem for voice AI. [2, 3]","language":"python","status":"active","last_verified":"Sun May 17","install":{"commands":["pip install soniox"],"cli":null},"imports":["from soniox import SonioxClient","from soniox import AsyncSonioxClient","from soniox.types import RealtimeSTTConfig","from soniox.types import Token","from soniox.utils import render_tokens"],"auth":{"required":false,"env_vars":[]},"links":{"homepage":"https://soniox.com","github":"https://github.com/soniox/soniox-python","docs":"https://soniox.com/docs","changelog":null,"pypi":"https://pypi.org/project/soniox/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null},"quickstart":{"code":"import os\nfrom soniox import SonioxClient\n\n# Get your API key from https://console.soniox.com/api-keys\n# It's recommended to set SONIOX_API_KEY as an environment variable.\nsoniox_api_key = os.environ.get('SONIOX_API_KEY', 'YOUR_SONIOX_API_KEY')\n\nif not soniox_api_key or soniox_api_key == 'YOUR_SONIOX_API_KEY':\n    print(\"Error: SONIOX_API_KEY environment variable not set or placeholder used.\")\n    print(\"Please set it to your actual Soniox API key.\")\nelse:\n    try:\n        client = SonioxClient(api_key=soniox_api_key)\n\n        # Example: Transcribe an audio file from a public URL asynchronously\n        print(\"Starting transcription...\")\n        transcription = client.stt.transcribe(\n            audio_url=\"https://soniox.com/media/examples/coffee_shop.mp3\"\n        )\n\n        print(f\"Transcription ID: {transcription.id}\")\n        print(\"Waiting for transcription to complete...\")\n        client.stt.wait(transcription.id, timeout_sec=120)\n\n        transcript = client.stt.get_transcript(transcription.id)\n        print(\"\\nTranscription complete:\")\n        print(transcript.text)\n\n        # Optionally delete the transcription and associated file to save resources\n        client.stt.delete(transcription.id)\n        print(f\"Transcription {transcription.id} and associated file deleted.\")\n\n    except Exception as e:\n        print(f\"An error occurred: {e}\")\n","lang":"python","description":"This quickstart demonstrates how to initialize the synchronous `SonioxClient`, transcribe an audio file from a public URL, wait for its completion, retrieve the transcript, and then delete the transcription. It uses the `SONIOX_API_KEY` environment variable for authentication. [1, 2]","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-17","installed_version":"1.10.1","pypi_latest":"2.4.0","is_stale":true,"summary":{"python_range":"3.10–3.9","success_rate":100,"avg_install_s":4.3,"avg_import_s":0.93,"wheel_type":"wheel"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"soniox","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.69,"mem_mb":14.7,"disk_size":"33.6M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"soniox","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":4.5,"import_time_s":0.51,"mem_mb":14.7,"disk_size":"33M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"soniox","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.97,"mem_mb":16.2,"disk_size":"36.9M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"soniox","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":3.8,"import_time_s":0.87,"mem_mb":16.2,"disk_size":"36M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"soniox","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":1.13,"mem_mb":16,"disk_size":"28.4M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"soniox","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":3.1,"import_time_s":1.2,"mem_mb":16,"disk_size":"28M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"soniox","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":1.06,"mem_mb":19,"disk_size":"28.1M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"soniox","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":3.3,"import_time_s":0.98,"mem_mb":19,"disk_size":"28M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"soniox","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"122.1M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"soniox","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":6.7,"import_time_s":null,"mem_mb":null,"disk_size":"118M"}]}}