openrouter-sdk-patterns

Build reusable OpenRouter client wrappers with retries, typing, and middleware. Use when creating SDKs or client libraries. Triggers: 'openrouter sdk', 'openrouter client wrapper', 'openrouter patterns', 'openrouter library'.

Zur Installation springen

Repository: jeremylongshore/claude-code-plugins-plus-skills
Letzte Quellaktivität: 17. Juli 2026 um 22:18
Erkannte Sprache von SKILL.md: Englisch
Sterne: 2.604
Forks: 378

Installationsoptionen

Standardmäßig ist der Prompt ausgewählt, der zuerst die Quelle prüft. Sie können zu einem direkten Befehl wechseln oder eine lokale Kopie herunterladen.

Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.

Ein direkter Befehl überspringt den Prüf-Prompt. Prüfen Sie die Quelle, bevor Sie ihn ausführen.

npx skills add https://github.com/jeremylongshore/claude-code-plugins-plus-skills --skill openrouter-sdk-patterns

Der Befehl bleibt in einer Zeile. Scrollen Sie horizontal, um ihn vor dem Kopieren vollständig zu prüfen.

Sie bevorzugen eine lokale Kopie? Laden Sie die Dateien herunter, die SkillsMP derzeit vorliegen.

Quelldateien prüfen

Lesen Sie SKILL.md und alle von SkillsMP angezeigten Begleitdateien, bevor Sie sich für eine Installation entscheiden.

Datei-Explorer

5 Dateien

SKILL.md

Quellanweisungen · Schreibgeschützte Vorschau

Zurück zur Suche Zurück zur Installation

clerk-core-workflow-a

Implement user sign-up and sign-in flows with Clerk. Use when building authentication UI, customizing sign-in experience, or implementing OAuth social login. Trigger with phrases like "clerk sign-in", "clerk sign-up", "clerk login flow", "clerk OAuth", "clerk social login".

2026-07-23

clerk-core-workflow-b

Implement session management and middleware with Clerk. Use when managing user sessions, configuring route protection, or implementing token refresh and custom JWT templates. Trigger with phrases like "clerk session", "clerk middleware", "clerk route protection", "clerk token", "clerk JWT".

2026-07-23

clerk-enterprise-rbac

Configure enterprise SSO, role-based access control, and organization management. Use when implementing SSO integration, configuring role-based permissions, or setting up organization-level controls. Trigger with phrases like "clerk SSO", "clerk RBAC", "clerk enterprise", "clerk roles", "clerk permissions", "clerk organizations".

2026-07-23

Alle aus diesem Repository ansehen

OpenRouter SDK Patterns

Overview

Build production-grade OpenRouter client wrappers using the OpenAI SDK. The OpenAI Python/TypeScript SDKs work natively with OpenRouter by changing base_url to https://openrouter.ai/api/v1. This skill covers typed wrappers, retry strategies, middleware, and reusable patterns.

Prerequisites

An OpenRouter API key (sk-or-v1-...) exported as OPENROUTER_API_KEY — see the openrouter-install-auth skill for setup

Python 3.8+ with the OpenAI SDK plus requests (used for the /auth/key credits check and /generation cost lookups), or Node.js 18+ with the OpenAI SDK

Optional: tenacity if you want the custom retry decorator beyond the SDK's built-in backoff

An app name and URL to send as HTTP-Referer / X-Title default headers for dashboard attribution

Instructions

Start from the Python: Production Client Wrapper (or the TypeScript variant): point the OpenAI SDK at base_url="https://openrouter.ai/api/v1", read OPENROUTER_API_KEY from the environment, and set the HTTP-Referer / X-Title default headers in the constructor.

Return typed results from every call — the CompletionResult dataclass/interface captures content, the served model, prompt_tokens/completion_tokens, generation_id, and latency_ms.

Tune the SDK's built-in retries per the Retry Strategy section (max_retries, timeout in the constructor); add the tenacity decorator only when you need retry behavior beyond the SDK's 429/5xx/connection handling.

Layer cross-cutting concerns via the Middleware Pattern — with_cost_tracking queries GET /api/v1/generation?id= after each request and accumulates a session cost total.

Surface remaining credits and rate limits with check_credits(), which calls GET /api/v1/auth/key with the same key.

Map SDK exceptions using the Error Handling table, then apply the Enterprise Considerations (single central wrapper, dependency injection for tests, SLA-based ).

OpenRouter SDK Patterns

Overview

Prerequisites

An OpenRouter API key (sk-or-v1-...) exported as OPENROUTER_API_KEY — see the openrouter-install-auth skill for setup

Python 3.8+ with the OpenAI SDK plus requests (used for the /auth/key credits check and /generation cost lookups), or Node.js 18+ with the OpenAI SDK

Optional: tenacity if you want the custom retry decorator beyond the SDK's built-in backoff

An app name and URL to send as HTTP-Referer / X-Title default headers for dashboard attribution

Instructions

Return typed results from every call — the CompletionResult dataclass/interface captures content, the served model, prompt_tokens/completion_tokens, generation_id, and latency_ms.

Layer cross-cutting concerns via the Middleware Pattern — with_cost_tracking queries GET /api/v1/generation?id= after each request and accumulates a session cost total.

Surface remaining credits and rate limits with check_credits(), which calls GET /api/v1/auth/key with the same key.

Map SDK exceptions using the Error Handling table, then apply the Enterprise Considerations (single central wrapper, dependency injection for tests, SLA-based ).

import os, time, hashlib, json, logging from dataclasses import dataclass from typing import Optional from openai import OpenAI, APIError, RateLimitError, APITimeoutError log = logging.getLogger("openrouter") @dataclass class CompletionResult: content: str model: str prompt_tokens: int completion_tokens: int generation_id: str latency_ms: float class OpenRouterClient: def __init__( self, api_key: Optional[str] = None, app_name: str = "my-app", app_url: str = "https://my-app.com", max_retries: int = 3, timeout: float = 60.0, ): self.client = OpenAI( base_url="https://openrouter.ai/api/v1", api_key=api_key or os.environ["OPENROUTER_API_KEY"], max_retries=max_retries, # Built-in SDK retry with backoff timeout=timeout, default_headers={ "HTTP-Referer": app_url, "X-Title": app_name, }, ) self._cache: dict[str, CompletionResult] = {} def complete( self, prompt: str, model: str = "anthropic/claude-3.5-sonnet", system: str = "", max_tokens: int = 1024, temperature: float = 0.7, cache: bool = False, **extra_params, ) -> CompletionResult: messages = [] if system: messages.append({"role": "system", "content": system}) messages.append({"role": "user", "content": prompt}) # Optional caching (deterministic requests only) cache_key = None if cache and temperature == 0: cache_key = hashlib.sha256( json.dumps({"model": model, "messages": messages, "max_tokens": max_tokens}).encode() ).hexdigest() if cache_key in self._cache: log.debug(f"Cache hit: {cache_key[:12]}") return self._cache[cache_key] start = time.monotonic() response = self.client.chat.completions.create( model=model, messages=messages, max_tokens=max_tokens, temperature=temperature, **extra_params, ) latency = (time.monotonic() - start) * 1000 result = CompletionResult( content=response.choices[0].message.content or "", model=response.model, prompt_tokens=response.usage.prompt_tokens, completion_tokens=response.usage.completion_tokens, generation_id=response.id, latency_ms=round(latency, 1), ) log.info(f"[{result.model}] {result.prompt_tokens}+{result.completion_tokens} tokens, {result.latency_ms}ms") if cache_key: self._cache[cache_key] = result return result def check_credits(self) -> dict: """Check remaining credits and rate limits.""" import requests resp = requests.get( "https://openrouter.ai/api/v1/auth/key", headers={"Authorization": f"Bearer {self.client.api_key}"}, ) return resp.json()["data"] # Usage or_client = OpenRouterClient(app_name="my-saas") result = or_client.complete("Explain recursion", model="openai/gpt-4o-mini", max_tokens=200) print(f"{result.content}\n---\n{result.model} | {result.latency_ms}ms | {result.prompt_tokens}+{result.completion_tokens} tokens")

name	openrouter-sdk-patterns
description	Build reusable OpenRouter client wrappers with retries, typing, and middleware. Use when creating SDKs or client libraries. Triggers: 'openrouter sdk', 'openrouter client wrapper', 'openrouter patterns', 'openrouter library'.
allowed-tools	Read, Write, Edit, Grep, Bash(python3:), Bash(node:)
version	1.20.0
license	MIT
author	Jeremy Longshore <jeremy@intentsolutions.io>
tags	["saas","openrouter","sdk","patterns"]
compatibility	Designed for Claude Code, also compatible with Codex and OpenClaw

name	openrouter-sdk-patterns
description	Build reusable OpenRouter client wrappers with retries, typing, and middleware. Use when creating SDKs or client libraries. Triggers: 'openrouter sdk', 'openrouter client wrapper', 'openrouter patterns', 'openrouter library'.
allowed-tools	Read, Write, Edit, Grep, Bash(python3:), Bash(node:)
version	1.20.0
license	MIT
author	Jeremy Longshore <jeremy@intentsolutions.io>
tags	["saas","openrouter","sdk","patterns"]
compatibility	Designed for Claude Code, also compatible with Codex and OpenClaw

Exception	HTTP	Cause	Fix
`AuthenticationError`	401	Bad API key	Check `OPENROUTER_API_KEY`
`RateLimitError`	429	Too many requests	SDK auto-retries; increase `max_retries`
`APITimeoutError`	--	Response too slow	Increase `timeout`; use streaming
`BadRequestError`	400	Invalid params	Check model ID, messages format

openrouter-sdk-patterns

Installationsoptionen

Quelldateien prüfen