키와 API 주소
Markdown키 발급 위치, SDK별 주소 및 키 전달 방법입니다.
전체 가이드
API 키
키는 다음 사이트의 대시보드에서 생성합니다: ailoot.ai — 회원가입 후에 가능합니다. 키 형식: sk-…. 업무 컴퓨터, 서버, 앱마다 별도의 키를 만들 수 있습니다. 다른 키를 건드리지 않고 하나만 폐기하기 편리합니다.
키에 전체 지출 한도, 유효기간, 허용·차단 IP 목록, 5시간·1일·7일 시간 창 지출 한도를 설정할 수 있습니다. 제한에 걸리면 이해하기 쉬운 오류를 받습니다: api_key_quota_exhausted (전체 한도 소진), usage_limit_reached (키 지출 시간 창 소진. 갱신을 기다리거나 한도를 늘리세요), api_key_expired 또는 permission_denied (예: 허용되지 않은 IP의 요청).
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 | 표시된 대로 |
키 전달 방법
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.
환경 변수
변수 하나를 만들어 여러 프로그램의 설정에서 사용하는 것이 편리합니다:
# ~/.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"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-..."
# 변수가 적용되도록 터미널을 다시 시작하세요키 확인
가장 저렴하게 키를 확인하는 방법은 모델 목록을 요청하는 것입니다. 이 요청은 무료입니다.
curl -s https://api.ailoot.ai/v1/models \
-H "Authorization: Bearer $AILOOT_API_KEY"