Skip to main content
GET
Get Dubbed Output in Alt Format Status
Monitor the progress of your format conversion tasks with our dedicated status tracking endpoint. This essential companion to our format conversion service lets you check on your media transformation in real-time, providing status information about your content conversion process. By polling this endpoint, you can keep track of your format conversion progress and detect any issues that might arise during processing. This endpoint works in conjunction with the format conversion functionality of our dubbing service, which provides the task_id needed for status checks when requesting alternative output formats.

Understanding Status Values

The endpoint returns one of these status values:
  • SUCCESS: The format conversion task has completed successfully
  • PENDING: The format conversion task is still in progress
  • TIMEOUT: The format conversion task has timed out
  • ERROR: The format conversion task encountered an error
  • PAYMENT_REQUIRED: Additional payment is needed to complete the task

Implementing Status Checking

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

Best Practices for Status Monitoring

To efficiently track your format conversion tasks, consider these professional recommendations:
  1. Implement Exponential Backoff: Start with frequent checks that gradually increase in interval to avoid overloading the API. For example, begin with a 5-second interval, then double it each time until you reach a maximum of 2 minutes between checks.
  2. Handle All Status Codes: Ensure your implementation has specific handling for each possible status value (SUCCESS, PENDING, TIMEOUT, ERROR, and PAYMENT_REQUIRED).
  3. Graceful Error Recovery: If the format conversion fails, implement logic to retry the operation or provide clear feedback to users about the next steps they should take.
  4. User Interface Integration: Present status updates in a user-friendly way, such as progress indicators or status messages that translate the technical status codes into more accessible language.
  5. Event Logging: Maintain a detailed log of all status changes to help with troubleshooting if issues arise during the conversion process.
By properly integrating status checking into your application, you can create a seamless media conversion experience that keeps your users informed throughout the entire process and handles both successful and unsuccessful outcomes appropriately.

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 generating alt format task that is running. It is returned when a create request is made for generating alt format.

Response

Successful Response

The response is of type enum<string>.

Available options:
SUCCESS,
PENDING,
TIMEOUT,
ERROR,
PAYMENT_REQUIRED
Last modified on May 18, 2025