# Olaverse API

> Calibrated decisions, document extraction, language identification, diacritic restoration and question generation, built for English and African languages. One base URL (https://api.olaverselab.com) and one bearer key.

## Agent resources

- [Agent skill](https://docs.olaverselab.com/.well-known/agent-skills/olaverse-api/SKILL.md): install with `npx skills add https://docs.olaverselab.com --skill olaverse-api`
- [Models and prices](https://api.olaverselab.com/v1/models): live JSON, no key needed

## Documentation

- [Introduction](https://docs.olaverselab.com/): Run decision, extraction and language models built for English and African languages, through one API.

### Get started

- [Agent skill](https://docs.olaverselab.com/get-started/agent-skill/): Install the Olaverse skill so Claude Code, Cursor and Codex can write correct Olaverse API calls for you.
- [Authentication](https://docs.olaverselab.com/get-started/authentication/): Send your API key as a bearer token.
- [Buy through Azure Marketplace](https://docs.olaverselab.com/get-started/azure-marketplace/): Subscribe to the Olaverse API on Microsoft Azure Marketplace and pay for it on your Azure invoice.
- [Use with OpenAI and OpenRouter clients](https://docs.olaverselab.com/get-started/compatibility/): Point the OpenAI SDK, OpenRouter, TypeSafe, Ollama or LiteLLM clients at Olaverse by changing the base URL.
- [Use with AI agents (MCP)](https://docs.olaverselab.com/get-started/mcp/): Give Claude, Cursor and other AI agents Olaverse's document extraction, decisions, language ID and diacritics as tools, with the Olaverse MCP server.
- [Quickstart](https://docs.olaverselab.com/get-started/quickstart/): Create an API key and make your first decision call to the Olaverse API.
- [Example use cases](https://docs.olaverselab.com/get-started/use-cases/): What teams build on the Olaverse models, from support routing to payment messages and multilingual search.

### Capabilities

- [Decisions](https://docs.olaverselab.com/api/decisions/): Typed decisions about a message, ticket, record, receipt or screenshot, with a calibrated probability for every option.
- [Diacritic restoration](https://docs.olaverselab.com/api/diacritics/): Restore diacritics, tone marks and Arabic vowel marks in 11 languages.
- [Document extraction](https://docs.olaverselab.com/api/extraction/): Turn a document (text, photo or screenshot) into JSON, with a calibrated confidence for every field.
- [Language identification](https://docs.olaverselab.com/api/language-id/): Identify the language of a text from 608 languages, built African-first.
- [Inference API](https://docs.olaverselab.com/api/overview/): The base URL, request format, batches, usage and timeouts shared by every Olaverse endpoint.
- [Question generation](https://docs.olaverselab.com/api/questions/): Bulk search queries from your passages, for training and testing search and RAG systems, in 17 languages, with 8 more in free beta.

### Cookbooks

- [Build an FAQ from help articles](https://docs.olaverselab.com/cookbooks/faq-from-articles/): Turn help-centre articles into natural, search-style questions in each article's own language.
- [Route messages by language](https://docs.olaverselab.com/cookbooks/language-routing/): Identify each message's language, then send it to the right queue, agent or model.
- [Read a mobile-money message](https://docs.olaverselab.com/cookbooks/mobile-money-message/): Extract the amount, sender, reference and date from a MoMo or bank SMS, then decide whether it looks genuine.
- [Triage a support ticket](https://docs.olaverselab.com/cookbooks/support-ticket-triage/): Route a message to a team, flag refund requests and score urgency in one decision call.

### Troubleshooting

- [Retries and timeouts](https://docs.olaverselab.com/troubleshooting/retries/): Which errors are safe to retry, how to stay inside the rate limit, and how long to wait for a response.

### Reference

- [Pricing](https://docs.olaverselab.com/reference/billing/): Pay-as-you-go prices for every model, and how each one is charged.
- [Errors](https://docs.olaverselab.com/reference/errors/): Status codes the API returns and what to do about each.
- [Model catalog](https://docs.olaverselab.com/reference/models/): Every model behind the Olaverse API, and the free endpoints for discovery and health.