---
title: Ryza Cloud TTS API
emoji: ☁️
colorFrom: blue
colorTo: purple
sdk: docker
app_port: 7860
pinned: false
license: other
---

Personal API-key-protected proxy for the private `ramu23/ryza-zerogpu` Space.

Endpoints:

- `POST /v1/tts` — authenticated synthesis; returns `audio/wav`
- `GET /v1/voices` — four available voice IDs
- `GET /health` — proxy configuration status
- `GET /docs` — OpenAPI documentation

Authentication:

```text
Authorization: Bearer <CLOUD_TTS_API_KEY>
```

Example request:

```bash
curl -X POST "https://ramu23-ryza-api.hf.space/v1/tts" \
  -H "Authorization: Bearer $CLOUD_TTS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"你好，这是莱莎的云端语音。","voice_id":"zh_ryza","language":"zh","response_format":"wav"}' \
  --output ryza.wav
```

The HF token and API key are configured as Space Secrets and are never committed to this repository.