Get ayah timings
qul_get_ayah_timingsRetrieves start and end times in milliseconds for each ayah in a surah recitation audio file, enabling text-audio sync. Requires recitations with segment data.
Instructions
Get start/end times (milliseconds) of each ayah inside a surah recitation's audio file, for syncing text with audio. Only works for surah_recitations with has_segments=true.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"recitation_id": "<recitation_id>",
"chapter": "<chapter>"
},
"name": "qul_get_ayah_timings"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chapter | Yes | Surah number, 1-114 | |
| to_ayah | No | ||
| from_ayah | No | ||
| recitation_id | Yes | A surah_recitations ID | |
| include_word_segments | No | Include word-level timing arrays where QUL has them |