Overview

Pipecat Cloud provides API keys for some Pipecat services that you can use directly in your applications. These managed keys give you access to competitive pricing, higher rate limits, pre-signed BAAs and DPAs for compliance, and integrated billing with your Pipecat Cloud account.
Managed keys are currently in beta. We are planning to add more services based on demand. If you’re interested in us supporting a specific service, let us know by emailing pipecat-ai@daily.co.

Supported Services

  • Cartesia Text-to-Speech

Pricing

Usage of managed keys is billed through your Pipecat Cloud account. For detailed pricing information, visit our pricing page.

How to Use Managed Keys

Enable in Deployment Configuration

When deploying your agent, you need to enable managed keys in your configuration. Using pcc-deploy.toml:
enable_managed_keys = true
Using the CLI:
pcc deploy --enable-managed-keys true
This setting is configured per agent deployment. Any changes require redeploying your agent to take effect.

Update Your Code

When initializing a supported service in your Pipecat application, use the special string "PIPECATCLOUD" as the API key. This tells Pipecat Cloud to use the managed key when your agent is deployed. To ensure your code works both locally (with your own API key) and when deployed (with managed keys), use this pattern:
import os
from pipecat.services.cartesia.tts import CartesiaTTSService

tts = CartesiaTTSService(
    api_key=os.getenv("CARTESIA_API_KEY", "PIPECATCLOUD"),
    voice_id="71a7ad14-091c-4e8e-a314-022ece01c121",
)
This approach:
  • Uses your local CARTESIA_API_KEY environment variable during development
  • Automatically switches to the managed key when deployed to Pipecat Cloud
The PIPECATCLOUD key is only available for Cartesia TTS when there is no value for CARTESIA_API_KEY in your corresponding secrets set.

Getting Help

If you have any questions about using managed keys, reach out to us on Discord. Our community and team are happy to help!