SDK Quick Start

Install the SDK & get your key

Install the SDK with pip install superpenguin, then go to SDK Keys and create an SDK API key. You'll get a key starting with sp_. Copy it — it's only shown once.

Wrap your LLM client

Initialize the SDK with your sp_ key, then wrap your OpenAI, Anthropic, or LiteLLM client. No base URL changes needed — calls go directly to the provider.

import superpenguin as sp
from openai import OpenAI

sp.init(api_key="sp_...")

client = sp.wrap(OpenAI())

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Hello"}]
)

Add metadata for attribution

Set default metadata on your client, or pass per-call metadata via extra_body to attribute costs to customers, features, teams, or environments.

# Set default metadata for all calls from this client
client = sp.wrap(OpenAI(), metadata={
    "customer_id": "cust_acme_123",
    "feature": "doc_summary",
    "team": "product",
    "environment": "production",
})

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Summarize this"}],
)

View your data

Go to the Attribution page. You'll see:

Switch to the Reconciliation tab to compare SDK-estimated costs against your actual provider bills.