Rev ai | Composio Docs

Overview

SLUG: REV_AI

Description

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

Authentication Details

API Key

bearer_token

stringRequired

Connecting to Rev ai

Create an auth config

Use the dashboard to create an auth config for the Rev ai toolkit. This allows you to connect multiple Rev ai accounts to Composio for agents to use.

Select App

Navigate to [Rev ai](https://platform.composio.dev/marketplace/Rev ai).

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

Create and Get auth config ID

Click “Create Rev ai Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1 from composio import Composio
2 
3 # Replace these with your actual values
4 rev_ai_auth_config_id = "ac_YOUR_REV_AI_CONFIG_ID" # Auth config ID created above
5 user_id = "0000-0000-0000"  # UUID from database/app
6 
7 composio = Composio()
8 
9 def authenticate_toolkit(user_id: str, auth_config_id: str):
10     # Replace this with a method to retrieve an API key from the user.
11     # Or supply your own.
12     user_api_key = input("[!] Enter API key")
13 
14     connection_request = composio.connected_accounts.initiate(
15         user_id=user_id,
16         auth_config_id=auth_config_id,
17         config={"auth_scheme": "API_KEY", "val": user_api_key}
18     )
19 
20     # API Key authentication is immediate - no redirect needed
21     print(f"Successfully connected Rev ai for user {user_id}")
22     print(f"Connection status: {connection_request.status}")
23     
24     return connection_request.id
25 
26 
27 connection_id = authenticate_toolkit(user_id, rev_ai_auth_config_id)
28 
29 # You can verify the connection using:
30 connected_account = composio.connected_accounts.get(connection_id)
31 print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the [Rev ai toolkit’s playground](https://app.composio.dev/app/Rev ai)

OpenAI (Python)

Anthropic (TypeScript)

Google (Python)

Vercel (TypeScript)

Python

1 from composio import Composio
2 from openai import OpenAI
3 import json
4 
5 openai = OpenAI()
6 composio = Composio()
7 
8 # User ID must be a valid UUID format
9 user_id = "0000-0000-0000"  # Replace with actual user UUID from your database
10 
11 tools = composio.tools.get(user_id=user_id, toolkits=["REV_AI"])
12 
13 print("[!] Tools:")
14 print(json.dumps(tools))
15 
16 def invoke_llm(task = "What can you do?"):
17     completion = openai.chat.completions.create(
18         model="gpt-4o",
19         messages=[
20             {
21                 "role": "user",
22                 "content": task,  # Your task here!
23             },
24         ],
25         tools=tools,
26     )
27 
28     # Handle Result from tool call
29     result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30     print(f"[!] Completion: {completion}")
31     print(f"[!] Tool call result: {result}")
32 
33 invoke_llm()

Tool List

REV_AI_DELETE_JOB_BY_ID

Tool Name: Delete Job By ID

Description

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.

Action Parameters

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

REV_AI_GET_ACCOUNT

Tool Name: Get Account

Description

Tool to retrieve developer account details. use after authenticating with rev ai.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

REV_AI_GET_CAPTIONS

Tool Name: Get Captions

Description

Tool to retrieve captions (srt or vtt) for a completed rev.ai transcription job. use after confirming the job status is 'completed'.

Action Parameters

stringDefaults to application/x-subrip

channel_id

integer

job_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

REV_AI_GET_JOB_BY_ID

Tool Name: Get Job by ID

Description

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

Action Parameters

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

REV_AI_GET_LIST_OF_JOBS

Tool Name: Get List of Jobs

Description

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

Action Parameters

ending_before

string

limit

integer

starting_after

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

REV_AI_GET_TRANSCRIPT_BY_ID

Tool Name: Get Transcript by ID

Description

Tool to retrieve the transcript of a completed rev.ai job. use after confirming job is complete. supports json, plaintext, vtt or srt formats.

Action Parameters

stringDefaults to application/vnd.rev.transcript.v1.0+json

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

REV_AI_START_STREAM_TRANSCRIPTION

Tool Name: Start Stream Transcription

Description

Tool to start a websocket transcription stream. use when you need real-time speech-to-text streaming via rev.ai.

Action Parameters

content_type

stringRequired

custom_vocabulary_id

string

delete_after_seconds

integer

detailed_partials

boolean

enable_speaker_switch

boolean

filter_profanity

boolean

language

stringDefaults to en

max_connection_wait_seconds

integerDefaults to 60

max_segment_duration_seconds

integer

metadata

string

priority

stringDefaults to speed

remove_disfluencies

boolean

skip_postprocessing

boolean

start_ts

number

transcriber

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

REV_AI_SUBMIT_TRANSCRIPTION_JOB

Tool Name: Submit Transcription Job

Description

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

Action Parameters

callback_url

string

custom_vocabularies

array

delete_after_seconds

integer

file

string

filter_profanity

boolean

language

string

media_url

string

metadata

string

skip_diarization

boolean

skip_punctuation

boolean

speaker_channel_count

integer

transcription_config

object

Action Response

data

objectRequired

error

string

successful

booleanRequired

REV_AI_DELETE_CUSTOM_VOCABULARY

Tool Name: Delete Custom Vocabulary

Description

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.

Action Parameters

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

REV_AI_GET_CUSTOM_VOCABULARY_DETAILS

Tool Name: Get Custom Vocabulary Details

Description

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

Action Parameters

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

REV_AI_SUBMIT_CUSTOM_VOCABULARY

Tool Name: Submit Custom Vocabulary

Description

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

Action Parameters

custom_vocabulary_id

string

metadata

string

phrases

arrayRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired