Skip to content

support for SRT output #335

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
dfenster merged 2 commits into from
May 6, 2026
Merged

support for SRT output #335

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
08378a4
support for SRT output
dfenster May 6, 2026
f955606
make voice job api docs available
dfenster May 6, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 24 additions & 9 deletions api-reference/jobs-voice-translate.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,19 +1,23 @@
---
title: "Translate Audio Files"
sidebarTitle: "Overview"
description: "Translate pre-recorded audio files into text or audio in other languages using asynchronous jobs."
description: "Translate pre-recorded audio files into plain text transcripts, SRT subtitles, or translated speech audio using asynchronous jobs."
public: true
---

<Warning>
**Closed alpha.** This API may change without notice and is only available to select DeepL customers. See [alpha and beta features](/docs/resources/alpha-and-beta-features) for details. To request access, contact your customer success manager.
</Warning>

The Voice Translate Job API provides asynchronous translation of audio files into text or audio in other languages.
The Voice Translate Job API translates pre-recorded audio files into any combination of three output forms in any of its supported target languages:

The Voice Translate Job API processes entire audio files asynchronously. This makes it suitable for pre-recorded content such as podcasts, meeting recordings, or other media files. For live audio, see the [real-time Voice API](/api-reference/voice).
- **Plain text transcripts** (`text/plain`)
- **SRT subtitles** (`application/x-subrip`) — preserves the original timecodes
- **Translated speech audio** — speech-to-speech in a range of audio and video container formats (see the [Reference](/api-reference/jobs-voice-translate/reference#supported-output-formats) for the full list)

Each job can translate and transcribe audio into multiple languages. For example, a single English podcast can be translated into both German text and Spanish audio in one job.
The API processes entire audio files asynchronously. This makes it suitable for pre-recorded content such as podcasts, meeting recordings, or other media files. For live audio, see the [real-time Voice API](/api-reference/voice).

Each job can produce multiple outputs from a single source. For example, one English podcast can be translated into German plain text, French SRT subtitles, and Spanish audio in a single job.

For full request and response schemas, see the [Create Job](/api-reference/jobs-voice-translate/create-voice-translate-job) and [Get Job Status](/api-reference/jobs-voice-translate/get-voice-translate-job-status) endpoint references. For status values, limits, supported formats, and supported languages, see the [Reference](/api-reference/jobs-voice-translate/reference).

Expand Down Expand Up @@ -45,7 +49,8 @@ Translating an audio file is a four-step process. The examples below use the API
},
"targets": [
{ "language": "de", "type": "text/plain" },
{ "language": "es", "type": "audio/pcm;encoding=s16le;rate=16000" }
{ "language": "es", "type": "audio/pcm;encoding=s16le;rate=16000" },
{ "language": "fr", "type": "application/x-subrip" }
]
}'
```
Expand All @@ -68,7 +73,8 @@ Translating an audio file is a four-step process. The examples below use the API
},
"targets": [
{ "language": "de", "type": "text/plain" },
{ "language": "es", "type": "audio/pcm;encoding=s16le;rate=16000" }
{ "language": "es", "type": "audio/pcm;encoding=s16le;rate=16000" },
{ "language": "fr", "type": "application/x-subrip" }
]
}
```
Expand Down Expand Up @@ -151,9 +157,11 @@ Translating an audio file is a four-step process. The examples below use the API
"parameters": { "source_language": "en" },
"targets": [
{ "language": "de", "type": "text/plain" },
{ "language": "es", "type": "audio/pcm;encoding=s16le;rate=16000" }
{ "language": "es", "type": "audio/pcm;encoding=s16le;rate=16000" },
{ "language": "fr", "type": "application/x-subrip" }
],
"results": [
{ "status": "processing" },
{ "status": "processing" },
{ "status": "processing" }
]
Expand All @@ -176,7 +184,8 @@ Translating an audio file is a four-step process. The examples below use the API
"parameters": { "source_language": "en" },
"targets": [
{ "language": "de", "type": "text/plain" },
{ "language": "es", "type": "audio/pcm;encoding=s16le;rate=16000" }
{ "language": "es", "type": "audio/pcm;encoding=s16le;rate=16000" },
{ "language": "fr", "type": "application/x-subrip" }
],
"results": [
{
Expand All @@ -187,6 +196,11 @@ Translating an audio file is a four-step process. The examples below use the API
{
"status": "failed",
"error": { "message": "processing failed" }
},
{
"status": "complete",
"download_url": "https://assets.deepl.com/collections/a74d88fb/assets/d4e5f6a7",
"signature": "eyJhbGciOiJIUzI1NiIs..."
}
]
}
Expand Down Expand Up @@ -251,6 +265,7 @@ create_resp = requests.post(
"targets": [
{"language": "de", "type": "text/plain"},
{"language": "es", "type": "audio/pcm;encoding=s16le;rate=16000"},
{"language": "fr", "type": "application/x-subrip"},
],
},
)
Expand Down Expand Up @@ -293,7 +308,7 @@ for target, result in zip(status["targets"], status["results"]):
headers={"Authorization": f"DeepL-Signature {result['signature']}"},
)
download_resp.raise_for_status()
suffix = ".txt" if target["type"] == "text/plain" else ".bin"
suffix = {"text/plain": ".txt", "application/x-subrip": ".srt"}.get(target["type"], ".bin")
out_path = Path(f"output-{target['language']}{suffix}")
out_path.write_bytes(download_resp.content)
print(f"{target['language']}: wrote {out_path}")
Expand Down
1 change: 1 addition & 0 deletions api-reference/jobs-voice-translate/reference.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -55,6 +55,7 @@ Each target specifies a `type` for the desired output format.
| **Type** | **Description** |
| :--------------------------------------------- | :----------------------------- |
| `text/plain` | Plain text transcript |
| `application/x-subrip` | SRT subtitle file with original timecodes |
| `audio/opus` | Opus audio |
| `audio/flac` | FLAC audio |
| `audio/pcm;encoding=s16le;rate=16000` | PCM 16-bit signed LE, 16 kHz |
Expand Down
1 change: 1 addition & 0 deletions api-reference/openapi.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5757,6 +5757,7 @@ components:
description: The desired output format for the translation target.
enum:
- text/plain
- application/x-subrip
- audio/opus
- audio/flac
- "audio/pcm;encoding=s16le;rate=16000"
Expand Down
9 changes: 9 additions & 0 deletions docs.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -237,6 +237,15 @@
"api-reference/voice/reconnect-session"
]
},
{
"group": "Translate Audio Files",
"pages": [
"api-reference/jobs-voice-translate",
"api-reference/jobs-voice-translate/create-voice-translate-job",
"api-reference/jobs-voice-translate/get-voice-translate-job-status",
"api-reference/jobs-voice-translate/reference"
]
},
{
"group": "Write",
"pages": [
Expand Down