Skip to content

Getting Started

Welcome to RevidAPI! This guide will help you get started with our API endpoints.

Authentication

All POST requests require an API key in the header:

x-api-key: YOUR_API_KEY

API Endpoints

TTS API

  • Text to Speech — POST https://revidapi.com/v1/text-to-speech, then GET https://revidapi.com/v1/text-to-speech/{job_id}
  • Pricing: 10–15 credits per 1,000 characters, depending on the voice
  • Plain text or SRT subtitles, one endpoint

Caption Editor API

  • Blur Region — POST https://revidapi.com/v1/blur-region
  • Pricing: 25 credits per request

  • Blurs specific regions in videos

  • Detect Caption — POST https://revidapi.com/v1/detect-caption

  • Pricing: 25 credits per request

  • Detects and extracts text regions from video frames using OCR

  • Add Subtitle — POST https://revidapi.com/v1/add-subtitle

  • Pricing: 35 credits per request
  • Adds subtitles/captions to videos with extensive styling options

Download & Social

  • Social Download — POST https://revidapi.com/v1/tiktok/download (and other platforms)
  • Pricing: 5 credits per request

  • Downloads media from TikTok, YouTube, Instagram, Facebook, and more

  • Get Channel — POST https://revidapi.com/v1/tiktok/channel

  • Pricing: 5 credits per request

  • List videos from a TikTok channel URL

  • Get TikTok User — POST https://revidapi.com/v1/tiktok/username

  • Pricing: 5 credits per request

  • List videos from a TikTok username

  • Get Douyin User — POST https://revidapi.com/v1/douyin/user/download

  • Pricing: 35 credits per request

  • List videos from a Douyin user (sec_user_id)

  • TikTok Shop Download — POST https://revidapi.com/v1/tiktokshop/download

  • Pricing: 5 credits per request

  • Crawl & Search — POST https://revidapi.com/v1/website/crawl

  • Crawl and search content

TikTok Music & Video API

  • Music Trend — POST https://api.revidapi.com/paid/music/trend
  • Pricing: 5 credits per request

  • Trending music chart (TikTok Ads style); use country_code=VN for Vietnam

  • Music Search — POST https://revidapi.com/v1/tiktok/music/search

  • Pricing: 5 credits per request

  • Search sounds by keyword (region=VN, count max 20)

  • Video Search — POST https://revidapi.com/v1/tiktok/video/search

  • Pricing: 5 credits per request

  • Search videos by keyword (region=VN, filters: sort_type, publish_time)

  • Music Download — POST https://revidapi.com/v1/tiktok/music/download

  • Pricing: 5 credits per request
  • Resolve stream URLs by music_id (from Music Search results)

Audio

  • Audio Concatenation — POST https://revidapi.com/v1/audio/concatenate
  • Pricing: 25 credits per request
  • Combines multiple audio files into a single audio file

Image

  • Image to Video — POST https://revidapi.com/v1/image/convert/video

  • Transforms a static image into a video with custom duration and zoom effects

  • Image Screenshot — POST https://revidapi.com/v1/image/screenshot/webpage

  • Captures screenshots of web pages using Playwright with advanced options

Video

  • Video Editing — POST https://revidapi.com/v1/video/edit
  • Pricing: 35 credits per request

  • Add text, audio, image, logo, compose mp3, crop video, retweet video

  • Video Caption — POST https://revidapi.com/v1/video/caption

  • Pricing: 35 credits per request

  • Adds customizable captions to videos with various styling options

  • Video Concatenation — POST https://revidapi.com/v1/video/concatenate

  • Pricing: 35 credits per request

  • Combines multiple videos into a single continuous video file

  • Video Thumbnail — POST https://revidapi.com/v1/video/thumbnail

  • Extracts a thumbnail image from a specific timestamp in a video

  • Video Cut — POST https://revidapi.com/v1/video/cut

  • Pricing: 35 credits per request

  • Cuts specified segments from a video file with optional encoding settings

  • Video Split — POST https://revidapi.com/v1/video/split

  • Pricing: 35 credits per request

  • Splits a video into multiple segments based on specified start and end times

  • Video Trim — POST https://revidapi.com/v1/video/trim

  • Pricing: 35 credits per request
  • Trims a video by keeping only the content between specified start and end times

Media

  • Media Download — POST https://revidapi.com/v1/media/download
  • Pricing: 25 credits per request

  • Downloads media content from various online sources using yt-dlp

  • Generate ASS Subtitle — POST https://revidapi.com/v1/media/generate/ass

  • Generating an ASS (Advanced SubStation Alpha) subtitle file from a media file

  • Media Convert to MP3 — POST https://revidapi.com/v1/media/convert/mp3

  • Pricing: 25 credits per request

  • Converts various media formats specifically to MP3 audio

  • Media Convert — POST https://revidapi.com/v1/media/convert

  • Pricing: 25 credits per request

  • Converts media files from one format to another with customizable codec options

  • Media Transcription — POST https://revidapi.com/v1/media/transcribe

  • Transcribes or translates audio/video content from a provided media URL

  • Media Transcribe — POST https://revidapi.com/v1/media/transcribe/srt

  • Transcribes or translates audio/video content and generates SRT files

  • Media Silence — POST https://revidapi.com/v1/media/silence

  • Pricing: 25 credits per request

  • Detects silence intervals in a given media file

  • Media Metadata — POST https://revidapi.com/v1/media/metadata

  • Extracts comprehensive metadata from media files including format, codecs, resolution, and bitrates

  • Media Feedback — POST https://revidapi.com/v1/media/feedback

  • Provides a web interface for collecting and displaying feedback on media content

Asynchronous Processing

For tasks like blur, subtitle, detect, TTS, SRT to speech, video processing (cut, split, trim, etc.), and media processing (convert, etc.), we recommend the following workflow:

  1. Create Task: Send POST request to create the task and receive a task_id
  2. Wait: Add a wait node (30-45 seconds) to allow server processing time
  3. Check Status: Use the status endpoint documented in each specific API page
  4. Retrieve Result: Once status is "completed", retrieve the result from the response

Pricing Summary

Task Type Credits
TTS 10 credits per 1,000 characters
Blur Region 25 credits per request
Detect Caption 25 credits per request
Add Subtitle 35 credits per request
Download / TikTok channel / user / shop 5 credits per request
TikTok Music Trend / Search / Video Search / Music Download 5 credits per request
Douyin user videos 35 credits per request
Audio Processing 25 credits per request
Media Processing 25 credits per request
Video Processing 35 credits per request