# Breeze Developer API

Breeze Developer API exposes voice and text-to-speech endpoints with official Python and TypeScript SDKs. 
Every endpoint below is a fully static, AI-friendly HTML page.
For machine-readable integration and agent workflows, use the canonical OpenAPI document below.

## Machine-readable

- [OpenAPI JSON](https://api.breeze.blue/openapi.json)

## Documentation

### Get started
- [Introduction](https://breezeblue.ai/docs/overview/intro)
- [Quickstart](https://breezeblue.ai/docs/quickstart)
- [Authentication](https://breezeblue.ai/docs/authentication)

### Concepts
- [Voices](https://breezeblue.ai/docs/concepts/voices)
- [Output formats](https://breezeblue.ai/docs/concepts/output-format)
- [Streaming](https://breezeblue.ai/docs/concepts/streaming)
- [Pricing](https://breezeblue.ai/docs/concepts/pricing)

### Guides
- [Text to speech](https://breezeblue.ai/docs/guides/text-to-speech)
- [Designing a voice](https://breezeblue.ai/docs/guides/voice-design)
- [Cloning a voice](https://breezeblue.ai/docs/guides/voice-clone)
- [Managing history](https://breezeblue.ai/docs/guides/managing-history)

### Reference
- [Errors](https://breezeblue.ai/docs/errors)
- [Rate limits](https://breezeblue.ai/docs/rate-limits)

## API reference

### Overview
- [API reference](https://breezeblue.ai/docs/api-reference)
- [Introduction](https://breezeblue.ai/docs/api-reference/introduction)

### Models
- [GET /v1/models](https://breezeblue.ai/docs/api-reference/models/list)

### Text to Speech
- [POST /v1/text-to-speech/{voice_id}](https://breezeblue.ai/docs/api-reference/text-to-speech/convert)
- [GET /v1/generation-jobs/{generation_job_id}](https://breezeblue.ai/docs/api-reference/text-to-speech/jobs-get)
- [GET /v1/generation-jobs/{generation_job_id}/audio](https://breezeblue.ai/docs/api-reference/text-to-speech/jobs-audio)
- [POST /v1/text-to-speech/{voice_id}/stream](https://breezeblue.ai/docs/api-reference/text-to-speech/stream)
- [POST /v1/text-to-speech/ai-rewrite](https://breezeblue.ai/docs/api-reference/text-to-speech/ai-rewrite)

### Voices
- [GET /v1/voices](https://breezeblue.ai/docs/api-reference/voices/list)
- [GET /v1/voices/random](https://breezeblue.ai/docs/api-reference/voices/random)
- [GET /v1/voices/{voice_id}](https://breezeblue.ai/docs/api-reference/voices/get)
- [PATCH /v1/voices/{voice_id}](https://breezeblue.ai/docs/api-reference/voices/edit)
- [GET /v1/voices/{voice_id}/settings](https://breezeblue.ai/docs/api-reference/voices/settings)
- [PATCH /v1/voices/{voice_id}/settings](https://breezeblue.ai/docs/api-reference/voices/settings-edit)
- [DELETE /v1/voices/{voice_id}](https://breezeblue.ai/docs/api-reference/voices/delete)

### Voice Previews
- [POST /v1/voice-previews/clone](https://breezeblue.ai/docs/api-reference/voice-previews/clone)
- [POST /v1/voice-previews/design](https://breezeblue.ai/docs/api-reference/voice-previews/design)
- [GET /v1/voice-previews/{generated_voice_id}/stream](https://breezeblue.ai/docs/api-reference/voice-previews/stream)
- [POST /v1/voice-previews/{generated_voice_id}/save](https://breezeblue.ai/docs/api-reference/voice-previews/save)

### History
- [GET /v1/history](https://breezeblue.ai/docs/api-reference/history/list)
- [GET /v1/history/{history_item_id}](https://breezeblue.ai/docs/api-reference/history/get)
- [GET /v1/history/{history_item_id}/audio](https://breezeblue.ai/docs/api-reference/history/audio)
- [DELETE /v1/history/{history_item_id}](https://breezeblue.ai/docs/api-reference/history/delete)

### Account
- [GET /v1/balance](https://breezeblue.ai/docs/api-reference/account/balance)
- [GET /v1/entitlements](https://breezeblue.ai/docs/api-reference/account/entitlements)
- [GET /v1/usage](https://breezeblue.ai/docs/api-reference/account/usage)
- [GET /v1/api-keys](https://breezeblue.ai/docs/api-reference/account/api-keys-list)
- [POST /v1/api-keys](https://breezeblue.ai/docs/api-reference/account/api-keys-create)
- [PATCH /v1/api-keys/{key_id}](https://breezeblue.ai/docs/api-reference/account/api-keys-update)
- [DELETE /v1/api-keys/{key_id}](https://breezeblue.ai/docs/api-reference/account/api-keys-delete)
- [POST /v1/api-keys/{key_id}/disable](https://breezeblue.ai/docs/api-reference/account/api-keys-disable)
- [POST /v1/api-keys/{key_id}/enable](https://breezeblue.ai/docs/api-reference/account/api-keys-enable)
- [POST /v1/api-keys/{key_id}/rotate](https://breezeblue.ai/docs/api-reference/account/api-keys-rotate)