Add media

Adds media file(s) to a new job. This endpoint can only be called once per job.

Usage Options

  1. Direct URL:

    • Provide media_url for online-accessible files
    • URL must be GET-accessible
    • Avoid one-time/short-lived URLs
  2. Local File Upload:

    • First use POST /job/add_asset to get upload URL
    • Then reference via asset_ids parameter
  3. File Merging (available for certain profiles, ask support for access):

    • Upload multiple files via POST /job/add_asset
    • Pass all asset_ids in order of desired merging
    • Set merge_assets: true

Next Steps

After adding media, call POST /job/perform_transcription to start processing

Important Notes

  • Can only be called once per job
  • URLs must be directly accessible
  • For merging, minimum 2 asset_ids required
  • Merging order follows asset_ids order
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
integer
required

API version. Current version is 4. Older versions are supported but deprecated.

integer
required

Job ID (as received after calling POST /job/new)

Body Params
string
required
Defaults to null

URL of media file to transcribe. URL should be GET-accessible. Please avoid one-time links
(which allow only one call), and in case of expirable links make sure it has at least
24 hours before expiration.

asset_ids
array of strings
Defaults to

Array of asset IDs obtained from POST /job/add_asset

asset_ids
boolean
Defaults to false

Set if you want to merge assets.
You must pass at least two asset_ids.

Responses

Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json