Comprehensive, tested, executable examples demonstrating OpenRouter features across multiple ecosystems.
# Set your API key
export OPENROUTER_API_KEY="your-key-here"
# Run all examples
make examples
# Or run specific ecosystems
make curl # Run curl examples
make typescript # Run TypeScript monorepo examples.
├── curl/ - Shell script examples
├── typescript/ - TypeScript monorepo (Bun workspaces)
│ ├── shared/ - Shared constants and types
│ ├── fetch/ - Raw fetch API examples
│ ├── ai-sdk-v5/ - Vercel AI SDK v5 examples
│ ├── effect-ai/ - Effect-TS examples
│ └── openrouter-sdk/ - OpenRouter SDK examples (TODO)
├── docs/ - Feature documentation
└── Makefile - Unified command interface
- Documentation: docs/prompt-caching.md
- Examples:
- Bun runtime:
curl -fsSL https://bun.sh/install | bash - OpenRouter API key: https://openrouter.ai/keys
- For curl examples:
jq(JSON processor)
# Install TypeScript dependencies
make install
# Or manually
cd typescript && bun installmake examplesmake curl # Shell scripts with curl + jq
make typescript # All TypeScript examples (fetch, AI SDK, Effect)# curl
bash curl/prompt-caching.sh
# TypeScript
cd typescript/fetch && bun examples
cd typescript/ai-sdk-v5 && bun examples
cd typescript/effect-ai && bun examples- Copy-paste ready - All examples are runnable as-is
- Tested and proven - Every example has been verified to work
- Evidence-based - Examples show expected outputs and verification
- Multiple ecosystems - Choose the one that matches your stack
- Single source of truth - Constants defined once in
typescript/shared/ - Type safety - Shared types across all TypeScript examples
- Consistent patterns - Each ecosystem follows its own idioms
- Easy maintenance - Bun monorepo for TypeScript workspaces
See individual ecosystem READMEs:
See LICENSE.md
