GET
/v1/schemas/fal/audio/fal-ai/whisper
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source traceffedaf4443aa345d8d16f3f7369fbfa60fbfe182bf2f3a2879645990865e664b{
"fetchedAt": 1794286801,
"extractorVersion": "2",
"verifiedAt": null
} |
Request body
8 properties · 1 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| audio_url* | string | URL of the audio file to transcribe. Supported formats: mp3, mp4, mpeg, mpga, m4a, wav or webm. | |
| num_speakers | integer | Number of speakers in the audio file. Defaults to null. If not provided, the number of speakers will be automatically detected. | n ≥ 1 · nullable |
| chunk_level | enum | Level of the chunks to return. Either none, segment or word. `none` would imply that all of the audio will be transcribed without the timestamp tokens, we suggest to switch to `none` if you are not satisfied with the transcription quality, since it will usuall… | none | segment | word · default: "segment" |
| batch_size | integer | 1 ≤ n ≤ 64 · default: 64 | |
| language | enum | Language of the audio file. If set to null, the language will be automatically detected. Defaults to null. If translate is selected as the task, the audio will be translated to English, regardless of the language selected. | af | am | ar | as | az | ba · +93 more · nullable |
| diarize | boolean | Whether to diarize the audio file. Defaults to false. Setting to true will add costs proportional to diarization inference time. | default: false |
| task | enum | Task to perform on the audio file. Either transcribe or translate. | transcribe | translate · default: "transcribe" |
| prompt | string | Prompt to use for generation. Defaults to an empty string. | default: "" |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"fal-ai/whisper","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}