SONIOX TEXT-TO-SPEECH
Chuyển văn bản thành giọng nói
Tối đa 50.000 từ / 1.000.000 ký tự. POST tạo task ngay; Worker xử lý nền, trả URL từng đoạn và file MP3 cuối.
Lịch sử task
Lưu trên trình duyệt này. Bấm GET để cập nhật trạng thái task.
| Task | Trạng thái | Tiến độ | Tạo lúc | Thao tác |
|---|---|---|---|---|
| Chưa có task nào. | ||||
Chuyển giọng nói thành văn bản — Paid STT
Dùng Soniox chính thức, chung SONIOX_API_KEY trên Worker. Chọn file tối đa 25 MiB hoặc nhập URL audio công khai. Dùng mã truy cập ở trên.
Tải JSON transcript và timestampResponse JSON / timestamp / người nói
Chưa có task.Task, transcript và file upload tại Soniox được lên lịch xóa sau 7 ngày; không lưu audio STT vào R2.
API & hướng dẫn
URL có access_token cho phép đọc task và tải audio của task đó. Giữ riêng nếu nội dung cần bảo mật. Task và audio tự xóa sau 7 ngày.
free dùng API cũ. paid dùng Soniox REST chính thức và cần SONIOX_API_KEY; hỗ trợ cloned voice, emotion/tone và audio tags.
GET /api/health- Kiểm tra dịch vụ, giới hạn đầu vào. Không cần token.
POST /api/tasks- Free: dùng API cũ, hỗ trợ
pitch,speed,volume. POST /api/paid/tasks- Paid: dùng Soniox REST chính thức, cần
SONIOX_API_KEY; hỗ trợ built-in hoặc custom voice ID. GET /api/tasks/{TASK_ID}- Lấy trạng thái, tiến độ, URL từng đoạn,
final_url. Gọi lại mỗi 2 giây đến khicompletedhoặcfailed. GET /api/tasks/{TASK_ID}/chunks/{INDEX}- Nghe/tải MP3 từng đoạn. INDEX bắt đầu từ 0.
GET /api/tasks/{TASK_ID}/final- Nghe/tải MP3 đã ghép khi task hoàn tất.
POST /api/tts- Tạo trực tiếp một MP3, tối đa 250 ký tự; cùng JSON như tạo task.
POST /api/paid/tts- Paid: tạo audio trực tiếp qua Soniox REST chính thức.
POST /api/paid/voices- Upload multipart
name+file(tối đa 35 MB) để tạo cloned voice. GET /api/paid/voices- Liệt kê voice clone trong project;
GET /api/paid/voices/{VOICE_ID}xem trạng thái. POST /api/paid/voices/{VOICE_ID}/recompute- Chuẩn bị voice cho model mới; JSON
{}hoặc{"model":"tts-rt-v2"}. DELETE /api/paid/voices/{VOICE_ID}- Xóa voice clone và embeddings.
POST /api/paid/stt- Paid STT: nhận JSON audio_url hoặc file_id, trả task và URL theo dõi.
POST /api/paid/stt/upload- Paid STT: multipart file và options JSON; tối đa 25 MiB.
GET /api/paid/stt/tasks/{TASK_ID}- Trạng thái queued, processing, completed hoặc error.
GET /api/paid/stt/tasks/{TASK_ID}/transcript- Văn bản, tokens, timestamp và người nói nếu đã bật.
DELETE /api/paid/stt/tasks/{TASK_ID}- Xóa task, transcript và file upload; Soniox trả 409 nếu đang xử lý.
Nếu bật APP_TOKEN: gửi header x-app-token. Các GET của task cũng nhận ?access_token=... từ response tạo task.
GET trạng thái task — URL đầy đủ
Response JSON đầy đủ mới nhất
Tạo task để xem response thực tế.