Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.cartesia.ai/llms.txt

Use this file to discover all available pages before exploring further.

Agent Skills are installable SKILL.md guides (plus optional references) for coding agents in Cursor, Claude Code, and similar clients. Cartesia’s official pack is cartesia-ai/skills—add it once, then let your agent follow the same rules as this site’s API docs.

​
Install

npx skills add cartesia-ai/skills
When prompted, choose cartesia-api and/or line-voice-agent (you can add both). Before you start
  • API / app work: A Cartesia API key from play.cartesia.ai/keys.
  • Cartesia Line: Same Cartesia key plus an LLM provider key; the Line quickstart walks through setup and cartesia deploy.

​
Which skill?

ChooseWhen
cartesia-apiYou call REST or WebSocket APIs (Sonic, Ink, voices), use the Python or JS/TS SDKs, or wire optional MCP in the IDE.
line-voice-agentYou build Cartesia Line agents: cartesia CLI, VoiceAgentApp, telephony, tools, and handoffs.

​
What the skills enforce

Skills point agents at the same rules as API conventions. In short:
  • Base URL https://api.cartesia.ai (WebSockets wss://).
  • Cartesia-Version on every request; WebSockets can use cartesia_version in the query string (it overrides the header when both are set).
  • Server: Authorization: Bearer <api_key>. Browsers / client apps: short-lived access tokens; WebSocket handoffs use access_token in the query string.
  • Errors: Prefer structured JSON from current API versions—see API errors.
For machine-readable indexes, use llms.txt and llms-full.txt.

​
See also

  • MCP — optional IDE integration; not a replacement for REST/SDKs in shipped apps.
  • Client libraries — stable paths for production code.
  • Documentation home — Sonic, Ink, and platform overview.