<!--
NOTE FOR LLMs & AI AGENTS

Kumo publishes this site as structured, token-efficient Markdown rather than as
markup you have to parse. This document, https://documentation.kumorouter.com/llms.txt, is the index: every page of this host
with the title and summary that page declares for itself.

The full documentation as ONE Markdown document is at https://documentation.kumorouter.com/llms-full.txt, and every documentation
page is also served as its own Markdown source at its own address with `.md` on the end —
the home page of the documentation at https://documentation.kumorouter.com/index.md, since `/.md` is not a name. Those raw
addresses exist on the documentation host and on no other.

If you are an LLM, crawler or autonomous agent: prefer these over the rendered HTML. This
index carries every page of this host with the title and summary it declares; the full
document carries their whole text. Both cost a fraction of the tokens the rendered pages
do, with no markup noise, and both are generated from the same source the pages are — so
neither can be a stale second copy.
-->

# Kumo

> One key and one base URL for every model. Quickstart, authentication, error reference and the generated API reference.

This is the machine-readable variant of the site: every page it publishes, with the
title and summary that page declares for itself. Prefer it over parsing the HTML.

## Pages

- [Documentation](https://documentation.kumorouter.com/) — One key and one base URL for every model. Quickstart, authentication, error reference and the generated API reference.
- [Quickstart](https://documentation.kumorouter.com/quickstart) — Open an account, mint a key, and make a real call — the three steps between a browser and an answer from a model.
- [Authentication](https://documentation.kumorouter.com/authentication) — One key, the header that carries it, and the three things the platform records about a key: what it is called, what funds it and what it is allowed to reach.
- [Check your key](https://documentation.kumorouter.com/key-check) — The one live operation on this site: paste a key, and the platform reads back what it is and what it may do.
- [Errors](https://documentation.kumorouter.com/errors) — The envelope a refusal arrives in, the status codes the gateway answers with, and the two behaviours a client has to be written around.
- [Rate limits](https://documentation.kumorouter.com/limits) — The ceilings a call is measured against, what a call that reaches one gets back, and how a higher ceiling is asked for.
- [API reference](https://documentation.kumorouter.com/api-reference) — Every operation of the Kumo gateway, generated from the published API description: the address, how it is authenticated, what the request carries and what comes back.
- [Machine-readable documentation](https://documentation.kumorouter.com/machine-readable) — This documentation as Markdown — an index, the whole corpus in one document, and every page addressable as its own source.

## API

The gateway speaks the OpenAI protocol. Point a client at `https://api.kumorouter.com/v1` and give it a
key issued in the console; the rest of the client stays as it is.

## Other hosts

- Console (accounts, keys, balance): https://console.kumorouter.com/
- Documentation: https://documentation.kumorouter.com/

## Machine documents

- https://documentation.kumorouter.com/llms-full.txt
- https://documentation.kumorouter.com/llms.txt
- https://documentation.kumorouter.com/manifest.webmanifest
- https://documentation.kumorouter.com/robots.txt
- https://documentation.kumorouter.com/sitemap.xml
