Python SDK

Installation

Most agent traffic only needs the official OpenAI SDK pointed at Orqen. The optionalorqen package is for account management.

Agent requests

pip install openai

from openai import OpenAI

client = OpenAI(
    api_key="sk-orq-YOUR_KEY",
    base_url="https://api.orqen.app/v1",
)

Management SDK

Install the Orqen SDK when you want to create keys, read usage, or manage routing preferences from code.

pip install orqen

Environment variables

ORQEN_API_KEY=sk-orq-YOUR_KEY
ORQEN_BASE_URL=https://api.orqen.app/v1

Versioning

The chat endpoint is OpenAI-compatible, so your OpenAI SDK version matters more than Orqen-specific client code. Upgrade the management SDK only when you need new dashboard/account APIs.

Continue to SDK reference →