앱 표기

키 하나로 여러 앱을 돌리면 사용 기록만 봐서는 어느 앱이 얼마를 썼는지 알 수 없습니다. 요청에 헤더 두 개를 붙이면 구분됩니다.

둘 다 선택 사항입니다. 붙이지 않아도 요청은 정상 동작하고 과금도 똑같습니다.

붙이는 방법

curl https://openrouter.myip.co.kr/api/v1/chat/completions \
  -H "Authorization: Bearer $MYIP_API_KEY" \
  -H "Content-Type: application/json" \
  -H "HTTP-Referer: https://example.com" \
  -H "X-Title: My Example App" \
  -d '{
    "model": "google/gemma-4-26b-a4b",
    "messages": [{"role": "user", "content": "안녕"}]
  }'

클라이언트에 기본 헤더를 한 번 설정해 두면 그 client 로 나가는 모든 요청에 자동으로 붙습니다.

헤더 이름의 별칭

제목 헤더는 세 가지 이름을 모두 받습니다. 여러 개가 함께 오면 아래 우선순위대로 하나만 씁니다.

1. X-OpenRouter-Title
2. X-MyIP-Title
3. X-Title

openrouter.ai 용으로 짜 둔 코드를 그대로 가져와도 동작하게 하려는 것입니다. 새로 작성한다면 X-Title 을 쓰세요.

HTTP-Referer 가 없으면 표준 Referer 헤더를 대신 읽습니다. 브라우저가 자동으로 붙이는 값이라, 웹에서 직접 호출하는 구조라면 따로 지정하지 않아도 채워질 수 있습니다.

무엇에 쓰이나

• 사용 기록에 남아 요청의 출처를 추적할 수 있습니다.
• GET /api/v1/generation 응답에서 본인이 직접 확인할 수 있습니다.
• 오류를 문의할 때 어느 앱에서 난 문제인지 특정하는 근거가 됩니다.

curl -s "https://openrouter.myip.co.kr/api/v1/generation?id=$GEN_ID" \
  -H "Authorization: Bearer $MYIP_API_KEY" | jq '{origin, http_referer, user_agent}'

{
  "origin": "https://example.com",
  "http_referer": "https://example.com",
  "user_agent": "OpenAI/Python 1.x"
}

공개되지 않습니다

이 헤더로 밝힌 앱 이름과 URL은 다른 사용자에게 보이지 않습니다. 공개 앱 랭킹에 자동으로 올라가지도 않습니다. 어디까지나 본인 계정의 사용 기록을 정리하기 위한 값입니다.

사이트의 Apps 페이지에 나오는 순위표는 외부에서 가져온 별도 데이터이며, 여러분이 보낸 헤더와는 아무 관계가 없습니다.

끄는 방법

/settings/privacy 의 요청 메타데이터 토글을 끄면 HTTP-Referer, X-Title, User-Agent 가 사용 기록에 남지 않습니다. 기본값은 켜짐입니다.

끄더라도 토큰 수·비용·모델·시각은 그대로 기록됩니다. 청구를 하려면 필요한 값들이기 때문입니다. 자세한 내용은 데이터 수집 을 보세요.

업스트림으로 전달되지 않습니다

HTTP-Referer 와 X-Title 은 우리 사용 기록에만 남고 외부 provider 로 넘기지 않습니다. 앱 이름에 내부 시스템 이름이 들어가 있어도 제3자에게 노출되지 않습니다. 다만 이 값들은 우리 데이터베이스에 저장되므로, 그 자체가 민감한 정보라면 위 토글을 끄거나 값을 일반화하세요.

실무 팁

• 환경을 구분하세요 — X-Title: My App (staging) 처럼 붙이면 개발 트래픽과 운영 트래픽이 섞이지 않습니다.
• Referer 는 URL 형태로 — 스킴과 호스트를 갖춘 값을 넣으세요. 자유 문구는 제목 헤더 쪽에 넣습니다.
• 키를 나누는 편이 더 확실합니다 — 앱마다 API 키를 따로 발급하면 GET /api/v1/key 로 앱별 사용액과 한도를 직접 관리할 수 있습니다. 키별 한도는 사용 한도와 402 를 보세요.

관련 문서

• 인증
• 데이터 수집
• 사용 한도와 402
• 자주 묻는 질문