Глава: строки и запись

Строки главы, кто их говорит, запись и где в ней какая строка.

GET /chapters/{chapter_id} · чтение

segments — строки главы в порядке текста: реплики героев (speech), текст автора (narration), мысли (thought). units — как строки сольются в куски звука. timeline — где в готовой записи какой кусок (секунды t0–t1) и какие в нём строки.

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

Что в ответе

curl "https://golosar-kniga.tech/api/v1/chapters/$CHAPTER_ID" \
  -H "x-api-key: $KEY"

import os, requests

API = "https://golosar-kniga.tech/api/v1"
H = {"x-api-key": os.environ["GOLOSAR_KEY"]}
chapter_id = "01a134d0-ddb7-72aa-b96c-967b596362fe"

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

const API = "https://golosar-kniga.tech/api/v1";
const H = { "x-api-key": process.env.GOLOSAR_KEY };
const chapterId = "01a134d0-ddb7-72aa-b96c-967b596362fe";

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

json Ответ 200 { "chapter": { "id": "01a134d0-ddb7-72aa-b96c-967b596362fe", "position": 0, "title": "Глава 1", "status": "ready", "chars": 108, "duration_s": 6.89, "rendered_at": "2026-10-13T10:31:07.399817+00:00", "audio_url": "https://golosar-kniga.tech/files/eyJrIjoi…", "text": "Вечер был тих, и только ветер шумел в саду.\n— Кто здесь? — с…", "book_id": "01a134d0-dd73-77be-aa8d-0944ffb2b5e3" }, "segments": [ { "id": "01a134d0-ddbf-73ed-9fa8-ecf3089fbbbf", "position": 0, "text": "Вечер был тих, и только ветер шумел в саду.", "kind": "narration", "block_id": 0, "paragraph_id": 0, "character_id": "01a134d0-dda0-7b5d-800a-17ac9f33d738", "skip_audio": false, "pause_ms": null, "confidence": 1.0, "review": false, "issue": "", "emotion": null, "speaker_source": "rules", "emotion_source": "rules", "stressed": null, "delivery": {}, "note": null, "ai": null }, { "id": "01a134d0-ddbf-7616-8ddc-f4b77800ae46", "position": 1, "text": "Кто здесь?", "kind": "speech", "block_id": 1, "paragraph_id": 1, "character_id": "01a134d0-ddae-7737-9ff4-0672f189eef8", "skip_audio": false, "pause_ms": null, "confidence": 0.99, "review": false, "issue": "указано в тексте («спросила»)", "emotion": null, "speaker_source": "rules", "emotion_source": "rules", "stressed": null, "delivery": {}, "note": null, "ai": null } ], "units": [ { "speaker": "01a134d0-dda0-7b5d-800a-17ac9f33d738", "emotion": null, "kind": "narration", "text": "Вечер был тих, и только ветер шумел в саду.", "prepared": "Ве́чер был тих, и то́лько ве́тер шуме́л в саду.", "segment_ids": [ "01a134d0-ddbf-73ed-9fa8-ecf3089fbbbf" ] }, { "speaker": "01a134d0-ddae-7737-9ff4-0672f189eef8", "emotion": null, "kind": "speech", "text": "Кто здесь?", "prepared": "Кто здесь?", "segment_ids": [ "01a134d0-ddbf-7616-8ddc-f4b77800ae46" ] } ], "problems": [], "job": { "id": "01a134d0-e101-75f3-822a-7e5c7ba0f3f3", "type": "render", "job_type": "render", "status": "done", "done": 3, "total": 3, "reused": 0, "credits_used": 108.0, "error": null, "chapter_id": "01a134d0-ddb7-72aa-b96c-967b596362fe", "book_id": "01a134d0-dd73-77be-aa8d-0944ffb2b5e3", "created_at": "2026-10-13T10:31:06.695103+00:00", "started_at": "2026-10-13T10:31:06.784600+00:00", "finished_at": "2026-10-13T10:31:07.399828+00:00", "title": "Озвучка: Глава 1", "stage": "", "eta_s": 5.1, "bytes": null, "bytes_total": null, "cost_usd": null, "took_s": 0.6 }, "timeline": [ { "t0": 0.0, "t1": 3.2, "key": "064fa7ee70cbb6fa…", "text": "Вечер был тих, и только ветер шумел в саду.", "sound": "studio", "speaker": "01a134d0-dda0-7b5d-800a-17ac9f33d738", "prepared": "Ве́чер был тих, и то́лько ве́тер шуме́л в саду.", "segment_ids": [ "01a134d0-ddbf-73ed-9fa8-ecf3089fbbbf" ] }, { "t0": 3.9, "t1": 4.62, "key": "75dcf866cab3be4d…", "text": "Кто здесь?", "sound": "studio", "speaker": "01a134d0-ddae-7737-9ff4-0672f189eef8", "prepared": "Кто здесь?", "segment_ids": [ "01a134d0-ddbf-7616-8ddc-f4b77800ae46" ] } ], "estimate_credits": 69.0 }