Python SDK

1
import os
2
from alephantai_analytics import AlephantAnalytics, AlephantAnalyticsEnvironment
3
4
client = AlephantAnalytics(
5
    # Set the target environment
6
    environment=AlephantAnalyticsEnvironment.DEFAULT,
7
    # Pass your API token
8
    token=f"Bearer {os.getenv('ALEPHANT_API_TOKEN')}",
9
    # Pass the Workspace ID mapping
10
    workspace_id=os.getenv('ALEPHANT_WORKSPACE_ID')
11
)

1
import os
2
from alephantai_analytics import AsyncAlephantAnalytics, AlephantAnalyticsEnvironment
3
4
async_client = AsyncAlephantAnalytics(
5
    environment=AlephantAnalyticsEnvironment.DEFAULT,
6
    token=f"Bearer {os.getenv('ALEPHANT_API_TOKEN')}",
7
    workspace_id=os.getenv('ALEPHANT_WORKSPACE_ID')
8
)

1
def fetch_live_summary():
2
    try:
3
        response = client.saas.get_saas_live_24h(limit=5)
4
        print(f"Top Model: {response.data.top_model}")
5
        print(f"Total Requests: {response.data.total_requests}")
6
    except Exception as e:
7
        print(f"Failed to fetch live summary: {e}")

1
async def get_department_cost_breakdown(department_id: str):
2
    response = await async_client.departments.cost_breakdown(
3
        department_id=department_id,
4
        preset="30d", # Compare last 30 days
5
        limit=50
6
    )
7
    
8
    print(f"Current Period Cost: {response.data.summary.cost_sum}")
9
    for row in response.data.rows:
10
        print(f"Agent: {row.agent_name} | Spend: ${row.spend}")