Tài liệu API

G-STT · REST cho đối tác
⬇ Tải .md cho AI OpenAPI JSON Swagger UI ↗ Lấy API key Trang chủ

Tổng quan

API chuyển giọng nói tiếng Việt thành văn bản, chạy offline trên CPU. Gọi server-to-server qua HTTPS. Base URL:

Xác thực: mọi request gửi header X-API-Key: sk_live_.... Tạo & thu hồi khoá tại trang API key. Khoá gắn với tài khoản của bạn, có giới hạn số request/phút.

Cho AI/đối tác: tải API_GUIDE.md (tự chứa, đưa thẳng vào ChatGPT/Claude/Cursor… để sinh code) hoặc dùng OpenAPI JSON cho công cụ codegen.

Luồng 4 bước (bất đồng bộ)

1
Tải file lên POST /api/upload
multipart file (mp3/wav/m4a/opus…, ≤500MB) → trả file_id.
2
Bắt đầu xử lý POST /api/process/{file_id}
body JSON tuỳ chọn (model, tách kênh, từ điển…) → đưa vào hàng đợi.
3
Poll trạng thái GET /api/files/{file_id}/status
lặp tới khi status = "completed".
4
Lấy kết quả GET /api/files/{file_id}/result
trả JSON transcript (segments + speaker).

Ví dụ đầy đủ (bash + curl)


    

  


  

    
Tuỳ chọn khi xử lý (body của bước 2)

    

      
TrườngKiểuMặc địnhMô tả

      
        
modelstringzipformer-viID model ASR.

        
telesales_channel_splitboolfalseTách 2 kênh Agent/Khách (call Pitel).

        
agent_channel0|10Kênh của Agent (0=trái).

        
domain_correctionboolfalseSửa lỗi nghe nhầm theo từ điển ngành (tầng A).

        
speaker_diarizationbooltruePhân tách người nói (khi không tách kênh).

      
    

  


  

    
Mã lỗi