# Послушать строку

Звук одной строки — тем голосом и так, как она прозвучит в главе.

`POST /segments/{segment_id}/listen` · озвучка

Тот же кусок звука, который потом войдёт в главу: когда глава будет озвучиваться, он не спишется второй раз.
Цена — знаки строки × вес голоса; уже готовый звук бесплатен (`generated: false`).

## Параметры пути

| Параметр | Что это |
|---|---|
| `segment_id` | Id строки |

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

| Поле | Что это |
|---|---|
| `audio_url` | Звук строки (WAV, живёт час) |
| `prepared` | Как текст ушёл голосу: с ударениями, числами словами |
| `generated` | `true` — звук сделан сейчас и списан, `false` — был готов |
| `duration_s` | Длина, секунд |

```bash
curl -X POST "https://golosar-kniga.tech/api/v1/segments/$SEGMENT_ID/listen" \
  -H "x-api-key: $KEY"
```

```python
import os, requests

API = "https://golosar-kniga.tech/api/v1"
H = {"x-api-key": os.environ["GOLOSAR_KEY"]}
segment_id = "01a134d0-ddbf-7616-8ddc-f4b77800ae46"

r = requests.post(f"{API}/segments/{segment_id}/listen", 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 segmentId = "01a134d0-ddbf-7616-8ddc-f4b77800ae46";

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

```json Ответ 200
{
  "audio_url": "https://golosar-kniga.tech/files/eyJrIjoi…",
  "prepared": "Кто здесь?",
  "key": "75dcf866cab3be4d…",
  "generated": false,
  "duration_s": 0.72,
  "text": "Кто здесь?"
}
```