---
title: "Cartesia | Micdrop"
description: "Cartesia implementation for @micdrop/server."
url: "https://micdrop.dev/docs/ai-integration/provided-integrations/cartesia"
---

*   [Getting Started](/docs/getting-started)
*   [Client (Browser)](/docs/client)
    
    *   [Installation](/docs/client/installation)
    *   [React Hooks](/docs/client/react-hooks)
    *   [Start/Stop Call](/docs/client/start-stop-call)
    *   [Pause/Resume Call](/docs/client/pause-resume-call)
    *   [Mute/Unmute Call](/docs/client/mute-unmute-call)
    *   [Call State](/docs/client/call-state)
    *   [Display Conversation Messages](/docs/client/display-conversation-messages)
    *   [Handling Tool Calls](/docs/client/handling-tool-calls)
    *   [Device Management](/docs/client/devices-management)
    *   [Voice Activity Detection (VAD)](/docs/client/vad)
    *   [Error Handling](/docs/client/error-handling)
    *   Utility Classes
        
        *   [Mic](/docs/client/utility-classes/mic)
        *   [MicdropClient](/docs/client/utility-classes/micdrop-client)
        *   [MicRecorder](/docs/client/utility-classes/mic-recorder)
        *   [Speaker](/docs/client/utility-classes/speaker)
        
    
*   [Server (Node.js)](/docs/server)
    
    *   [Installation](/docs/server/installation)
    *   [With Fastify](/docs/server/with-fastify)
    *   [With NestJS](/docs/server/with-nestjs)
    *   [Auth and Parameters](/docs/server/auth-and-parameters)
    *   [First Message](/docs/server/first-message)
    *   [Save Messages](/docs/server/save-messages)
    *   [Resume a Conversation](/docs/server/resume-conversation)
    *   [Recording Audio](/docs/server/recording-audio)
    *   [Error Handling](/docs/server/error-handling)
    *   [Tools](/docs/server/tools)
    *   [Extract Value from Answer](/docs/server/extract)
    *   [Auto End Call](/docs/server/auto-end-call)
    *   [Semantic Turn Detection](/docs/server/semantic-turn-detection)
    *   [Noise Filtering](/docs/server/noise-filtering)
    *   [Micdrop Protocol](/docs/server/protocol)
    
*   [AI Integrations](/docs/ai-integration)
    
    *   Provided Integrations
        
        *   [AI SDK](/docs/ai-integration/provided-integrations/ai-sdk)
        *   [Cartesia](/docs/ai-integration/provided-integrations/cartesia)
        *   [ElevenLabs](/docs/ai-integration/provided-integrations/elevenlabs)
        *   [Gladia](/docs/ai-integration/provided-integrations/gladia)
        *   [Gradium](/docs/ai-integration/provided-integrations/gradium)
        *   [Mistral](/docs/ai-integration/provided-integrations/mistral)
        *   [OpenAI](/docs/ai-integration/provided-integrations/openai)
        
    *   Custom Integrations
        
        *   [Agent (LLM)](/docs/ai-integration/custom-integrations/custom-agent)
        *   [Speech-to-Text (STT)](/docs/ai-integration/custom-integrations/custom-stt)
        *   [Text-to-Speech (TTS)](/docs/ai-integration/custom-integrations/custom-tts)
        
    *   Fallback Strategies
        
        *   [FallbackAgent](/docs/ai-integration/fallback-strategies/agent-fallback)
        *   [FallbackSTT](/docs/ai-integration/fallback-strategies/stt-fallback)
        *   [FallbackTTS](/docs/ai-integration/fallback-strategies/tts-fallback)
        
    *   [IA Vocale Souveraine 🇫🇷🇪🇺](/docs/ai-integration/sovereign-voice-ai)
    

[Micdrop](/) › [Documentation](/docs/getting-started)

# Cartesia

Cartesia implementation for [@micdrop/server](/docs/server).

This package provides high-quality real-time text-to-speech implementation using Cartesia’s streaming API.

## Installation

Terminal window

```
npm install @micdrop/cartesia
```

## Cartesia TTS (Text-to-Speech)

### Usage

```
import { CartesiaTTS } from '@micdrop/cartesia'import { MicdropServer } from '@micdrop/server'
const tts = new CartesiaTTS({  apiKey: process.env.CARTESIA_API_KEY || '',  modelId: 'sonic-turbo', // Cartesia model ID  voiceId: 'a0e99841-438c-4a64-b679-ae501e7d6091', // Voice ID  language: 'en', // Optional: specify language  speed: 'normal', // Optional: speech speed})
// Use with MicdropServernew MicdropServer(socket, {  tts,  // ... other options})
```

### Options

Option

Type

Default

Description

`apiKey`

`string`

Required

Your Cartesia API key

`modelId`

`string`

Required

Cartesia model ID to use

`voiceId`

`string`

Required

Voice ID for speech synthesis

`language`

`CartesiaLanguage`

Optional

Language code for speech

`speed`

`'fast' | 'normal' | 'slow'`

Optional

Speech speed

`connectionTimeout`

`number`

`5000`

Timeout in milliseconds for WebSocket connection

`retryDelay`

`number`

`1000`

Delay in milliseconds between reconnection attempts

`maxRetry`

`number`

`3`

Maximum number of reconnection attempts before failing

### Supported Languages

The package supports the following languages:

Code

Language

Code

Language

Code

Language

`en`

English

`fr`

French

`de`

German

`es`

Spanish

`pt`

Portuguese

`zh`

Chinese

`ja`

Japanese

`hi`

Hindi

`it`

Italian

`ko`

Korean

`nl`

Dutch

`pl`

Polish

`ru`

Russian

`sv`

Swedish

`tr`

Turkish

## Getting Started

1.  Sign up for a [Cartesia account](https://cartesia.ai) and get your API key
2.  Choose a model ID and voice ID from the Cartesia dashboard
3.  Install the package and configure with your credentials

```
import { CartesiaTTS } from '@micdrop/cartesia'
const tts = new CartesiaTTS({  apiKey: 'your-cartesia-api-key',  modelId: 'sonic-turbo', // Or sonic-multilingual for multiple languages  voiceId: 'your-preferred-voice-id',  language: 'en',  speed: 'normal',})
// Use with MicdropServernew MicdropServer(socket, {  tts,  // ... other options})
```

[Previous← AI SDK](/docs/ai-integration/provided-integrations/ai-sdk)[NextElevenLabs →](/docs/ai-integration/provided-integrations/elevenlabs)

On this page

*   [Installation](#installation)
*   [Cartesia TTS (Text-to-Speech)](#cartesia-tts-text-to-speech)
*   [Usage](#usage)
*   [Options](#options)
*   [Supported Languages](#supported-languages)
*   [Getting Started](#getting-started)