Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.k-router.com/llms.txt

Use this file to discover all available pages before exploring further.

인증

K-Router는 하나의 kr- API 키로 OpenAI, Anthropic, Google 3사 SDK를 모두 지원합니다. 어떤 SDK를 사용하든 동일한 키로 인증됩니다.

API 키 발급

  1. 대시보드API Keys 메뉴로 이동합니다.
  2. 새 키 생성 버튼을 클릭합니다.
  3. 키 이름을 입력하고 생성합니다.
API 키는 생성 시 한 번만 표시됩니다. 반드시 안전한 곳에 저장하세요.

키 형식

모든 K-Router API 키는 kr- 접두사로 시작합니다.
kr-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

SDK별 인증 방식

K-Router는 3가지 인증 헤더를 모두 인식합니다. 사용하는 SDK에 따라 자동으로 적절한 헤더가 전송됩니다.
SDK헤더 형식비고
OpenAIAuthorization: Bearer kr-...OpenAI SDK 기본 방식
Anthropicx-api-key: kr-...Anthropic SDK 기본 방식
Googlex-goog-api-key: kr-... 또는 ?key=kr-...Google SDK 기본 방식
어떤 SDK를 사용하든 kr- 키 하나로 인증됩니다. SDK가 전송하는 헤더 형식에 관계없이 K-Router가 자동으로 인식합니다.

OpenAI SDK

from openai import OpenAI
client = OpenAI(
    api_key="kr-your-api-key",  # Authorization: Bearer 헤더로 전송
    base_url="https://api.k-router.com/v1"
)

Anthropic SDK

from anthropic import Anthropic
client = Anthropic(
    api_key="kr-your-api-key",  # x-api-key 헤더로 전송
    base_url="https://api.k-router.com"  # /v1 없이!
)

cURL (직접 호출)

# 아래 3가지 모두 동일하게 동작합니다
curl -H "Authorization: Bearer kr-your-api-key" ...
curl -H "x-api-key: kr-your-api-key" ...
curl -H "x-goog-api-key: kr-your-api-key" ...

키 관리

  • 대시보드에서 키를 비활성화하거나 삭제할 수 있습니다.
  • 키가 유출된 경우 즉시 삭제하고 새로 발급하세요.
  • 키별 사용량을 대시보드에서 확인할 수 있습니다.

보안 권장사항

  • API 키를 코드에 직접 하드코딩하지 마세요. 환경 변수를 사용하세요.
  • 키를 Git 저장소에 커밋하지 마세요.
  • 프로덕션과 개발 환경에 별도의 키를 사용하세요.