Create a voice translation job

Creates an async voice translation job. The response includes an upload URL for the source audio file.

POST /v1/jobs/voice/translate

Create a voice translation job

cURL

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"
    }
  ]
}
'

201

{
  "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.

Show child attributes

targets · object[] · required

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

Minimum array length: 1

Show child attributes

parameters · object

Processing parameters for the voice translation job.

Show child attributes

Response

201

application/json

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.