> ## 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.

# 빠른 시작

> 5분 안에 K-Router API를 사용해보세요

# 빠른 시작

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

1. [K-Router 대시보드](https://k-router.com/dashboard)에 로그인합니다.
2. **API Keys** 메뉴에서 새 키를 생성합니다.
3. `kr-` 로 시작하는 API 키를 안전하게 보관하세요.

## 2단계: 결제

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

## 3단계: API 호출

<CodeGroup>
  ```python Python theme={null}
  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)
  ```

  ```typescript TypeScript theme={null}
  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);
  ```

  ```bash cURL theme={null}
  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": "안녕하세요"}]
    }'
  ```
</CodeGroup>

***

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

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

### OpenAI SDK 사용자 — 2줄 변경

기존 OpenAI SDK 코드에서 `api_key`와 `base_url`만 변경하면 됩니다.

<CodeGroup>
  ```python Python theme={null}
  # 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": "안녕하세요"}]
  )
  ```

  ```typescript TypeScript theme={null}
  // 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",
  });
  ```

  ```bash cURL theme={null}
  # 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": "안녕"}]}'
  ```
</CodeGroup>

### Anthropic SDK 사용자 — 2줄 변경

Anthropic SDK도 `api_key`와 `base_url`만 변경하면 됩니다.

<Warning>
  Anthropic SDK는 `base_url`에 `/v1`을 붙이지 마세요. SDK가 자동으로 `/v1/messages` 경로를 추가합니다.
</Warning>

<CodeGroup>
  ```python Python theme={null}
  # 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)
  ```

  ```typescript TypeScript theme={null}
  // 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: "안녕하세요" }],
  });
  ```

  ```bash cURL theme={null}
  # 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": "안녕하세요"}]
    }'
  ```
</CodeGroup>

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

Google Gemini 모델을 사용하려면 OpenAI SDK로 전환하는 것을 권장합니다. `pip install openai` 후 3줄만 작성하면 됩니다.

<CodeGroup>
  ```python Python theme={null}
  # 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)
  ```

  ```typescript TypeScript theme={null}
  // 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: "안녕" }],
  });
  ```
</CodeGroup>

<Accordion title="Google 네이티브 SDK도 사용 가능합니다">
  Google `genai` 라이브러리의 `base_url` 커스텀을 통해 네이티브 SDK도 사용할 수 있습니다.

  ```python theme={null}
  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로 전환하는 것이 더 간단하고 업계 표준에 가까우므로 위의 방법을 권장합니다.
</Accordion>

<Info>
  **모든 모델을 하나의 키로.** 어떤 SDK를 사용하든 `kr-` API 키 하나면 OpenAI, Anthropic, Google 모델을 모두 사용할 수 있습니다. 자세한 전환 가이드는 [SDK 마이그레이션](/migration) 페이지를 참고하세요.
</Info>