Source: https://ailoot.ai/docs/ko/keys/
Canonical: https://ailoot.ai/docs/ko/keys/
Language: ko

[시작하기](https://ailoot.ai/docs/ko/) 

# 키와 API 주소

[Markdown](https://ailoot.ai/docs/ko/keys/index.md)

키 발급 위치, SDK별 주소 및 키 전달 방법입니다.

## [](https://ailoot.ai/docs/ko/keys/#key)API 키

키는 다음 사이트의 대시보드에서 생성합니다: [ailoot.ai](https://ailoot.ai) — [회원가입](https://ailoot.ai/register) 후에 가능합니다. 키 형식: `sk-…`. 업무 컴퓨터, 서버, 앱마다 별도의 키를 만들 수 있습니다. 다른 키를 건드리지 않고 하나만 폐기하기 편리합니다.

키에 전체 지출 한도, 유효기간, 허용·차단 IP 목록, 5시간·1일·7일 시간 창 지출 한도를 설정할 수 있습니다. 제한에 걸리면 이해하기 쉬운 오류를 받습니다: `api_key_quota_exhausted` (전체 한도 소진), `usage_limit_reached` (키 지출 시간 창 소진. 갱신을 기다리거나 한도를 늘리세요), `api_key_expired` 또는 `permission_denied` (예: 허용되지 않은 IP의 요청).

키를 코드, 저장소, 스크린샷에 공개하지 마세요. 환경 변수 또는 비밀 관리 도구에 저장하세요. 유출되면 대시보드에서 삭제하고 새 키를 만드세요.

## [](https://ailoot.ai/docs/ko/keys/#base-url)API 주소

기본 규칙: OpenAI 호환 클라이언트 주소에는 `/v1`을 포함하고, Anthropic과 Gemini 주소에는 넣지 않습니다.

| 클라이언트 | 기본 주소 | 요청 목적지 |
| --- | --- | --- |
| OpenAI SDK 및 호환 클라이언트 | `https://api.ailoot.ai/v1` | `/v1/chat/completions`, `/v1/responses`, `/v1/embeddings` |
| Anthropic SDK, Claude Code | `https://api.ailoot.ai` | `/v1/messages` |
| Google GenAI SDK, Gemini CLI | `https://api.ailoot.ai` | `/v1beta/models/{model}:generateContent` |
| 전체 주소를 요구하는 클라이언트 | `https://api.ailoot.ai/v1/chat/completions` | 표시된 대로 |

설정 직후 404가 발생했다면 거의 항상 주소 문제입니다. 불필요하게 포함되거나 누락된 경로: `/v1`, 이중 슬래시 또는 `/chat/completions` — 클라이언트가 자동 추가하는 위치에 중복 지정한 경우입니다.

## [](https://ailoot.ai/docs/ko/keys/#auth)키 전달 방법

Ailoot는 다음 세 헤더 중 어느 것으로든 키를 받습니다. 사용 중인 SDK가 보내는 헤더를 그대로 사용하면 됩니다:

| 헤더 | 이 헤더를 사용하는 클라이언트 |
| --- | --- |
| `Authorization: Bearer sk-…` | OpenAI SDK, 대부분의 클라이언트 |
| `x-api-key: sk-…` | Anthropic SDK, ANTHROPIC\_API\_KEY를 사용하는 Claude Code |
| `x-goog-api-key: sk-…` | Google GenAI SDK, Gemini CLI |

다음 경로에서는 `/v1/…` 주소로 전달한 키(`?key=` 또는 `?api_key=`)를 허용하지 않습니다. 요청은 400과 코드 `invalid_request` 을 반환하며 키가 주소로 전달되었다는 메시지가 표시됩니다. 이렇게 하면 키가 로그와 브라우저 방문 기록에 남지 않습니다. 키를 이미 주소로 전달했다면 새 키를 만드는 편이 좋습니다.

Gemini의 다음 경로에서는 `/v1beta/…` Google과의 호환성을 위해 다음 쿼리 매개변수를 허용합니다: `?key=` — 다만 우선순위가 가장 낮으며 헤더보다 나중에 적용됩니다. `?api_key=` 도 이 경로에서는 400으로 거부됩니다. 그래도 다음 헤더로 키를 전달하는 편이 더 안전합니다: `x-goog-api-key`.

## [](https://ailoot.ai/docs/ko/keys/#env)환경 변수

변수 하나를 만들어 여러 프로그램의 설정에서 사용하는 것이 편리합니다:

```bash
# ~/.zshrc 또는 ~/.bashrc
export AILOOT_API_KEY="sk-..."

# 표준 변수 이름을 읽는 프로그램용
export OPENAI_BASE_URL="https://api.ailoot.ai/v1"
export OPENAI_API_KEY="$AILOOT_API_KEY"
export ANTHROPIC_BASE_URL="https://api.ailoot.ai"
export ANTHROPIC_AUTH_TOKEN="$AILOOT_API_KEY"
```

```powershell
setx AILOOT_API_KEY "sk-..."

# 표준 변수 이름을 읽는 프로그램용
setx OPENAI_BASE_URL "https://api.ailoot.ai/v1"
setx OPENAI_API_KEY "sk-..."
setx ANTHROPIC_BASE_URL "https://api.ailoot.ai"
setx ANTHROPIC_AUTH_TOKEN "sk-..."
# 변수가 적용되도록 터미널을 다시 시작하세요
```

## [](https://ailoot.ai/docs/ko/keys/#check)키 확인

가장 저렴하게 키를 확인하는 방법은 모델 목록을 요청하는 것입니다. 이 요청은 무료입니다.

```bash
curl -s https://api.ailoot.ai/v1/models \
  -H "Authorization: Bearer $AILOOT_API_KEY"
```

궁금한 점이 남았나요? Request ID와 설명을 보내 주시면 해결을 도와드리겠습니다.[지원팀에 문의](mailto:support@ailoot.ai)

## Ailoot · 회사와 그 프로젝트 포트폴리오





Ailoot는 축적된 운영 경험, 폭넓은 고객 기반, 안정적인 서비스, 지속적인 KPI 관리를 바탕으로 합니다.





회사와 그 프로젝트 포트폴리오: 수백만 고객, 매월 수십억 규모의 매출.





Ailoot는 이러한 운영 경험을 고객의 제품, 에이전트, 애플리케이션, 자동화에서 AI 기능을 이용할 수 있는 API 접근에 활용합니다.