Agent-Friendly Docs
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.