demystify-gateway-sdk 0.2.0

Python SDK for the dmstfy-gateway data plane (chat, embeddings, STT, TTS via one OpenAI-compatible endpoint)

demystify-gateway-sdk

Python client for the dmstfy-gateway data plane — a multi-tenant, OpenAI-compatible AI gateway with virtual keys, per-tenant rate limits, micro-USD budget ledgers, and usage metering.

Part of the Demystify Core Services suite. Sync and async clients are provided; both speak the same wire contract the gateway's mock and live backends share, so code written against the offline mock runs unchanged against a real deployment.

Install

pip install demystify-gateway-sdk
# or
uv add demystify-gateway-sdk

Quickstart

from demystify_gateway_sdk import create_gateway_client

client = create_gateway_client(
    base_url="http://localhost:8080",
    key="dmk_your_virtual_key",
    product="my-app",
)

res = client.chat(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Say hello in one sentence."}],
)
print(res["choices"][0]["message"]["content"])
print("cost µUSD:", res["usage"]["cost_micro_usd"])

Async is symmetric:

from demystify_gateway_sdk import create_async_gateway_client

client = create_async_gateway_client(base_url="http://localhost:8080", key="dmk_...")
res = await client.chat(model="gpt-4o-mini", messages=[...])

Public API

Symbol	Purpose
create_gateway_client / GatewayClient	Synchronous client
create_async_gateway_client / AsyncGatewayClient	Asyncio client
SpeechResult	Typed result for audio transcription/speech endpoints
GatewayError	Raised on non-2xx responses (carries status + error taxonomy code)

See the module README for the full endpoint reference, the admin/control-plane API, and how to run the gateway offline with zero API keys.

License

MIT © Demystify Systems