SDK

Configuration

Fine-tune your Hyperion client with advanced parameters for timeouts, retries, and high-level routing intents.

Parameter	Type	Description
apiKey	string	Your master administration or organization-scoped key.
baseUrl	string	The gateway endpoint (default: https://api.hyperion.ai/v1).
timeout	number	Maximum duration to wait for a completion (ms/sec).
maxRetries	number	Number of times to retry failed requests automatically.
defaultHeaders	Record	Custom headers passed with every completion request.

Client Initialization

We recommend initializing the client once and sharing it across your application context for optimal connection pooling.

from hyperion import Hyperion

client = Hyperion(
    api_key="your_key",
    base_url="https://api.hyperion.ai/v1",
    timeout=30.0,
    max_retries=3,
    # Additional options
    default_headers={"X-Organization-ID": "org_123"}
)