# Agent-Friendly Docs

Machine-readable entry points for code agents, runtime agents, and API explorers.

## Read these first

`/llms.txt` summarizes stable docs and reference URLs for language-model agents. `/llms-full.txt` contains the full Markdown corpus in one file.

Every page is also emitted as Markdown at `/path/index.md`, and HTML responses advertise the Markdown alternate link.

`/api/openapi.json` exposes the public `/v1` developer surface as OpenAPI 3.1 for API clients and code generators. `/api/capabilities.json` is the same catalog with scopes, schemas, and examples.

The live gateway also serves `GET /v1/openapi.json` and `GET /v1/capabilities` so an agent can read the contract and its own key's capabilities at runtime.


## Decision rules for agents

Use one Bearer credential and never send both `Authorization` and `x-api-key`. Prefer the typed SDK methods or the documented `/v1` paths over guessing internal routes. Discover deployment-specific model ids with `client.models.get(modality)` before sending multimodal params. Keep credentials out of prompts and generated files.