Skip to main content
POST
/
v1
/
jobs
/
voice
/
translate
Create a voice translation job
curl --request POST \
  --url https://api.deepl.com/v1/jobs/voice/translate \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "source_file": {
    "name": "podcast-episode-42.mp3",
    "content_type": "audio/mpeg",
    "content_length": 15728640
  },
  "targets": [
    {
      "language": "de",
      "type": "text/plain"
    },
    {
      "language": "es",
      "type": "audio/pcm;encoding=s16le;rate=16000"
    }
  ]
}
'
{
  "job_id": "a74d88fb-ed2a-4943-a664-a4512398b994",
  "upload_url": "https://assets.deepl.com/collections/a74d88fb-ed2a-4943-a664-a4512398b994/assets/b1c2d3e4-f5a6-7890-abcd-ef1234567890",
  "signature": "eyJhbGciOiJIUzI1NiIs..."
}

Authorizations

​
Authorization
string
header
default:DeepL-Auth-Key
required

Authentication with Authorization header and DeepL-Auth-Key authentication scheme. Example: DeepL-Auth-Key <api-key>

Query Parameters

​
include
enum<string>[]

Additional fields to include in the response.

  • signed_url: Include pre-signed URLs (signed_upload_url on create, signed_download_url on status) that can be used without an authorization header.
Available options:
signed_url

Body

application/json
​
source_file
object
required

Metadata about the source audio file to be uploaded.

​
targets
object[]
required

One or more translation targets. Each target produces a separate result.

Minimum array length: 1
​
parameters
object

Processing parameters for the voice translation job.

Response

Job created successfully.

​
job_id
string<uuid>
required

The unique identifier of the created job.

​
upload_url
string<uri>
required

The URL to upload the source audio file to via PUT with Content-Type: application/octet-stream. Requires the Authorization: DeepL-Signature {signature} header. See Upload File for details.

​
signature
string
required

A short-lived token used to authorize the file upload. Pass it via the Authorization header as DeepL-Signature {signature} when uploading to the upload_url.

​
signed_upload_url
string<uri>

A pre-signed upload URL that does not require an authorization header. Only present when ?include=signed_url is specified.