---
title: "Text To Speech Streaming"
method: GET
path: "/api/tts.mp3"
tags: ["tts"]
---

# Text To Speech Streaming

`GET /api/tts.mp3`

Convert text to speech using OpenAI TTS and stream the audio as MP3.

Args:
    text: Text to convert (query parameter)
    voice: Optional voice override (VOICE_1, VOICE_2, etc)
    current_user: Authenticated user

Returns:
    StreamingResponse with MP3 audio data

## Query parameters

- `text` string, required — Text to convert to speech (max 400 words)
- `voice` string — Voice override (VOICE_1, VOICE_2, etc). If not provided, uses user's preferred voice

## Headers

- `x-user-id` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/usecreed/apis/creed-api.md) · [All operations](https://skmtc.net/usecreed/apis/creed-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/usecreed/creed-api/revisions/cb25d3fef898/schema)