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.

​
빠른 시작

​
1단계: 회원가입 & API 키 발급

  1. K-Router 대시보드에 로그인합니다.
  2. API Keys 메뉴에서 새 키를 생성합니다.
  3. kr- 로 시작하는 API 키를 안전하게 보관하세요.

​
2단계: 결제

대시보드에서 결제하여 사용 한도를 확보합니다. 계좌이체 또는 무통장입금을 지원합니다.

​
3단계: API 호출

from openai import OpenAI

client = OpenAI(
    api_key="kr-your-api-key",
    base_url="https://api.k-router.com/v1"
)

response = client.chat.completions.create(
    model="kr/gpt54",
    messages=[{"role": "user", "content": "안녕하세요"}]
)
print(response.choices[0].message.content)

​
3가지 마이그레이션 경로

K-Router는 OpenAI, Anthropic, Google 3사 SDK를 모두 지원합니다. 사용 중인 SDK에 맞춰 최소한의 코드만 변경하세요.

​
OpenAI SDK 사용자 — 2줄 변경

기존 OpenAI SDK 코드에서 api_key와 base_url만 변경하면 됩니다. 
# Before
from openai import OpenAI
client = OpenAI(api_key="sk-...")

# After — 2줄만 변경
from openai import OpenAI
client = OpenAI(
    api_key="kr-your-api-key",
    base_url="https://api.k-router.com/v1"
)

# 나머지 코드는 그대로!
response = client.chat.completions.create(
    model="kr/gpt54",
    messages=[{"role": "user", "content": "안녕하세요"}]
)

​
Anthropic SDK 사용자 — 2줄 변경

Anthropic SDK도 api_key와 base_url만 변경하면 됩니다.
Anthropic SDK는 base_url에 /v1을 붙이지 마세요. SDK가 자동으로 /v1/messages 경로를 추가합니다.
# Before
from anthropic import Anthropic
client = Anthropic(api_key="sk-ant-...")

# After — 2줄만 변경
from anthropic import Anthropic
client = Anthropic(
    api_key="kr-your-api-key",
    base_url="https://api.k-router.com"  # /v1 없이!
)

# 나머지 코드는 그대로!
response = client.messages.create(
    model="kr/claude-sonnet-46",
    max_tokens=1024,
    messages=[{"role": "user", "content": "안녕하세요"}]
)
print(response.content[0].text)

​
Google SDK 사용자 — OpenAI SDK로 3줄 전환 (권장)

Google Gemini 모델을 사용하려면 OpenAI SDK로 전환하는 것을 권장합니다. pip install openai 후 3줄만 작성하면 됩니다. 
# Before (Google SDK)
from google import genai
client = genai.Client(api_key="AIza...")
response = client.models.generate_content(model="gemini-2.5-pro", contents="안녕")

# After (OpenAI SDK로 전환 — 같은 Gemini 모델 사용)
from openai import OpenAI
client = OpenAI(api_key="kr-your-api-key", base_url="https://api.k-router.com/v1")
response = client.chat.completions.create(
    model="kr/gemini-25-pro",
    messages=[{"role": "user", "content": "안녕"}]
)
print(response.choices[0].message.content)
Google genai 라이브러리의 base_url 커스텀을 통해 네이티브 SDK도 사용할 수 있습니다.
from google import genai

client = genai.Client(
    api_key="kr-your-api-key",
    http_options=genai.types.HttpOptions(
        api_version="v1beta",
        base_url="https://api.k-router.com"
    )
)

response = client.models.generate_content(
    model="kr/gemini-25-pro",
    contents="안녕하세요"
)
단, OpenAI SDK로 전환하는 것이 더 간단하고 업계 표준에 가까우므로 위의 방법을 권장합니다.
모든 모델을 하나의 키로. 어떤 SDK를 사용하든 kr- API 키 하나면 OpenAI, Anthropic, Google 모델을 모두 사용할 수 있습니다. 자세한 전환 가이드는 SDK 마이그레이션 페이지를 참고하세요.