API 키
모든 API 요청은 API 키를 사용한 인증이 필요합니다. Authorization 헤더에 키를 포함하세요:
Authorization: Bearer sk-your-api-key
API 키 발급받기
- LemonData 대시보드에 로그인합니다
- API Keys 섹션으로 이동합니다
- Create New Key를 클릭합니다
- 키에 식별 가능한 이름을 지정합니다
- 키를 즉시 복사하세요 - 한 번만 표시됩니다
보안 권장 사항:
- 클라이언트 측 코드에 API 키를 노출하지 마세요
- 버전 관리 시스템에 키를 커밋하지 마세요
- 환경 변수를 사용하여 키를 저장하세요
- 주기적으로 키를 교체(Rotate)하세요
- 사용하지 않는 키는 삭제하세요
API 키 사용하기
curl https://api.lemondata.cc/v1/chat/completions \
-H "Authorization: Bearer $LEMONDATA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "gpt-4o", "messages": [{"role": "user", "content": "Hello!"}]}'
API 키 기능
사용량 제한
지출을 제어하기 위해 각 API 키에 사용량 제한을 설정할 수 있습니다:
| 설정 | 설명 |
|---|
| 제한 없음 | 키가 제한 없이 계정 잔액을 사용합니다 |
| 고정 제한 | 지정된 금액에 도달하면 키 작동이 중지됩니다 |
키 접두사
모든 LemonData API 키는 sk- 접두사로 시작합니다. 키 형식은 다음과 같습니다:
sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Anthropic API 호환성
/v1/messages 엔드포인트의 경우, x-api-key 헤더(Anthropic SDK 호환)를 사용할 수 있습니다:
curl https://api.lemondata.cc/v1/messages \
-H "x-api-key: sk-your-api-key" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-5",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Hello!"}]
}'
x-api-key 헤더는 /v1/messages 및 /v1/messages/count_tokens 엔드포인트에서만 지원됩니다. 다른 엔드포인트는 Authorization: Bearer 헤더가 필요합니다.
오류 응답
| 상태 코드 | 유형 | 코드 | 설명 |
|---|
| 401 | invalid_request_error | invalid_api_key | API 키가 누락되었거나 유효하지 않음 |
| 401 | invalid_request_error | expired_api_key | API 키가 취소됨 |
| 402 | insufficient_quota | insufficient_quota | 계정 잔액이 부족함 |
| 402 | insufficient_quota | quota_exceeded | API 키 사용량 제한에 도달함 |
{
"error": {
"message": "Invalid API key provided",
"type": "invalid_api_key",
"code": "invalid_api_key"
}
}
