cartesia-api

Call Cartesia TTS and STT HTTPS/WebSocket APIs with authentication and versioning.

4|Updated Feb 4, 2026
One-click install
npx skills add https://github.com/cartesia-ai/skills --skill cartesia-api
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cartesia-api
Source: https://github.com/cartesia-ai/skills/tree/main/skills/api
Command: npx skills add https://github.com/cartesia-ai/skills --skill cartesia-api

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill solves the problem of integrating Cartesia speech capabilities—text-to-speech, speech-to-text, and voice selection—into application code and agent-assisted workflows without getting stuck on authentication, versioning, or API conventions.

Core Features & Use Cases

  • TTS (Sonic) integration: Generate audio from text using the correct HTTPS/WebSocket endpoints and the required version header or query parameter.
  • STT (Ink) integration: Convert spoken audio to text for conversational or real-time use cases while keeping request semantics consistent.
  • Voice management: Use voices via library/clone/localize workflows and select them correctly using API-supported voice identifiers.
  • Agent-ready guidance: Helps developers and coding agents choose REST/WebSocket vs SDK paths, handle concurrency/quota errors, and avoid mixing up Cartesia API vs Line deployments.

Quick Start

Use the cartesia-api skill to send a POST request to the Cartesia TTS endpoint with Authorization Bearer set to your Cartesia API key and include the Cartesia-Version header that matches your documentation.

Frequently Asked Questions about cartesia-api

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I authenticate Cartesia TTS and STT API requests?

Authenticate Cartesia API requests over HTTPS using an Authorization Bearer header with your Cartesia API key. For client applications, generate and use access tokens instead of exposing your primary API key directly.

What is the difference between Cartesia REST and WebSocket APIs for speech?

Cartesia REST HTTPS endpoints handle standard request-response cycles for TTS and STT, while WebSocket APIs support real-time streaming audio. Choose REST for batch processing or WebSocket for low-latency conversational agent workflows.

How do I add the Cartesia-Version header to TTS API calls?

Include the Cartesia-Version header consistently in all Cartesia TTS and STT HTTPS and WebSocket API calls. The version value must match your documentation to ensure correct endpoint behavior and avoid versioning mismatches.

Can I use Cartesia voice cloning and voice IDs with the TTS API?

Yes, Cartesia TTS supports voice management via library, cloning, and localization workflows. Select specific voices in your API requests using API-supported voice identifiers after configuring them through the voice management endpoints.

Does the Cartesia API work with Python for agent workflows?

Yes, the Cartesia API integrates with Python for agent-assisted workflows and optionally supports cartesia-mcp with Python 3.13+. It guides coding agents in choosing REST or SDK paths and handling concurrency or quota errors.

Why is my Cartesia TTS streaming request returning quota errors?

Cartesia TTS streaming requests return concurrency or quota errors when usage limits are exceeded. The skill provides guidance to handle these errors, choose REST versus WebSocket paths, and avoid mixing Cartesia API with Line deployments.