> ## Documentation Index
> Fetch the complete documentation index at: https://docs.maybloc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Maybloc API documentation

> Transcribe recordings with the Maybloc REST API and get every speaker, every word's timing and every overlap back as JSON. Pricing, limits, webhooks and code examples.

Maybloc is a speech-to-text API for recordings with more than one voice. You upload a file and get back a transcript in which every speaker is separated, overlapping speech is kept, and every word has a start and end time.

The model is `calico-1-flash`. It costs \$0.006 per minute, billed by the second, and transcribes recordings of 20 seconds to 3 hours in 45 languages. The base URL is `https://app.maybloc.com/api/v1`.

## What does the API return?

Every completed transcript has four parts:

* **Speakers:** each voice gets a stable id such as `speaker_1` and its total speaking time.
* **Turns:** one speaker talking without a break, with the text and the time of every word.
* **Overlaps:** the start and end of each moment when two or more people talk at once, and which turns overlap.
* **Activity:** when each speaker is audible, including short sounds with no words.

See [what a transcript result contains](https://docs.maybloc.com/guides/results.md) for the full shape.

## How do I make my first request?

> **[Quickstart](https://docs.maybloc.com/quickstart.md)**
>
> Upload a recording, transcribe it and read the result in four requests.

> **[Authentication](https://docs.maybloc.com/authentication.md)**
>
> Create an API key and send it as a bearer token.

> **[Add-ons](https://docs.maybloc.com/guides/add-ons.md)**
>
> Redaction, summaries, speaker names, sentiment, translation and more.

> **[Webhooks](https://docs.maybloc.com/guides/webhooks.md)**
>
> Get a signed request when a transcript finishes, instead of polling.

## How much does it cost?

\$0.006 per minute for the model, plus a per-minute price for each add-on you switch on. A failed or canceled transcript is not charged. See [pricing](https://docs.maybloc.com/guides/pricing.md) for every price and a worked example.

## Is there an OpenAPI specification?

Yes. The OpenAPI 3.1 document is at [https://app.maybloc.com/openapi.json](https://app.maybloc.com/openapi.json). The [API reference](https://docs.maybloc.com/api-reference/retrieve-the-account.md) is generated from it.


## Related topics

- [Transcribe a recording with the Maybloc API](https://docs.maybloc.com/quickstart.md)
- [Languages supported by the Maybloc API](https://docs.maybloc.com/guides/languages.md)
- [How to authenticate Maybloc API requests](https://docs.maybloc.com/authentication.md)
- [Maybloc API errors, rate limits and idempotency](https://docs.maybloc.com/guides/errors-and-limits.md)
- [Maybloc API pricing: per-minute rates and add-on prices](https://docs.maybloc.com/guides/pricing.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.