# Submit Transcription Job — Rev.ai

> Starts an asynchronous job to transcribe speech-to-text for a media file. Add an optional callback URL to invoke when processing is complete.

- Key: `rev_ai-submit-transcription-job`
- Type: Action (Write)
- Version: 0.1.3
- App: Rev.ai (`rev_ai`) — https://pipedream.com/apps/rev-ai.md
- This page (HTML): https://pipedream.com/apps/rev-ai/actions/submit-transcription-job
- Hints: destructive · open-world
- Source: https://github.com/PipedreamHQ/pipedream/blob/master/components/rev_ai/actions/submit-transcription-job/submit-transcription-job.mjs

## Props

| Prop | Type | Required | Description |
|---|---|---|---|
| `media_url` | `string` | Yes | Direct download media url. Ignored if submitting job from file |
| `skip_diarization` | `boolean` | No | Specify if speaker diarization will be skipped by the speech engine |
| `skip_punctuation` | `boolean` | No | Specify if "punct" type elements will be skipped by the speech engine. For JSON outputs, this includes removing spaces. For text outputs, words will still be delimited by a space |
| `remove_disfluencies` | `boolean` | No | Currently we only define disfluencies as 'ums' and 'uhs'. When set to true, disfluencies will be not appear in the transcript. |
| `filter_profanity` | `boolean` | No | Enabling this option will filter for approx. 600 profanities, which cover most use cases. If a transcribed word matches a word on this list, then all the characters of that word will be replaced by asterisks except for the first and last character. |
| `speaker_channels_count` | `integer` | No | Use to specify the total number of unique speaker channels in the audio. Given the number of audio channels provided, each channel will be transcribed separately and the channel id assigned to the speaker label. The final output will be a combination of all individual channel outputs. Overlapping monologues will have ordering broken by the order in which the first spoken element of each monologue occurs. If speaker_channels_count is greater than the actual channels in the audio, the job will fail with invalid_media. Note: The amount charged will be the duration of the file multiplied by the number of channels specified. When using speaker_channels_count each channel will be diarized as one speaker, and the value of skip_diarization will be ignored if provided |
| `delete_after_seconds` | `integer` | No | Specify the number of seconds after job completion when job is auto-deleted. It may take up to 2 minutes after the scheduled time for the job to be deleted. The number of seconds provided must range from 0 seconds to 2592000 seconds (30 days). |
| `metadata` | `string` | No | Optional metadata that was provided during submission |
| `callback_url` | `string` | No | Optional callback url to invoke when processing is complete |
| `phrases` | `any` | No | Array of phrases not found in normal dictionary. Add technical jargon, proper nouns and uncommon phrases as strings in this array to add them to the lexicon for this job. A phrase must contain at least 1 alpha character but may contain any non-numeric character from the Basic Latin set. A phrase can contain up to 12 words. Each word can contain up to 34 characters. |

## Run it

**MCP**

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "rev_ai",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
  name: "rev_ai-submit-transcription-job",
  arguments: {
    media_url: "Media url",
    skip_diarization: true,
  },
})
```

**TypeScript**

```ts
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "rev_ai-submit-transcription-job",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    rev_ai: { authProvisionId: "apn_xxxxxxx" },
    media_url: "Media url",
    skip_diarization: true,
  },
})

console.log(result)
```

**cURL**

```bash
curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
  -H "Content-Type: application/json" \
  -H "X-PD-Environment: production" \
  -H "Authorization: Bearer {access_token}" \
  -d '{
    "external_user_id": "{external_user_id}",
    "id": "rev_ai-submit-transcription-job",
    "configured_props": {
      "rev_ai": { "authProvisionId": "apn_xxxxxxx" },
      "media_url": "Media url",
      "skip_diarization": true
    }
  }'
```

---

- App: https://pipedream.com/apps/rev-ai.md · All apps: https://pipedream.com/apps