Floe Text-to-Speech

BYOK-first text-to-speech for Pipecat — route your own OpenAI key through Floe for per-call metering and spend caps, or go keyless.

Overview

FloeTTSService provides an OpenAI-compatible interface for text-to-speech through Floe — a unified billing ledger for voice AI where one key powers the LLM, STT, and TTS legs of an agent, metered per call and bounded by pre-call spend caps. It extends Pipecat’s OpenAITTSService, so streamed audio, metrics, and tracing work unchanged.

BYOK-first. Pass provider_key= with your own vendor key and Floe routes the call on your key, billing only its service fee while still metering the call and enforcing your spend caps. Omit it to go keyless and let Floe manage the keys.

Source Repository

Source code, examples, and issues for the Floe integration

PyPI Package

The pipecat-floe package on PyPI

Floe

Documentation and supported models for Floe

API Keys

Create and manage your Floe agent keys

Installation

This is a community-maintained package distributed separately from pipecat-ai:

uv add pipecat-floe

Prerequisites

Floe Account Setup

Before using the Floe TTS service, you need:

1. Floe Account: Sign up at the Floe dashboard
2. API Key: Create an agent key from your dashboard. New keys come with welcome credit that covers the first calls.

Required Environment Variables

• FLOE_API_KEY: Your Floe agent key for authentication

Configuration

api_key · str · default: "None"

Floe agent key. Falls back to the FLOE_API_KEY environment variable if not provided. Raises ValueError if neither is set.

model · str · default: "openai/tts-1"

Fully qualified provider/model identifier (for example "openai/tts-1"). A bare model name is rejected by Floe.

voice · str · default: "alloy"

Voice identifier to synthesize with.

base_url · str · default: "https://credit-api.floelabs.xyz/v1"

Floe OpenAI-compatible base URL.

task_id · str · default: "None"

Optional Floe task ID sent as the X-Floe-Task-Id header, so a per-task budget can bound one conversation. Attached via a custom httpx client; if you pass your own http_client, add the header to it yourself.

provider_key · str · default: "None"

BYOK. Your upstream vendor key, sent as the X-Floe-Provider-Key header. Floe routes the call on your key and bills only its service fee, while still metering the call and enforcing your spend caps. Omit for the keyless path. Like task_id, it’s attached via a custom httpx client; if you pass your own http_client, add the header to it yourself.

kwargs

Additional keyword arguments passed through to the underlying OpenAITTSService.

Usage

import os
from pipecat_floe import FloeLLMService, FloeSTTService, FloeTTSService
from pipecat.pipeline.pipeline import Pipeline

# One Floe key powers all three legs, on a single budget.
# BYOK — set OPENAI_API_KEY to run on your own vendor key (Floe meters + caps,
# fee-only); leave it unset to run keyless.
oai = os.getenv("OPENAI_API_KEY")
stt = FloeSTTService()                                              # keyless streaming STT
llm = FloeLLMService(model="openai/gpt-4o-mini", provider_key=oai)  # BYOK if set, else keyless
tts = FloeTTSService(model="openai/tts-1", voice="alloy", provider_key=oai)

# ...or omit provider_key to run keyless (Floe manages the vendor keys).
pipeline = Pipeline([stt, llm, tts])

See the source repository for a complete runnable example wiring a WebSocket transport → STT → LLM → TTS.

Compatibility

Built and verified against Pipecat v1.7.0+. Check the source repository for the latest tested version and changelog.