Get Translation Task Status

import requests
import time

def check_translation_status(task_id, api_key, base_url="https://client.camb.ai/apis"):
    """
    Check the status of a translation task with exponential backoff.

    Parameters:
    -----------
    task_id : str
        The unique identifier for the translation task
    api_key : str
        Your API authentication key
    base_url : str
        The base URL for the API endpoints

    Returns:
    --------
    dict
        The final response containing translations if successful
    """
    headers = {
        "x-api-key": api_key,
        "Content-Type": "application/json"
    }

    # Initial polling parameters
    wait_time = 1  # Start with 1 second
    max_wait_time = 10  # Maximum seconds between polls
    max_total_wait = 300  # Maximum total seconds to wait (5 minutes)
    start_time = time.time()

    while (time.time() - start_time) < max_total_wait:
        # Get current status
        response = requests.get(
            f"{base_url}/translate/{task_id}",
            headers=headers
        )

        # Check for API errors
        if response.status_code != 200:
            print(f"Error checking status: HTTP {response.status_code}")
            return None

        status_data = response.json()
        current_status = status_data.get("status")

        # Handle each possible status
        if current_status == "SUCCESS":
            print("✅ Translation completed successfully!")
            return status_data  # Contains translations

        elif current_status == "PENDING":
            elapsed = round(time.time() - start_time)
            print(f"⏳ Translation in progress... ({elapsed}s elapsed)")

        elif current_status == "ERROR":
            print("❌ Translation failed with an error.")
            return status_data  # May contain error details

        elif current_status == "TIMEOUT":
            print("⏰ Translation timed out on the server.")
            return status_data

        elif current_status == "PAYMENT_REQUIRED":
            print("💰 Additional payment or credits required.")
            return status_data

        # Wait before checking again, with exponential backoff
        time.sleep(wait_time)
        wait_time = min(wait_time * 2, max_wait_time)  # Double wait time but cap it

    # If we've reached here, we've exceeded our maximum wait time
    print("🛑 Client-side timeout: Maximum wait time exceeded")
    return None

# Example usage:
api_key = "your-api-key"  # Replace with your actual API key
task_id = "your_task_id"  # Replace with your actual task ID

result = check_translation_status(task_id, api_key)

if result and result.get("status") == "SUCCESS":
    print(f"Use the Run ID: {result.get('run_id')} to fetch your translated result.")