Soniox
OtherAPI Reference

Soniox API reference

Soniox API reference for Speech-to-Text and Text-to-Speech.

Base URLs

API base URLs depend on two factors: the specific service you are calling (Speech-to-Text, Text-to-Speech, Authentication) and your project's region.

For a complete list of regional domains (e.g., US, EU, Japan) and their corresponding REST and WebSocket endpoints, please refer to our Data residency guide.

REST API

OpenAPI schema: https://soniox.com/docs/openapi.yaml

Authentication

Create and manage API keys for authentication.

Speech-to-Text

REST API for Speech-to-Text is available at https://api.soniox.com/v1 and includes:

  • Files: Manage audio files by uploading, listing, retrieving, and deleting them.
  • Transcriptions: Create and manage transcriptions for audio files.
  • STT models: List available STT models.

See Get started for an introduction.

Text-to-Speech

REST API for Text-to-Speech is available at https://tts-rt.soniox.com/tts.

Voice management is available at https://api.soniox.com/v1.

  • Voices: Create custom voices from a reference clip and list, retrieve, recompute, and delete them.

See Get started for an introduction and Voice cloning for a guide.

Other

Additional REST endpoints are available at https://api.soniox.com/v1.

  • Concurrency limits: Retrieve current concurrent counts and configured limits for the project and organization.
  • Usage logs: Retrieve per-request usage log entries for the project.

Errors

Every Soniox API surface (REST, async transcription, STT WebSocket, TTS WebSocket, TTS REST) returns a stable error_type you can branch on in code, alongside a human-readable message and a request_id for support. See the Errors reference for the full list of error types, their causes, and how to resolve them.

WebSocket API

Realtime Speech-to-Text

Use WebSocket API to transcribe and translate live audio streams in real-time.

Realtime Text-to-Speech

Use WebSocket API for low-latency, streaming speech generation.

  • Endpoint: wss://tts-rt.soniox.com/tts-websocket
  • Reference: WebSocket API

React Native

Build speech-to-text workflows in React Native with real-time API.

Create temporary API key POST

Creates a short-lived API key for specific temporary use cases. The key will automatically expire after the specified duration. Use `single_use` and `max_session_duration_seconds` to limit how the key can be used by a client. See the [Temporary API keys guide](https://soniox.com/docs/guides/temporary-api-keys) for details.