π Introducing MARS8 Series β Four Powerful Variants | Available on All Major Clouds | Learn about the model here
π Introducing MARS8 Series β Four Powerful Variants | Available on All Major Clouds | Learn about the model here
Checks the current status of a sound and music generation task by querying with the provided task_id.
curl --request GET \
--url https://client.camb.ai/apis/text-to-sound/{task_id} \
--header 'x-api-key: <api-key>'{
"status": "SUCCESS",
"run_id": 123
}Monitor and track your audio generation journey with our intelligent status tracking system. This essential endpoint serves as your window into the text-to-sound conversion process, providing real-time insights into how your audio creation status. Understanding the status of your generation tasks allows you to build responsive applications that can adapt to the asynchronous nature of complex audio synthesis, creating smoother user experiences and more efficient resource management in your creative workflows.Documentation Index
Fetch the complete documentation index at: https://docs.camb.ai/llms.txt
Use this file to discover all available pages before exploring further.
import requests
import time
import json
from datetime import datetime
# Your API authentication
headers = {
"x-api-key": "your-api-key", # Replace with your actual API key
"Content-Type": "application/json"
}
def check_sound_generation_status(task_id, polling_interval=5):
"""
Monitors the status of a text-to-sound generation task until completion.
Parameters:
- task_id: The unique identifier for your generation task
- polling_interval: How frequently to check status (in seconds)
Returns:
- The final status response upon completion or failure
"""
print(f"Beginning status monitoring for task: {task_id}")
# Initialize tracking variables
start_time = datetime.now()
last_status = None
while True:
try:
# Request the current status
response = requests.get(
f"https://client.camb.ai/apis/text-to-sound/{task_id}",
headers=headers
)
# Verify the request was successful
response.raise_for_status()
# Parse the status information
status_data = response.json()
current_status = status_data.get('status')
# Track status changes for informative updates
if current_status != last_status:
elapsed_time = (datetime.now() - start_time).total_seconds()
print(f"[{elapsed_time:.1f}s] Status: {current_status}")
# Update our tracking variables
last_status = current_status
last_substatus = current_substatus
# Check if the process has completed or failed
if current_status == "SUCCESS":
print("\nβ Sound generation completed successfully!")
print(f"Run ID : {status_data.get('run_id')}")
return status_data
elif current_status == "FAILED":
print(f"\nβ Sound generation failed: {status_data.get('message', 'Unknown error')}")
return status_data
# Wait before checking again
time.sleep(polling_interval)
except requests.exceptions.RequestException as e:
print(f"Error checking generation status: {e}")
if hasattr(e, 'response') and e.response is not None:
print(f"Response content: {e.response.text}")
# Brief pause before retry after error
time.sleep(polling_interval)
# Example usage with intelligent polling
task_id = "your_task_id" # Replace with your actual task_id
final_status = check_sound_generation_status(task_id, polling_interval=3)
# Process the completed result
if final_status and final_status.get('status') == "SUCCESS":
print(f"Processing completed audio from: {audio_url}")
# Download the generated audio
audio_response = requests.get(audio_url)
if audio_response.status_code == 200:
print(f"Task completed successfully!, run ID {status_data.get('run_id')}")
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.
A unique identifier for the task. This is used to query the status of the Sound and Music task that is running. It is returned when a create request is made for Sound and Music.
curl --request GET \
--url https://client.camb.ai/apis/text-to-sound/{task_id} \
--header 'x-api-key: <api-key>'{
"status": "SUCCESS",
"run_id": 123
}