Skip to main content

​
Setup your development environment

Learn how to update your docs locally and and deploy them to the public.

​
Get your API Key

First, you’ll need to authenticate your requests. You can get your API key from the VerbalisAI Dashboard.
1

Sign up or log in

Create an account at www.verbalisai.com/dashboard/overview or log in if you already have one
2

Navigate to API Keys

Go to the API Keys section in your dashboard
3

Create new API Key

Click “Create New Key” and give it a descriptive name
4

Copy your key

Copy the generated API key - you won’t be able to see it again!
Keep your API key secure and never expose it in client-side code. Always use environment variables or secure configuration management.

​
Make your first API call

Here’s how to transcribe your first audio file: 
curl -X POST https://api.verbalisai.com/v1/transcript \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: multipart/form-data" \
  -F "file=@/path/to/your/audio.mp3"

​
Understanding the Response

A successful transcription response will look like this: 
{
  "success": true,
  "data": {
    "id": "trans_1234567890",
    "text": "Hello, this is a sample transcription of your audio file.",
    "confidence": 0.95,
    "language": "en",
    "duration": 12.5,
    "created_at": "2024-01-15T10:30:00Z",
    "sentences": [
      {
        "text": "Hello, this is a sample transcription of your audio file.",
        "start": 0.0,
        "end": 12.5,
        "confidence": 0.95
      }
    ]
  }
}

​
Supported Audio Formats

VerbalisAI supports a wide range of audio formats:
  • MP3
  • WAV
  • FLAC
  • M4A
  • OGG
  • WEBM
  • MP4 (audio track)
  • Maximum file size: 1GB
  • Maximum duration: 4 hours
  • Recommended: Under 100MB for faster processing
  • Sample rate: 16kHz or higher
  • Bit depth: 16-bit or higher
  • Clear audio with minimal background noise

​
Next Steps

Now that you’ve made your first API call, explore more advanced features:

Authentication Methods

Learn about different ways to authenticate your requests

Transcription Guide

Dive deep into transcription features and options

File Storage

Learn how to use our integrated file storage

API Reference

Explore all available endpoints and parameters
⌘I