file | string | yes | - | Audio file (multipart upload) OR use file_url for the JSON path. |
file_url | string | no | - | Public URL to fetch audio from (alternative to file upload). |
translate | boolean | no | false | If true, route to /audio/translations and translate to English instead of transcribing in source language. |
timestamps | boolean | no | false | Convenience toggle. If true, sets response_format=verbose_json and includes word-level timestamp_granularities. |
language | string | no | - | Optional ISO-639-1 language code. Auto-detected if omitted. Ignored when translate=true. |
prompt | string | no | - | Glossary or prior context to bias the model. |
response_format | enum | no | "json" | Overridden to verbose_json when timestamps=true. · Allowed: json, text, srt, verbose_json, vtt |
temperature | number | no | 0.0 | Sampling temperature. · Range: 0 – 1 |
timestamp_granularities | string | no | - | Comma-separated list: word, segment. Used when response_format=verbose_json. |