Skip to main content
Rev AI logo
  • Category: audio & speech
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 11
  • Triggers: 0
  • Slug: REV_AI
  • Version: 20261101_00

Tools

Slug: REV_AI_DELETE_CUSTOM_VOCABULARYTool 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

string
required
Unique identifier of the custom vocabulary to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: REV_AI_DELETE_JOB_BY_IDTool 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

string
required
The unique identifier of the job to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: REV_AI_GET_ACCOUNTTool to retrieve developer account details. Use after authenticating with Rev AI.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: REV_AI_GET_CAPTIONSTool to retrieve captions (SRT or VTT) for a completed Rev.ai transcription job. Use after confirming the job status is ‘completed’.

Input Parameters

string ("application/x-subrip" | "text/vtt")
Caption format: SRT (application/x-subrip) or WebVTT (text/vtt).
string
required
The ID of the completed transcription job.
integer
Optional audio channel number for multi-channel jobs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: REV_AI_GET_CUSTOM_VOCABULARY_DETAILSTool 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

string
required
Unique identifier of the custom vocabulary to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: REV_AI_GET_JOB_BY_IDTool to fetch details of a transcription job by its ID. Use when confirming job status and metadata are accurate.

Input Parameters

string
required
Unique identifier of the transcription job to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: REV_AI_GET_LIST_OF_JOBSTool 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

integer
Maximum number of jobs to return (default 100, max 1000)
string
Only return jobs created before the given job ID.
string
Only return jobs created after the given job ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: REV_AI_GET_TRANSCRIPT_BY_IDTool 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

string
required
Identifier for the transcription job.
string ("application/vnd.rev.transcript.v1.0+json" | "text/plain")
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: REV_AI_START_STREAM_TRANSCRIPTIONConstructs a WebSocket URL for a Rev.ai real-time transcription stream. Connect to the returned URL to start streaming.

Input Parameters

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: REV_AI_SUBMIT_CUSTOM_VOCABULARYTool to submit a custom vocabulary for improved speech recognition. Use when you want to process domain-specific terms asynchronously.

Input Parameters

array
required
List of phrases or words to include in the custom vocabulary.
string
Optional user-defined metadata for the custom vocabulary.
string
Optional unique identifier for the custom vocabulary.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: REV_AI_SUBMIT_TRANSCRIPTION_JOBTool to submit a new transcription job. Use when you have a media URL or file bytes ready for async processing.

Input Parameters

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

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not