LemonData API는 OpenAI와 호환되므로, 베이스 URL 변경만으로 공식 OpenAI SDK를 사용할 수 있습니다. 또한 네이티브 Anthropic 및 Gemini 요청 형식도 지원합니다.
베이스 URL
모든 API 엔드포인트는 Bearer 토큰을 사용한 인증이 필요합니다:
Authorization: Bearer sk-your-api-key
지원되는 엔드포인트
채팅 및 텍스트 생성
| 엔드포인트 | 메서드 | 설명 |
|---|
/v1/chat/completions | POST | OpenAI 호환 채팅 완성 |
/v1/messages | POST | Anthropic 호환 메시지 API |
/v1/responses | POST | OpenAI Responses API |
임베딩 및 리랭크(Rerank)
| 엔드포인트 | 메서드 | 설명 |
|---|
/v1/embeddings | POST | 텍스트 임베딩 생성 |
/v1/rerank | POST | 문서 리랭크 |
이미지
| 엔드포인트 | 메서드 | 설명 |
|---|
/v1/images/generations | POST | 텍스트로 이미지 생성 |
/v1/images/edits | POST | 이미지 편집 |
오디오
| 엔드포인트 | 메서드 | 설명 |
|---|
/v1/audio/speech | POST | 텍스트 음성 변환 (TTS) |
/v1/audio/transcriptions | POST | 음성 텍스트 변환 (STT) |
비디오
| 엔드포인트 | 메서드 | 설명 |
|---|
/v1/videos/generations | POST | 비디오 생성 작업 생성 |
/v1/videos/generations/{id} | GET | 비디오 작업 상태 조회 |
| 엔드포인트 | 메서드 | 설명 |
|---|
/v1/music/generations | POST | 음악 생성 작업 생성 |
/v1/music/generations/{id} | GET | 음악 작업 상태 조회 |
3D 생성
| 엔드포인트 | 메서드 | 설명 |
|---|
/v1/3d/generations | POST | 3D 모델 생성 작업 생성 |
/v1/3d/generations/{id} | GET | 3D 작업 상태 조회 |
| 엔드포인트 | 메서드 | 설명 |
|---|
/v1/models | GET | 사용 가능한 모든 모델 목록 조회 |
/v1/models/{model} | GET | 특정 모델 정보 조회 |
응답 형식
모든 응답은 일관된 형식을 따릅니다:
성공 응답
{
"id": "chatcmpl-abc123",
"object": "chat.completion",
"created": 1234567890,
"model": "gpt-4o",
"choices": [...],
"usage": {
"prompt_tokens": 10,
"completion_tokens": 20,
"total_tokens": 30
}
}
라우팅 투명성
모든 응답에는 채널 정보가 포함된 _routing 필드가 포함됩니다:
{
"id": "chatcmpl-abc123",
...,
"_routing": {
"channel": {
"id": "ch_xxx",
"name": "channel-name",
"provider": "openai",
"channelType": "PLATFORM"
},
"cached": false,
"retryCount": 0
}
}
| 필드 | 설명 |
|---|
channel.id | 사용된 채널 식별자 |
channel.provider | 업스트림 제공자 (openai, anthropic 등) |
channel.channelType | PLATFORM (LemonData) 또는 PRIVATE (BYOK) |
cached | 응답이 캐시에서 제공되었는지 여부 |
retryCount | 재시도 횟수 (있는 경우) |
오류 응답
{
"error": {
"message": "Invalid API key provided",
"type": "invalid_api_key",
"code": "invalid_api_key"
}
}
속도 제한 (Rate Limits)
속도 제한은 역할 기반이며 관리자가 설정할 수 있습니다. 기본값은 다음과 같습니다:
| 역할 | 분당 요청 수 (Requests/min) |
|---|
| 사용자 | 60 |
| 파트너 | 300 |
| VIP | 1,000 |
| 관리자 | 무제한 |
커스텀 속도 제한은 고객 지원에 문의하세요. 정확한 값은 계정 설정에 따라 다를 수 있습니다.
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 55
X-RateLimit-Reset: 1234567890
OpenAPI 사양
OpenAPI 사양
전체 OpenAPI 3.0 사양 다운로드
