APISpeech to Text

Tra cứu lịch sử yêu cầu

Tra cứu lại kết quả một request STT đã xử lý trước đó, theo `id` (chính là `trackingId` trả về từ `POST /stt`). Response dùng chung schema `SttResponse` với endpoint tạo request. `inputAudioUrl` là đúng presigned URL tạm thời mà lúc gọi `POST /stt` đã trả về, nên có thể đã **hết hạn** vào thời điểm tra cứu (audio input lưu ngắn hạn — giọng nói là dữ liệu cá nhân, PII). **Eventual consistency:** bản ghi được ingest bất đồng bộ (qua Kafka) sau khi xử lý xong, nên tra cứu ngay sau khi gọi `POST /stt` có thể trả về `404 RESULT_NOT_FOUND` trong chốc lát — hãy thử lại sau vài giây.

Headers

X-Api-KeystringRequired

Query parameters

idstringRequired

trackingId trả về từ response của POST /stt.

Response

Thành công.

trackingIdstring

Mã tra cứu request, dùng để tra cứu lại qua GET /stt/jobs.

transcriptstring

Văn bản phiên âm được từ audio.

audioDurationinteger

Độ dài audio đầu vào, làm tròn tới giây.

fileSizeByteslong

Dung lượng file audio đầu vào (byte), đo phía server.

processingTimeMslong

Tổng thời gian xử lý end-to-end (mili-giây).

inputAudioFileNamestring or null

Tên file gốc đã upload.

inputAudioUrlstring or nullformat: "uri"

Link tạm thời (presigned URL) để nghe lại audio đã gửi ngay sau khi nhận response — hết hạn nhanh, file input tự động xoá (giọng nói là dữ liệu cá nhân — PII); không dùng để lưu trữ lâu dài.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error
502
Bad Gateway Error