# Rev AI

Rev AI provides advanced machine learning and speech recognition services for converting audio and video to text.

- **Category:** artificial intelligence
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 11
- **Triggers:** 0
- **Slug:** `REV_AI`
- **Version:** 20260403_00

## Tools

### Delete Custom Vocabulary

**Slug:** `REV_AI_DELETE_CUSTOM_VOCABULARY`

Tool to delete a completed custom vocabulary and its data. Use when you need to remove an unused vocabulary after confirming it's no longer needed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the custom vocabulary to delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Job By ID

**Slug:** `REV_AI_DELETE_JOB_BY_ID`

Tool to delete a completed transcription job and its data. Use when you need to permanently remove a finished job after confirming it's no longer needed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the job to delete |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Account

**Slug:** `REV_AI_GET_ACCOUNT`

Tool to retrieve developer account details. Use after authenticating with Rev AI.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Captions

**Slug:** `REV_AI_GET_CAPTIONS`

Tool to retrieve captions (SRT or VTT) for a completed Rev.ai transcription job. Use after confirming the job status is 'completed'.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `accept` | string ("application/x-subrip" | "text/vtt") | No | Caption format: SRT (application/x-subrip) or WebVTT (text/vtt). |
| `job_id` | string | Yes | The ID of the completed transcription job. |
| `channel_id` | integer | No | Optional audio channel number for multi-channel jobs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Custom Vocabulary Details

**Slug:** `REV_AI_GET_CUSTOM_VOCABULARY_DETAILS`

Tool to retrieve custom vocabulary processing details. Use when needing to fetch the status and submitted phrases for a specific custom vocabulary after creation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the custom vocabulary to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Job by ID

**Slug:** `REV_AI_GET_JOB_BY_ID`

Tool to fetch details of a transcription job by its ID. Use when confirming job status and metadata are accurate.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the transcription job to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get List of Jobs

**Slug:** `REV_AI_GET_LIST_OF_JOBS`

Tool to get list of transcription jobs from the past 30 days. Use when you need to retrieve and paginate through recent transcription tasks.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of jobs to return (default 100, max 1000) |
| `ending_before` | string | No | Only return jobs created before the given job ID. |
| `starting_after` | string | No | Only return jobs created after the given job ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Transcript by ID

**Slug:** `REV_AI_GET_TRANSCRIPT_BY_ID`

Tool to retrieve the transcript of a completed Rev.ai job. Use after confirming job is complete. Supports JSON format (with timestamps and speaker info) or plain text format.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Identifier for the transcription job. |
| `accept` | string ("application/vnd.rev.transcript.v1.0+json" | "text/plain") | No | Output format. Supported values: application/vnd.rev.transcript.v1.0+json (default) for JSON with timestamps and speaker info, or text/plain for plain text. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Start Stream Transcription

**Slug:** `REV_AI_START_STREAM_TRANSCRIPTION`

Tool to start a WebSocket transcription stream. Use when you need real-time speech-to-text streaming via Rev.ai.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `language` | string | No | Language code in ISO 639-1 format for transcription, default 'en'. |
| `metadata` | string | No | Optional user metadata string to associate with the stream. |
| `priority` | string ("speed" | "quality") | No | Priority of transcription processing: 'speed' or 'quality'. |
| `start_ts` | number | No | Initial timestamp (in seconds) from which to start transcription. |
| `transcriber` | string | No | Select a transcriber model, if multiple are available. |
| `content_type` | string | Yes | Audio MIME type and parameters (e.g., 'audio/x-raw;layout=interleaved;rate=16000;format=S16LE;channels=1', 'audio/x-wav', 'audio/x-flac'). |
| `filter_profanity` | boolean | No | Whether to filter profanity from transcripts. |
| `detailed_partials` | boolean | No | Whether to send detailed partial results. |
| `remove_disfluencies` | boolean | No | Whether to remove disfluencies (um, uh) from transcripts. |
| `skip_postprocessing` | boolean | No | Whether to skip post-processing phase. |
| `custom_vocabulary_id` | string | No | ID of a custom vocabulary to apply, if available. |
| `delete_after_seconds` | integer | No | If set, server will delete the stream results after given seconds. |
| `enable_speaker_switch` | boolean | No | Whether to enable speaker-switch detection. |
| `max_connection_wait_seconds` | integer | No | Maximum seconds to wait for WebSocket connection establishment. |
| `max_segment_duration_seconds` | integer | No | Maximum duration in seconds of each transcription segment. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Submit Custom Vocabulary

**Slug:** `REV_AI_SUBMIT_CUSTOM_VOCABULARY`

Tool to submit a custom vocabulary for improved speech recognition. Use when you want to process domain-specific terms asynchronously.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `phrases` | array | Yes | List of phrases or words to include in the custom vocabulary. |
| `metadata` | string | No | Optional user-defined metadata for the custom vocabulary. |
| `custom_vocabulary_id` | string | No | Optional unique identifier for the custom vocabulary. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Submit Transcription Job

**Slug:** `REV_AI_SUBMIT_TRANSCRIPTION_JOB`

Tool to submit a new transcription job. Use when you have a media URL or file bytes ready for async processing.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file` | string | No | Binary audio content to upload if media_url is not used |
| `language` | string | No | ISO 639-1 or BCP-47 code to override default language |
| `metadata` | string | No | Arbitrary string returned verbatim with job status |
| `media_url` | string | No | HTTP(S) URL of the media file to transcribe |
| `callback_url` | string | No | Webhook URL called on job completion |
| `filter_profanity` | boolean | No | If true, filter profanity from the transcript |
| `skip_diarization` | boolean | No | If true, do NOT perform speaker diarization |
| `skip_punctuation` | boolean | No | If true, do NOT auto-punctuate transcript |
| `custom_vocabularies` | array | No | List of custom vocabularies to apply |
| `delete_after_seconds` | integer | No | Automatically delete job this many seconds after completion |
| `transcription_config` | object | No | Settings for advanced transcription options. |
| `speaker_channel_count` | integer | No | Number of audio channels to treat as separate speakers |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |