Transcribe audio or video
transcribeTurns the speech in an audio or video file at an https URL (25 MB at most; a file generate made works) into text through POST /v1/audio/transcriptions, or into English with translate. Use a transcription model id from list_models (type transcription). Billed per second of audio to the key in the MCP request's Authorization header; a request that fails is not charged.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"model": "<model>",
"audio_url": "<audio_url>"
},
"name": "transcribe"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | Yes | A transcription model id from list_models (type transcription). | |
| prompt | No | Names or words to spell right, or the text that came before. | |
| language | No | The spoken language as an ISO-639-1 code (en, es, zh...), when known. | |
| audio_url | Yes | An https URL of the audio or video file: mp3, mp4, m4a, wav, webm, ogg, flac or aac, 25 MB at most. A file generate made works. | |
| translate | No | True: translate the speech into English instead (the models that can). |