Get Text-to-Speech Task Status
Retrieves the current status of a Text-to-Speech task using the specified task_id.
GET
Get Tts Result
This route is the legacy status check that pairs with deprecated
POST /tts. For greenfield work, prefer streaming: call POST /tts-stream and let audio flow continuously instead of polling here.How to Use This Endpoint
To check the status of your Text-to-Speech task, simply send aGET request to this endpoint with the task_id you received when you submitted your original request. The system will respond with detailed information about where your task stands in the processing pipeline.
Understanding the Response
When you call this endpoint, you’ll receive a status response that includes several key pieces of information:- Status Code: Indicates whether the task is still processing, has completed successfully, or encountered an error.
- Result Information: For completed tasks, includes the
run_idneeded to download your finished audio file.
Status Types Explained
Your text-to-speech task will pass through different states as our system processes it. Understanding these status codes will help you properly handle each situation in your application:Example Code
Next Steps
Once your task shows a status ofSUCCESS, you’ll receive a run_id in the response. This run_id is your key to accessing the generated audio. Take this identifier and use it with the /tts-result/{run_id} endpoint to download your finished audio file and put it to work in your application.Authorizations
Path Parameters
Last modified on May 14, 2026