# Голоса

Все голоса, которые можно дать героям: пол, вес цены, что умеют.

`GET /voices` · чтение

Используйте `id` голоса в [голосе героя](/developers/character-patch) и в [`/tts`](/developers/tts).

## Что в ответе

| Поле | Что это |
|---|---|
| `id` / `name` | Id и имя голоса |
| `gender` | `m`, `f` или пусто |
| `description` | Какой голос: регистр, манера |
| `weight` | Вес цены: знаки × вес |
| `emotions` | Голос играет эмоции |
| `stress` | Голос слушается ударений |
| `commercial_ok` / `license` | Можно ли продавать аудиокнигу с этим голосом |
| `recommended` | Мы советуем этот голос |
| `sample_url` | Образец звучания |

```bash
curl "https://golosar-kniga.tech/api/v1/voices" \
  -H "x-api-key: $KEY"
```

```python
import os, requests

API = "https://golosar-kniga.tech/api/v1"
H = {"x-api-key": os.environ["GOLOSAR_KEY"]}

r = requests.get(f"{API}/voices", headers=H)
r.raise_for_status()
print(r.json())
```

```javascript
const API = "https://golosar-kniga.tech/api/v1";
const H = { "x-api-key": process.env.GOLOSAR_KEY };

const r = await fetch(`${API}/voices`, { headers: H });
if (!r.ok) throw new Error(await r.text());
console.log(await r.json());
```

```json Ответ 200
{
  "voices": [
    {
      "id": "01a134c9-6206-79f0-b812-4f2c0a9d5302",
      "name": "Роман",
      "gender": "m",
      "description": "мужской · низкий · спокойный",
      "license": "можно продавать",
      "commercial_ok": true,
      "installed": true,
      "sample_url": "https://golosar-kniga.tech/files/eyJrIjoi…",
      "recommended": true,
      "weight": 1.0,
      "emotions": true,
      "stress": true
    }
  ]
}
```