빠른 시작

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

K-Router 대시보드에 로그인합니다.
API Keys 메뉴에서 새 키를 생성합니다.
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)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "kr-your-api-key",
  baseURL: "https://api.k-router.com/v1",
});

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

curl -X POST https://api.k-router.com/v1/chat/completions \
  -H "Authorization: Bearer kr-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kr/gpt54",
    "messages": [{"role": "user", "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": "안녕하세요"}]
)

// Before
const client = new OpenAI({ apiKey: "sk-..." });

// After — 2줄만 변경
const client = new OpenAI({
  apiKey: "kr-your-api-key",
  baseURL: "https://api.k-router.com/v1",
});

# base_url과 Authorization 헤더만 변경
curl -X POST https://api.k-router.com/v1/chat/completions \
  -H "Authorization: Bearer kr-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"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)

// Before
import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic({ apiKey: "sk-ant-..." });

// After — 2줄만 변경
const client = new Anthropic({
  apiKey: "kr-your-api-key",
  baseURL: "https://api.k-router.com",  // /v1 없이!
});

const response = await client.messages.create({
  model: "kr/claude-sonnet-46",
  max_tokens: 1024,
  messages: [{ role: "user", content: "안녕하세요" }],
});

# Anthropic 형식 그대로, 엔드포인트만 변경
curl -X POST https://api.k-router.com/v1/messages \
  -H "x-api-key: kr-your-api-key" \
  -H "Content-Type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "kr/claude-sonnet-46",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "안녕하세요"}]
  }'

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)

// Before (Google SDK)
// const { GoogleGenerativeAI } = require("@google/generative-ai");
// const genAI = new GoogleGenerativeAI("AIza...");

// After (OpenAI SDK로 전환)
import OpenAI from "openai";
const client = new OpenAI({
  apiKey: "kr-your-api-key",
  baseURL: "https://api.k-router.com/v1",
});

const response = await client.chat.completions.create({
  model: "kr/gemini-25-pro",
  messages: [{ role: "user", content: "안녕" }],
});

Google 네이티브 SDK도 사용 가능합니다

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 마이그레이션 페이지를 참고하세요.

​빠른 시작

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

​2단계: 결제

​3단계: API 호출

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

​OpenAI SDK 사용자 — 2줄 변경

​Anthropic SDK 사용자 — 2줄 변경

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

빠른 시작

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

2단계: 결제

3단계: API 호출

3가지 마이그레이션 경로

OpenAI SDK 사용자 — 2줄 변경

Anthropic SDK 사용자 — 2줄 변경

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