> ## 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.

# From CLI to API

> Turn Breeze CLI workflows into reproducible Developer API requests with breeze curl.

Every Breeze CLI call maps to the public `/v1` Developer API — the same API behind the Breeze Python and TypeScript SDKs. `breeze curl` makes that mapping explicit: it prints the exact API request for a workflow without sending it, so you can graduate from terminal prototyping to production code without starting over.

## Generate a TTS request

`breeze curl tts` mirrors the `breeze tts` flags and prints a ready-to-run cURL command:

```bash theme={null}
breeze curl tts "Hello from Breeze" --voice voc_xeh3w54cqvnp --format mp3 -o hello.mp3
```

The printed command uses a `${BREEZE_API_KEY}` placeholder — your real key is never written to output. Streaming, non-streaming (`--no-stream`), and async (`--async`) variants produce the matching endpoint and body.

With `--output json` or `--agent`, the result is structured data instead of a shell string — method, URL, headers, body, and the assembled command — which suits agents that build their own HTTP calls:

```bash theme={null}
breeze curl tts "Hello from Breeze" --voice voc_xeh3w54cqvnp --agent
```

## Generate a voice preview save request

`breeze curl voice-preview-save` prints the request that saves a generated voice preview as a voice:

```bash theme={null}
breeze curl voice-preview-save <generated_voice_id> --name "Story narrator" --language en
```

## Keep going

* The [API quickstart](/quickstart) shows the same workflows in Python and TypeScript.
* The [API Reference](/api-reference/introduction) documents every `/v1` endpoint `breeze curl` targets.
* `breeze capabilities --agent` lists legal flag values and defaults as JSON — see [Scripting and agents](/cli/reference/scripting#capabilities-discovery).