Lấy trạng thái tác vụ TTS

Tổng quan

Lấy trạng thái và kết quả của tác vụ Chuyển văn bản thành giọng nói hoặc SRT sang giọng nói bằng task_id được trả về từ yêu cầu POST ban đầu.

Endpoint

URL: GET https://tts.revidapi.com/api/get/{task_id}
Method: GET

Yêu cầu

Headers

Không yêu cầu xác thực để kiểm tra trạng thái (hoặc sử dụng x-api-key nếu yêu cầu bởi cấu hình API của bạn)

Tham số Path

Tham số	Kiểu	Mô tả
`task_id`	string	ID tác vụ được trả về từ yêu cầu POST ban đầu

Ví dụ yêu cầu

curl -X GET "https://tts.revidapi.com/api/get/550e8400-e29b-41d4-a716-446655440000" \
  -H "x-api-key: YOUR_API_KEY"

Phản hồi

Trạng thái đang xử lý (202)

{
  "code": 202,
  "task_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "processing",
  "message": "Task is being processed",
  "progress": 50
}

Phản hồi thành công (200)

{
  "code": 200,
  "task_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "message": "success",
  "progress": 100,
  "result": {
    "audio_url": "https://tts.revidapi.com/audio/output.mp3",
    "format": "mp3",
    "duration": 3.5,
    "characters": 100,
    "engine": "edge",
    "mode": "merge"
  }
}

Phản hồi lỗi (404)

{
  "code": 404,
  "task_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "not_found",
  "message": "Task not found"
}

Phản hồi lỗi (500)

{
  "code": 500,
  "task_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "failed",
  "message": "Task processing failed",
  "error": "Error details"
}

Giá trị trạng thái

Trạng thái	Mô tả
`pending`	Tác vụ đang chờ xử lý
`processing`	Tác vụ đang được xử lý
`completed`	Tác vụ hoàn thành thành công
`failed`	Tác vụ thất bại trong quá trình xử lý
`not_found`	Không tìm thấy ID tác vụ

Ghi chú sử dụng

Xác thực: Endpoint không yêu cầu API key (có thể dùng x-api-key nếu cấu hình yêu cầu)
Khoảng thời gian kiểm tra: Khuyến nghị 5-10 giây giữa mỗi lần poll
Timeout: Tác vụ thường hoàn thành trong 30-60 giây, thay đổi theo độ dài văn bản
Tải file audio: Khi hoàn thành, dùng audio_url hoặc GET https://tts.revidapi.com/audio/{filename} để tải xuống

Thực hành tốt nhất

Chiến lược kiểm tra: Bắt đầu với khoảng 5 giây, sau đó tăng lên khoảng 10 giây sau thời gian chờ ban đầu
Xử lý Timeout: Triển khai timeout tối đa (ví dụ: 5 phút) trước khi coi tác vụ thất bại
Xử lý lỗi: Luôn kiểm tra mã trạng thái và xử lý các trường hợp lỗi một cách phù hợp
Lưu trữ kết quả: Tải xuống và lưu trữ URL kết quả ngay lập tức vì chúng có thể hết hạn