A production-ready TypeScript client library for the OpenRouter API
npm install openrouter-tsA production-ready TypeScript client library for the OpenRouter API. This library provides comprehensive access to multiple AI models through OpenRouter's unified interface with full TypeScript support, streaming, error handling, and developer-friendly utilities.
- ✅ Full TypeScript Support - Complete type definitions for all endpoints and parameters
- ✅ Streaming Support - Real-time streaming responses with async iterators
- ✅ Error Handling - Comprehensive error classes with proper categorization
- ✅ Retry Logic - Configurable exponential backoff for network resilience
- ✅ Tool Calling - Full support for function calling across providers
- ✅ Input Validation - Parameter validation with helpful error messages
- ✅ Helper Utilities - Builder patterns and convenience functions
- ✅ Request Cancellation - AbortController support for canceling requests
- ✅ Rate Limit Handling - Automatic retry with proper rate limit respect
- ✅ Multimodal Support - Text and image inputs for compatible models
``bash`
npm install @openrouter/typescript-client
`typescript
import { OpenRouterClient, MODELS } from '@openrouter/typescript-client';
const client = new OpenRouterClient({
apiKey: process.env.OPENROUTER_API_KEY!,
siteUrl: 'https://yoursite.com', // Optional: for rankings
siteName: 'Your App Name' // Optional: for rankings
});
// Basic chat completion
const response = await client.chat.completions.create({
model: MODELS.GPT_4O,
messages: [
{ role: 'user', content: 'Hello! How are you?' }
]
});
console.log(response.choices[0]?.message?.content);
``
MIT License. See LICENSE for details.