> For the complete documentation index, see [llms.txt](https://api-docs.vbee.vn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api-docs.vbee.vn/vbee-api/speech-to-text/get-transcript.md).

# Get transcript

Lấy lại (truy xuất) một transcript đã được tạo trước đó bằng transcriptId

**URL**: <https://api.vbee.vn/v1/stt/transcripts/:transcriptId>

**Method**: GET

**Tham số Header**

| **Tham số**   | **Giá trị**      | **Tính bắt buộc** | **Mô tả**                                                                                                  |
| ------------- | ---------------- | ----------------- | ---------------------------------------------------------------------------------------------------------- |
| Authorization | Bearer {{token}} | Có                | Token đại diện cho App gọi API, được sinh ra dưới dạng JWT có thời hạn do lúc khởi tạo App người dùng chọn |
| App-Id        | {{app-id}}       | Có                | <p><br></p>                                                                                                |

**Kết quả trả về**

* **transcriptId**: ID transcript
* **status**: trạng thái của API
  * PENDING: đang chờ xử lý
  * PROCESSING: đang nhận dạng
  * COMPLETED: xong
  * FAILED: thất bại
* **transcript**: Văn bản nhận dạng ghép từ tất cả các utterances
* **utterances**: Danh sách từng đoạn nhận dạng gồm text, startTime, endTime (giây)
* **audioDurationSeconds**: Thời lượng WAV (giây, làm tròn lên) dùng để tính prepaid billing

***Khuyến nghị polling interval***: 2–5 giây.

```
curl https://api.vbee.vn/api/v1/stt/transcripts/job-uuid-456 \
  -H "Authorization: Bearer <token>" \
  -H "App-ID: <app-id>"
```

```
// Response khi COMPLETE
{
  "transcriptId": "job-uuid-456",
  "status": "COMPLETED",
  "transcript": "nội dung toàn bộ file audio",
  "utterances": [
    {
      "text": "câu đầu tiên",
      "startTime": 0.1,
      "endTime": 3.8
    },
    {
      "text": "câu thứ hai",
      "startTime": 4.2,
      "endTime": 7.5
    }
  ],
  "audioDurationSeconds": 8
}
```