프레임워크 연동 개요

MyIP OpenRouter 는 OpenAI Chat Completions 규격을 따릅니다. 그래서 별도의 SDK 를 만들지 않았고, 만들 필요도 없습니다. OpenAI 엔드포인트를 가리킬 수 있는 도구라면 우리도 가리킬 수 있습니다.

공통 설정 세 가지

어떤 프레임워크든 바꿀 값은 셋뿐입니다.

예제에서는 환경 변수 이름으로 MYIP_API_KEY 를 씁니다. 도구가 OPENAI_API_KEY 만 읽는다면 거기에 우리 키를 넣으면 됩니다.

export OPENAI_BASE_URL="https://openrouter.myip.co.kr/api/v1"
export OPENAI_API_KEY="sk-mo-v1-..."

전용 안내가 있는 프레임워크

• OpenAI SDK — Python·TypeScript 공식 SDK. 가장 먼저 보세요.
• Vercel AI SDK — @ai-sdk/openai-compatible 로 연결
• LangChain — ChatOpenAI 에 base URL 지정

그 밖의 도구

아래는 우리가 별도 페이지를 두지 않았지만 위의 세 가지 설정만으로 붙는 부류입니다. 공식 통합을 제공하거나 보증하지는 않으며, 각 도구의 문서를 따라 설정하시면 됩니다.

붙기 전에 확인할 것

1. 엔드포인트가 우리 지원 범위인가

우리는 다음만 구현합니다.

POST /api/v1/chat/completions
POST /api/v1/completions
GET  /api/v1/models
GET  /api/v1/models/{author}/{slug}/endpoints
GET  /api/v1/generation
GET  /api/v1/key       ·  GET /api/v1/auth/key
GET  /api/v1/credits
GET  /api/v1/keys      ·  GET/PATCH/DELETE /api/v1/keys/{hash}   (관리 키)
GET  /api/v1/providers
GET  /api/v1/datasets/rankings-daily · /api/v1/datasets/app-rankings · /api/v1/benchmarks

임베딩·이미지·음성·Responses API·Batch 등을 쓰는 도구는 그 기능만 404 not_supported 를 받습니다. 전체 목록은 지원하지 않는 엔드포인트 를 보세요.

2. 모델 id 를 도구가 임의로 바꾸지 않는가

일부 도구는 "OpenAI 호환"을 고르면 gpt-4o 같은 기본 모델명을 넣습니다. 그런 id 는 우리 카탈로그에 없으므로 400 model_not_found 가 납니다. 모델명을 직접 입력할 수 있는지 확인하세요.

3. 금액을 USD 로 가정하지 않는가

우리 모든 금액은 원(KRW) 입니다. GET /api/v1/models 의 pricing 값도 원/토큰이고 pricing.currency 가 "KRW" 입니다. 응답 헤더 X-MyIP-Currency: KRW 도 같은 이야기를 합니다. openrouter.ai 용으로 만들어진 비용 표시 기능은 이 숫자를 달러로 착각할 수 있습니다.

4. 키 종류가 맞는가

• sk-mo-v1-… — 추론용. 채팅·완성 호출에 씁니다.
• sk-mo-mgmt-v1-… — 관리용. 키를 만들고 지우는 /keys 경로 전용입니다.

관리 키로 추론을 호출하면 401 invalid_api_key 입니다.

최소 동작 확인

프레임워크를 붙이기 전에 curl 로 먼저 확인하면 문제를 절반으로 줄일 수 있습니다.

curl https://openrouter.myip.co.kr/api/v1/chat/completions \
  -H "Authorization: Bearer $MYIP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemma-4-26b-a4b",
    "messages": [{"role": "user", "content": "ping"}]
  }'

키 상태 확인:

curl https://openrouter.myip.co.kr/api/v1/key -H "Authorization: Bearer $MYIP_API_KEY"

앱 표기

여러 앱에서 같은 키를 쓴다면 HTTP-Referer 와 X-Title 헤더로 구분할 수 있습니다. 대부분의 SDK 는 기본 헤더를 지정하는 옵션을 제공합니다. 앱 표기 참고.

문제가 생기면

오류 형식과 전체 목록은 오류와 디버깅 에 있습니다.