Skip to main content
POST

Authorizations

string
required
All interfaces require Bearer Token authenticationGet API Key:Visit API Key Management Page to get your API KeyAdd to request header:

Body

⚠️ Online testing (Try it) is not supported for this endpointDue to file upload limitations, please test using:
  • Apifox / Postman - Manually change file parameter to file type after importing
  • cURL - Refer to code examples on the right
  • SDK - Use SDK examples in various languages
string
required
Audio file to transcribe (File type)⚠️ Note: When testing with Apifox or similar tools:
  1. After importing, manually change this parameter type to file
  2. Ensure request Content-Type is multipart/form-data
Supported formats: mp3, mp4, mpeg, mpga, m4a, wav, webmMaximum file size: 25 MB
string
default:"whisper-1"
required
Speech recognition model nameExample: "whisper-1"
string
Language code of the audio (ISO-639-1 format)Specifying the language can improve accuracy and speedSupported languages include: zh (Chinese), en (English), ja (Japanese), ko (Korean), and 99 other languagesExample: "en"
string
Optional text prompt to guide the transcription style or continue from previous audioMaximum 224 tokens
string
default:"json"
Output formatSupported formats:
  • json - JSON format (text only)
  • text - Plain text
  • srt - SRT subtitle format
  • verbose_json - Verbose JSON format (includes timestamps and metadata)
  • vtt - WebVTT subtitle format
number
default:"0"
Sampling temperature, range 0 to 1Higher values (like 0.8) make output more random, lower values (like 0.2) make it more deterministic and consistent

Response

string
Transcribed text content
string
Task type, fixed as transcribeOnly returned in verbose_json format
string
Detected or specified language codeOnly returned in verbose_json format
number
Audio duration (seconds)Only returned in verbose_json format
array
Array of text segmentsOnly returned in verbose_json format