Audio Transcription API

Convert audio files to text using AI-powered transcription capabilities.

Endpoint

POST https://filebrain.pro/api/audio/transcriber/v1/

File Requirements

File Types

  • MP3
  • WAV
  • M4A

Limitations

  • Maximum file size: 25MB
  • One audio file per request

Request Parameters

Parameter Type Required Description
audio file Yes Audio file to transcribe
api_key string Yes Your FileBrain API key
llm_api_key string Yes Your LLM API key (OpenAI supported)
language string No ISO language code (e.g., 'en'). Auto-detected if not specified

Code Example

Python Example
import requests

def transcribe_audio(audio_path, api_key, llm_api_key, language=None):
    # Prepare the files and data
    files = {
        'audio': ('audio.mp3', open(audio_path, 'rb'), 'audio/mpeg')
    }
    
    data = {
        'api_key': api_key,
        'llm_api_key': llm_api_key
    }

    # Add language if specified
    if language:
        data['language'] = language

    # Make the request
    response = requests.post(
        'https://filebrain.pro/api/audio/transcriber/v1/',
        files=files,
        data=data
    )
    
    # Check response
    if response.status_code == 200:
        return response.json()
    else:
        raise Exception(f"Error: {response.status_code}, {response.text}")

# Example usage
result = transcribe_audio(
    'path/to/audio.mp3',
    'YOUR_FBP_ACCOUNT_API_KEY',
    'YOUR_OPENAI_API_KEY',
    language='en'  # Optional
)

Response Format

Success Response (200 OK)
{
    "status": "success",
    "message": {
        "transcription": "Transcribed text content...",
        "language": "en"
    }
}

Error Handling

Common Error Codes

  • 400 - Invalid request (missing parameters, invalid file type)
  • 401 - Invalid API key
  • 413 - File too large (>25MB)
  • 429 - Rate limit exceeded
  • 500 - Server error