OpenRouter Examples

다양한 생태계에 걸쳐 OpenRouter 기능을 시연하는 포괄적이고 테스트된 실행 가능한 예제들입니다.

Quick Start

# API 키 설정하기
export OPENROUTER_API_KEY="your-key-here"

...

Repository Structure (저장소 구조)

. 
├── curl/              - 쉘 스크립트 예제
├── typescript/        - TypeScript 모노레포 (Bun workspaces)
...

Features (기능)

Prompt Caching (프롬프트 캐싱)

• Documentation (문서): docs/prompt-caching.md
• Examples (예제):
  • curl/prompt-caching.sh
  • typescript/fetch/src/prompt-caching/
  • typescript/ai-sdk-v5/src/prompt-caching/
  • typescript/effect-ai/src/prompt-caching/

Prerequisites (사전 준비 사항)

• Bun 런타임: curl -fsSL https://bun.sh/install | bash
• OpenRouter API 키: https://openrouter.ai/keys
• curl 예제를 위한 도구: jq (JSON 프로세서)

Installation (설치)

# TypeScript 의존성 설치하기
make install

...

Running Examples (예제 실행)

All Examples (전체 예제)

make examples

By Ecosystem (생태계별)

make curl          # curl + jq를 사용한 쉘 스크립트
make typescript    # 모든 TypeScript 예제 (fetch, AI SDK, Effect)

Individual Examples (개별 예제)

# curl
bash curl/prompt-caching.sh

...

Benefits (장점)

For Users (사용자를 위한 장점)

1. Copy-paste ready (복사하여 붙여넣기만 하면 사용 가능) - 모든 예제는 수정 없이 실행할 수 있습니다.
2. Tested and proven (테스트되고 검증됨) - 모든 예제는 작동하는 것이 확인되었습니다.
3. Evidence-based (근거 기반) - 예상 출력과 검증을 보여주는 예제들입니다.
4. Multiple ecosystems (다양한 생태계 지원) - 사용자의 스택에 맞는 것을 선택할 수 있습니다.

For Developers (개발자를 위한 장점)

1. Single source of truth (단일 진실 공급원) - typescript/shared/에서 한 번 정의된 상수들입니다.
2. Type safety (타입 안정성) - 모든 TypeScript 예제에 걸쳐 공유되는 타입들입니다.
3. Consistent patterns (일관된 패턴) - 각 생태계는 자체적인 관용구(idioms)를 따릅니다.
4. Easy maintenance (쉬운 유지보수) - TypeScript 워크스페이스를 위한 Bun 모노레포 구조입니다.

Contributing (기여)

개별 에코시스템의 README를 확인하세요:

• curl/README.md
• typescript/README.md

라이선스

LICENSE.md에서 확인하세요