---
title: "Read Juan Audio"
method: GET
path: "/api/texts/{text_id}/juans/{juan_num}/audio"
tags: ["texts"]
---

# Read Juan Audio

`GET /api/texts/{text_id}/juans/{juan_num}/audio`

## Request

- Base URL: `https://fojin.app` (the document declares no server; this is the origin it was published from)
- URL: `https://fojin.app/api/texts/{text_id}/juans/{juan_num}/audio`
- Auth: none declared

某一卷的读诵音频与句级时间戳。

获取某一卷的在线读诵音频。音频文件本身由静态目录直出（一部经 1~17 MB，
走后端是纯浪费），此处只回地址与时间戳；**没有音频的卷返回 404**，
前端据此不渲染「读诵」按钮。

## Path parameters

- `text_id` integer, required
- `juan_num` integer, required

## Query parameters

- `lang` string: 正文语言

## Response `200`

Successful Response

- TextAudioResponse
  - `text_id` integer, required
  - `juan_num` integer, required
  - `url` string, required
  - `voice_id` string, required
  - `engine` string, required
  - `duration_ms` integer, required
  - `cues` AudioCueItem[]
    - `char_start` integer, required
    - `char_end` integer, required
    - `time_ms` integer, required
    - `kind` string

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/fojin/apis/fojin-api-buddhist-digital-text-platform.md) · [All operations](https://skmtc.dev/fojin/apis/fojin-api-buddhist-digital-text-platform/llms.txt) · [OpenAPI document](https://skmtc.dev/fojin/apis/fojin-api-buddhist-digital-text-platform/revisions/969714238c61?raw)
