Python & Node.js SDKs

# Python 3.8+
pip install routeplex

# Node 18+
npm install @routeplex/node

from routeplex import RoutePlex
client = RoutePlex(api_key="YOUR_API_KEY")

import { RoutePlex } from "@routeplex/node";
const client = new RoutePlex({ apiKey: "YOUR_API_KEY" });

client.chat("Hello!")                                # auto-routing
client.chat("Summarize", strategy="cost")            # strategy-biased
client.chat("Explain", model="gpt-4o-mini")          # manual model
client.chat("Write a test", test_mode=True)          # default-tier only

await client.chat("Hello!");
await client.chat("Summarize", { strategy: "cost" });
await client.chat("Explain", { model: "gpt-4o-mini" });
await client.chat("Write a test", { testMode: true });

for event in client.chat_stream("Tell me a joke", stream_mode="realtime"):
    if event.type == "delta":
        print(event.content, end="", flush=True)

const stream = await client.chatStream("Tell me a joke", { streamMode: "realtime" });
for await (const event of stream) {
  if (event.type === "delta") process.stdout.write(event.content);
}

est = client.estimate("Write a blog post about AI")
print(est.estimated_cost_usd)

const est = await client.estimate("Write a blog post about AI");
console.log(est.estimatedCostUsd);

result = client.enhance("tell me about kubernetes")
print(result.enhanced_prompt)

const r = await client.enhance("tell me about kubernetes");
console.log(r.enhancedPrompt);

for m in client.list_models():
    print(f"{m.id} ({m.provider}) — {m.tier}")

const models = await client.listModels();

from routeplex import (
    RoutePlex,
    AuthenticationError,
    RateLimitError,
    ValidationError,
    ProviderError,
    ContentPolicyError,
)

try:
    response = client.chat("Hello!")
    print(response.output)
except AuthenticationError:
    print("Invalid API key")
except RateLimitError as e:
    print(f"Rate limited: {e.code} — {e.message}")
except ValidationError as e:
    print(f"Bad request: {e.message}")
except ContentPolicyError:
    print("Content blocked by moderation")
except ProviderError:
    print("All upstream providers failed")

import {
  RoutePlex,
  AuthenticationError,
  RateLimitError,
  ValidationError,
  ProviderError,
  ContentPolicyError,
} from "@routeplex/node";

try {
    const response = await client.chat("Hello!");
    console.log(response.output);
} catch (err) {
    if (err instanceof AuthenticationError) {
        console.log("Invalid API key");
    } else if (err instanceof RateLimitError) {
        console.log(`Rate limited: ${err.code} — ${err.message}`);
    } else if (err instanceof ValidationError) {
        console.log(`Bad request: ${err.message}`);
    } else if (err instanceof ContentPolicyError) {
        console.log("Content blocked by moderation");
    } else if (err instanceof ProviderError) {
        console.log("All upstream providers failed");
    } else {
        throw err;
    }
}