DEdeepl
VoiceTranslateJob

Create a voice translation job

Changed on

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

post/v1/jobs/voice/translate

Request

  • Base URL
    https://api.deepl.com
  • URL
    https://api.deepl.com/v1/jobs/voice/translate
  • Auth
    API key in header Authorization

Query parameters

includestring[]

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.

Request body

Example request

{
  "source_file": {
    "name": "podcast-episode-42.mp3",
    "content_length": 15728640
  },
  "parameters": {
    "source_language": "EN"
  },
  "targets": [
    {
      "language": "DE"
    }
  ]
}

Response

Job created successfully.

job_idstring uuid required

The unique identifier of the created job.

upload_urlstring 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.

signaturestring 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_urlstring uri

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

Changes