Transcribe API

Quickstart commands to create a transcription from audio or video files.

Before you start

• You'll need a valid access token and client ID. See the Authentication Guide for details.
• Upload your media files (audio or video) to your storage location and generate a pre-signed URL.

Quickstart commands

In the commands below:

• Update the Authorization with the bearer access token.
• Update x-api-key with the client ID.
• Update url with the generated pre-signed URL for your input file.

You can try these curl requests directly in your terminal. Or you can use an HTTP client like Postman.

Transcribe with source language output

Transcribe video with source language output

Copy
Copied to your clipboard
curl --location 'https://audio-video-api.adobe.io/v1/transcribe' \
--header 'Authorization: Bearer {AccessToken}' \
--header 'Content-Type: application/json' \
--header 'x-api-key: {ClientID}' \
--data '{
  "video": {
    "source": {
         "url" : "{Presigned_URL}"
    },
    "mediaType": "video/mp4"
  }
}'

Transcribe audio with source language output

Copy
Copied to your clipboard
curl --location 'https://audio-video-api.adobe.io/v1/transcribe' \
--header 'Authorization: Bearer {AccessToken}' \
--header 'Content-Type: application/json' \
--header 'x-api-key: {ClientID}' \
--data '{
  "audio": {
    "source": {
         "url" : "{Presigned_URL}"
    },
    "mediaType": "audio/mp3"
  }
}'

Transcribe with target language output

Transcribe video with target language output

Copy
Copied to your clipboard
curl --location 'https://audio-video-api.adobe.io/v1/transcribe' \
--header 'Authorization: Bearer {AccessToken}' \
--header 'Content-Type: application/json' \
--header 'x-api-key: {ClientID}' \
--data '{
  "video": {
    "source": {
         "url" : "{Presigned_URL}"
    },
    "mediaType": "video/mp4"
  },
  "targetLocaleCodes": [
    "{targetLocaleCode}"
  ]
}'

Transcribe audio with target language output

Copy
Copied to your clipboard
curl --location 'https://audio-video-api.adobe.io/v1/transcribe' \
--header 'Authorization: Bearer {AccessToken}' \
--header 'Content-Type: application/json' \
--header 'x-api-key: {ClientID}' \
--data '{
  "audio": {
    "source": {
         "url" : "{Presigned_URL}"
    },
    "mediaType": "audio/mp3"
  },
  "targetLocaleCodes": [
    "{targetLocaleCode}"
  ]
}'

Transcribe and generate captions with source language output

Transcribe and generate captions for video with source language output

Copy
Copied to your clipboard
curl --location 'https://audio-video-api.adobe.io/v1/transcribe' \
--header 'Authorization: Bearer {AccessToken}' \
--header 'Content-Type: application/json' \
--header 'x-api-key: {ClientID}' \
--data '{
  "video": {
    "source": {
         "url" : "{Presigned_URL}"
    },
    "mediaType": "video/mp4"
  },
  "captions": {
    "targetFormats": [
      "{targetCaptionFormat}"
    ]
  }
}'

Transcribe and generate captions for audio with source language output

Copy
Copied to your clipboard
curl --location 'https://audio-video-api.adobe.io/v1/transcribe' \
--header 'Authorization: Bearer {AccessToken}' \
--header 'Content-Type: application/json' \
--header 'x-api-key: {ClientID}' \
--data '{
  "audio": {
    "source": {
         "url" : "{Presigned_URL}"
    },
    "mediaType": "audio/mp3"
  },
  "captions": {
    "targetFormats": [
      "{targetCaptionFormat}"
    ]
  }
}'

Check the result

Note the job ID in the response and use the Get Result API to see the final result.

Sample response

Copy
Copied to your clipboard
{
    "jobId": "986fc222-1118-4242-b326-eb9873e3982f",
    "statusUrl": "https://audio-video-api.adobe.io/v1/status/{jobID}"
}

Last updated 1/29/2025

Was this helpful?

Yes

No