> ## Documentation Index
> Fetch the complete documentation index at: https://lava.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Soniox

> Speech-to-text API providing accurate audio transcription with speaker diarization and language detection.

Speech-to-text API providing accurate audio transcription with speaker diarization and language detection. Best for workflows that convert spoken audio to text — meeting transcription, voice command processing, and audio content indexing. Unlike ElevenLabs (text-to-speech), Soniox handles the inverse: converting speech audio into structured text.

6 endpoints available through Lava's AI Gateway. See the [Soniox API docs](https://soniox.com/docs) for full documentation.

<Info>Supports both **managed** (Lava's API keys) and **unmanaged** (bring your own credentials) mode.</Info>

## Endpoints

### Create a transcription job

**POST** `https://api.soniox.com/v1/transcriptions` — $1.50 input, $3.50 output / 1M tokens

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    const data = await lava.gateway('https://api.soniox.com/v1/transcriptions', { body: {"audio_url":"https://example.com/audio.mp3"} });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.soniox.com%2Fv1%2Ftranscriptions" \
      -H "Authorization: Bearer $LAVA_SECRET_KEY" \
      -H "Content-Type: application/json" \
      -d '{"audio_url":"https://example.com/audio.mp3"}'
    ```
  </Tab>
</Tabs>

### Get transcript text

**GET** `https://api.soniox.com/v1/transcriptions/{id}/transcript` — Free

### Get transcription status and results

**GET** `https://api.soniox.com/v1/transcriptions/{id}` — $1.50 input, $3.50 output / 1M tokens

### Upload an audio file

**POST** `https://api.soniox.com/v1/files` — Free

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    const data = await lava.gateway('https://api.soniox.com/v1/files', { method: 'POST' });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.soniox.com%2Fv1%2Ffiles" \
      -H "Authorization: Bearer $LAVA_SECRET_KEY" \
      -H "Content-Type: application/json"
    ```
  </Tab>
</Tabs>

### Get file details

**GET** `https://api.soniox.com/v1/files/{id}` — Free

### List available speech models

**GET** `https://api.soniox.com/v1/models` — Free

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    const data = await lava.gateway('https://api.soniox.com/v1/models', { method: 'GET' });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.soniox.com%2Fv1%2Fmodels" \
      -H "Authorization: Bearer $LAVA_SECRET_KEY"
    ```
  </Tab>
</Tabs>

## Next Steps

<CardGroup cols={2}>
  <Card title="All Providers" icon="grid" href="/gateway/supported-providers">
    Browse all supported AI providers
  </Card>

  <Card title="Forward Proxy" icon="route" href="/gateway/forward-proxy">
    Learn how to construct proxy URLs and authenticate requests
  </Card>
</CardGroup>