# Lesan AI Documentation

> Lesan AI provides Speech-to-Text (ASR), Text-to-Speech (TTS), and Machine
> Translation (MT) APIs with strong support for African languages — Amharic,
> Tigrinya, and English. The ASR API supports synchronous and asynchronous
> file transcription, batch processing, and real-time WebSocket streaming.

All API endpoints except `/health` require a Bearer API key:
`Authorization: Bearer <api_key>`. The API base URL is https://asr.lesan.ai.

## Get started

- [Getting Started](https://docs.lesan.ai/guides/getting-started): Get started with Lesan AI services in minutes.
- [Authentication](https://docs.lesan.ai/guides/authentication): How to authenticate with the Lesan AI API using Bearer API keys and scopes.

## Guides

- [Media Probe](https://docs.lesan.ai/guides/media-probe): Inspect a media URL for duration, title, and format before transcribing — useful for credit gating and ETA display.
- [ASR (Speech Recognition)](https://docs.lesan.ai/guides/asr): Transcribe audio to text: single files (sync and async), async polling, and batch processing of multiple files.
- [MT (Machine Translation)](https://docs.lesan.ai/guides/mt): Translate text between languages with the Machine Translation API.
- [Streaming (WebSocket)](https://docs.lesan.ai/guides/streaming): Real-time speech recognition using the Lesan AI WebSocket streaming API.
- [Webhooks](https://docs.lesan.ai/guides/webhooks): Receive real-time notifications when transcription jobs complete or fail.
- [Best Practices](https://docs.lesan.ai/guides/best-practices): Best practices and recommendations for using Lesan AI services.

## Reference

- [Error Codes](https://docs.lesan.ai/guides/error-codes): Reference of error codes, the error response format, and handling strategies for the Lesan AI API.
- [Rate Limits](https://docs.lesan.ai/guides/rate-limits): API rate limits, quotas, and usage tracking.
- [Audio Formats](https://docs.lesan.ai/guides/audio-formats): Supported audio formats for file upload and WebSocket streaming.

## API

- [API Reference](https://docs.lesan.ai/api-reference): Interactive reference for all public endpoints.
- [OpenAPI specification](https://docs.lesan.ai/openapi.json): Machine-readable OpenAPI 3.1 spec (JSON).
- [Full documentation text](https://docs.lesan.ai/llms-full.txt): The full API reference — every endpoint, schema, and example — plus the guide index, as one plain-Markdown document.