Python SDK

SDK reference

The management SDK wraps Orqen account APIs. For chat completions, use the OpenAI SDK withbase_url="https://api.orqen.app/v1".

Client setup

from orqen import OrqenClient

client = OrqenClient(api_key="sk-orq-YOUR_KEY")

# Or read ORQEN_API_KEY from the environment
client = OrqenClient()

Methods

client.usage.summary()	GET /v1/account/usage/summary	Current month requests, token savings, and billing estimate.
client.usage.daily()	GET /v1/account/usage/daily	Daily token savings and request counts.
client.requests.list()	GET /v1/account/requests	Paginated request log.
client.keys.list()	GET /v1/account/keys	List API keys.
client.keys.create()	POST /v1/account/keys	Create an API key; secret returned once.
client.keys.revoke()	DELETE /v1/account/keys/{id}	Revoke an API key.
client.providers.save()	PUT /v1/account/providers	Store or update encrypted provider credentials.
client.routing.update()	PUT /v1/account/routing/preferences	Set passthrough, auto, cheap, fast, or capable routing.

Common tasks

summary = client.usage.summary()
print(summary.total_requests)
print(summary.tokens_saved_estimate)

for day in client.usage.daily():
    print(day.date, day.requests, day.tokens_saved_estimate)

Error handling

SDK methods raise typed errors for authentication, rate limits, validation failures, and upstream API errors. Store API keys securely and rotate them from the dashboard or API.