> ## Documentation Index
> Fetch the complete documentation index at: https://docs.breezeblue.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# API reference introduction

> Base URL, authentication, content types, and conventions for the Breeze Developer API.

The Breeze Developer API is a versioned HTTP API at `https://api.breeze.blue`. All public endpoints sit under `/v1/*` and return JSON or binary audio.

## Base URL

```text theme={null}
https://api.breeze.blue/v1
```

## Authentication

Most endpoints accept an API key via the `xi-api-key` header. Account management endpoints such as `/v1/api-keys` require a browser session instead. See [authentication](/authentication) for details.

```http theme={null}
xi-api-key: brz_xxxxxxxxxxxxxxxx
```

## Content type

JSON requests use `content-type: application/json`. Voice cloning uses `multipart/form-data`. Audio responses are raw binary.

## Errors

Errors return `ok: false`, a `code` string, a `detail` message, and an `error` field mirroring `detail`. Validation errors may include a `meta` object. See [errors](/reference/errors).

## Rate limits

Breeze applies plan-based concurrent generation limits. See [rate limits](/reference/rate-limits).

## Explore the API

<Columns cols={2}>
  <Card title="Convert text to speech" icon="mic" href="/api-reference/text-to-speech/convert-text-to-speech">
    Generate a complete audio response from one text input and saved voice.
  </Card>

  <Card title="Stream text to speech" icon="radio" href="/api-reference/text-to-speech/stream-text-to-speech">
    Receive audio chunks as synthesis progresses for lower-latency playback.
  </Card>

  <Card title="Voices" icon="sliders-horizontal" href="/concepts/voices">
    Understand saved voices, designed voices, cloned voices, and `voice_settings`.
  </Card>

  <Card title="CLI Reference" icon="terminal" href="/cli/reference">
    Use CLI commands to prototype, inspect API requests, and automate workflows.
  </Card>
</Columns>