Skip to main content
GET
Get Subtitle Task Status
Monitor the progress of your subtitle generation in real-time with our status tracking endpoint. This essential companion to our subtitle service lets you check the current state of your media processing job across every requested language. By polling this endpoint, you can track your subtitle task’s lifecycle and handle potential processing issues proactively.
This endpoint works in conjunction with the main /sub endpoint, which initiates the subtitle process and provides the task_id required for status checks.

Implementing Status Checking

Here’s how to implement subtitle status monitoring in your application using Python:

Best Practices for Status Monitoring

Ensure efficient tracking of your subtitle tasks with these professional recommendations:
  1. Optimized Polling Intervals: Start with 15-second intervals and gradually increase to 60 seconds for long media files
  2. Terminal State Handling: Implement robust error handling for both success and failure scenarios

Authorizations

x-api-key
string
header
required

The x-api-key is a custom header required for authenticating requests to our API. Include this header in your request with the appropriate API key value to securely access our endpoints. You can find your API key(s) in the 'API' section of our studio website.

Path Parameters

task_id
string
required

A unique identifier for the task. This is used to query the status of the subtitle task that is running. It is returned when a create request is made for subtitle generation.

Example:

""

Response

Successful Response

status
enum<string>
Available options:
SUCCESS,
PENDING,
TIMEOUT,
ERROR,
PAYMENT_REQUIRED
run_id
integer | null
Last modified on July 26, 2026