---
title: "STTRequest"
---

Speech-to-text request input. Accepts a JSON body with input_audio containing base64-encoded audio.


## Fields

| Field                                                                                                                                                                                                                                          | Type                                                                                                                                                                                                                                           | Required                                                                                                                                                                                                                                       | Description                                                                                                                                                                                                                                    | Example                                                                                                                                                                                                                                        |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `input_audio`                                                                                                                                                                                                                                  | [components.STTInputAudio](../components/sttinputaudio.mdx)                                                                                                                                                                                     | :heavy_check_mark:                                                                                                                                                                                                                             | Base64-encoded audio to transcribe                                                                                                                                                                                                             | \{<br/>"data": "UklGRiQA...",<br/>"format": "wav"<br/>}                                                                                                                                                                                         |
| `language`                                                                                                                                                                                                                                     | *Optional[str]*                                                                                                                                                                                                                                | :heavy_minus_sign:                                                                                                                                                                                                                             | ISO-639-1 language code (e.g., "en", "ja"). Auto-detected if omitted.                                                                                                                                                                          | en                                                                                                                                                                                                                                             |
| `model`                                                                                                                                                                                                                                        | *str*                                                                                                                                                                                                                                          | :heavy_check_mark:                                                                                                                                                                                                                             | STT model identifier                                                                                                                                                                                                                           | openai/whisper-large-v3                                                                                                                                                                                                                        |
| `provider`                                                                                                                                                                                                                                     | [Optional[components.STTRequestProvider]](../components/sttrequestprovider.mdx)                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                                                                                             | Provider-specific passthrough configuration                                                                                                                                                                                                    |                                                                                                                                                                                                                                                |
| `response_format`                                                                                                                                                                                                                              | [Optional[components.STTRequestResponseFormat]](../components/sttrequestresponseformat.mdx)                                                                                                                                                     | :heavy_minus_sign:                                                                                                                                                                                                                             | Output format. "json" (default) returns \{ text, usage }. "verbose_json" additionally returns task, language, duration, and segment-level timestamps; only supported by OpenAI-compatible providers.                                            | json                                                                                                                                                                                                                                           |
| `temperature`                                                                                                                                                                                                                                  | *Optional[float]*                                                                                                                                                                                                                              | :heavy_minus_sign:                                                                                                                                                                                                                             | Sampling temperature for transcription                                                                                                                                                                                                         | 0                                                                                                                                                                                                                                              |
| `timestamp_granularities`                                                                                                                                                                                                                      | List[[components.STTTimestampGranularity](../components/stttimestampgranularity.mdx)]                                                                                                                                                           | :heavy_minus_sign:                                                                                                                                                                                                                             | Timestamp detail levels to include when response_format is "verbose_json". "segment" returns segment-level timestamps; "word" additionally returns word-level timestamps in the words array. Ignored unless response_format is "verbose_json". | [<br/>"segment"<br/>]                                                                                                                                                                                                                          |