Create Audio Description

post

https://api.3playmedia.com/v3/descriptions

Create audio descriptions for media. This is a streamlined version of the /v3/audio_descriptions/order endpoint that allows you to upload media and order AD in a single API call. Using this endpoint to create a file and order Audio Description simultaneously will create an ASR service order and incur additional costs.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

name

string

required

Name of the file

description

string

Description of the file

source_language

string

required

Source language code (browser navigator code)

source

file

A file upload containing your video. You must supply source_url, source, or media_file_id.

source_url

string

URL where 3Play can download the media before processing. Must have at least 1 day expiry for authenticated requests. You must supply source_url, source, or media_file_id.

media_file_id

integer

ID of existing 3Play media file to reuse instead of downloading. You must supply source_url, source, or media_file_id.

external_media_id

string

Customer unique ID

folder_name

string

Folder name for organization

callback_url

string

URL where 3Play POSTs on status changes

turnaround_level_id

number

enum

The ID of the turnaround level desired. Use 7 for standard, 8 for expedited, and 9 for rush.

Allowed:

extended

string

enum

Whether to use extended audio description, which pauses the source file to allow additional descriptive content when necessary

Allowed:

human_review_level

string

enum

Amount of human review involved in producing your audio description. 'none' results in Audio Description that is fully AI generated. 'full' will have a human review the description before synthesis.

Allowed:

Responses

400

Bad Request

Language

Credentials

Query

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Success