API Documentation

Authentication

All API requests require an API key. Pass the API key in the Authorization header as a Bearer token.

Authorization: Bearer rs_your_api_key_here

Getting an API Key

Select a plan on the pricing page to receive an API key via email.

Rate Limits

Monthly API call limits apply based on your plan.

Check Usage

{
  "success": true,
  "plan": "free",
  "month": "2025-12",
  "used": 150,
  "limit": 1000,
  "remaining": 850
}

Chat API

대화형 AI 챗봇 API입니다. 커스텀 시스템 프롬프트와 대화 히스토리를 지원합니다.

Request Body

Example

curl -X POST https://resonance-space.net/api/v1/chat \
  -H "Authorization: Bearer rs_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "파이썬으로 피보나치 함수 만들어줘",
    "system_prompt": "당신은 친절한 프로그래밍 튜터입니다."
  }'

Response

{
  "success": true,
  "reply": "네, 파이썬으로 피보나치 함수를 만들어 드릴게요!\n\n```python\ndef fibonacci(n):\n    if n <= 1:\n        return n\n    return fibonacci(n-1) + fibonacci(n-2)\n```",
  "usage": {
    "prompt_tokens": 45,
    "completion_tokens": 89,
    "total_tokens": 134
  },
  "remaining_calls": 849
}

Document API

문서 요약, Q&A, 핵심 정보 추출 기능을 제공합니다.

문서 요약

curl -X POST https://resonance-space.net/api/v1/document/summarize \
  -H "Authorization: Bearer rs_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "긴 문서 내용...",
    "length": "short"
  }'

문서 Q&A

정보 추출

Code API

코드 리뷰, 생성, 설명 기능을 제공합니다.

코드 리뷰

curl -X POST https://resonance-space.net/api/v1/code/review \
  -H "Authorization: Bearer rs_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "function add(a, b) { return a + b }",
    "language": "javascript",
    "focus": "all"
  }'

코드 생성

코드 설명

Translation API

고품질 AI 번역 서비스입니다.

curl -X POST https://resonance-space.net/api/v1/translate \
  -H "Authorization: Bearer rs_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "안녕하세요, 반갑습니다.",
    "target": "en",
    "style": "formal"
  }'

Response

{
  "success": true,
  "translation": "Hello, it is a pleasure to meet you.",
  "source": "auto",
  "target": "en",
  "remaining_calls": 848
}

Text Analysis API

감정 분석, 텍스트 분류, 맞춤법 교정 등 텍스트 분석 기능을 제공합니다.

감정/감성 분석

curl -X POST https://resonance-space.net/api/v1/sentiment \
  -H "Authorization: Bearer rs_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "이 제품 정말 좋아요! 완전 추천합니다.",
    "detailed": true
  }'

Response (detailed: true)

{
  "success": true,
  "analysis": {
    "overall_sentiment": "positive",
    "confidence": 0.95,
    "emotions": [
      {"emotion": "기쁨", "score": 0.88},
      {"emotion": "만족", "score": 0.82}
    ],
    "key_phrases": ["정말 좋아요", "완전 추천"]
  },
  "remaining_calls": 847
}

텍스트 분류

curl -X POST https://resonance-space.net/api/v1/classify \
  -H "Authorization: Bearer rs_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "새로운 아이폰 16 출시 소식입니다.",
    "categories": ["기술", "스포츠", "정치", "연예"]
  }'

Response

{
  "success": true,
  "classification": {
    "category": "기술",
    "confidence": 0.94,
    "reasoning": "아이폰은 기술/전자제품 관련 주제입니다."
  },
  "remaining_calls": 846
}

문법/맞춤법 교정

curl -X POST https://resonance-space.net/api/v1/correct \
  -H "Authorization: Bearer rs_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "오늘 날씨가 좋슴니다. 외출하기 조습니다."
  }'

Response

{
  "success": true,
  "correction": {
    "corrected_text": "오늘 날씨가 좋습니다. 외출하기 좋습니다.",
    "changes": [
      {"original": "좋슴니다", "corrected": "좋습니다", "reason": "맞춤법 오류"},
      {"original": "조습니다", "corrected": "좋습니다", "reason": "오타"}
    ],
    "has_errors": true
  },
  "remaining_calls": 845
}

Embedding API

텍스트를 벡터로 변환하고 유사도를 계산합니다. RAG, 검색, 클러스터링 등에 활용할 수 있습니다.

텍스트 임베딩

* text 또는 texts 중 하나는 필수

curl -X POST https://resonance-space.net/api/v1/embedding \
  -H "Authorization: Bearer rs_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "texts": ["안녕하세요", "반갑습니다"]
  }'

Response

{
  "success": true,
  "embeddings": [
    [0.023, -0.012, 0.089, ...],  // 1536 dimensions
    [0.018, -0.009, 0.076, ...]
  ],
  "model": "text-embedding-3-small",
  "dimensions": 1536,
  "remaining_calls": 844
}

텍스트 유사도

* text2 또는 texts 중 하나는 필수

curl -X POST https://resonance-space.net/api/v1/similarity \
  -H "Authorization: Bearer rs_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "text1": "오늘 날씨가 좋네요",
    "texts": ["오늘 하늘이 맑아요", "점심 뭐 먹을까요", "비가 와서 우울해요"]
  }'

Response

{
  "success": true,
  "base_text": "오늘 날씨가 좋네요",
  "similarities": [
    {"index": 0, "text": "오늘 하늘이 맑아요", "similarity": 0.9234},
    {"index": 1, "text": "점심 뭐 먹을까요", "similarity": 0.4521},
    {"index": 2, "text": "비가 와서 우울해요", "similarity": 0.6123}
  ],
  "remaining_calls": 843
}

Vision API

이미지 분석 및 OCR 기능을 제공합니다.

이미지 분석

* image_url 또는 image_base64 중 하나는 필수

curl -X POST https://resonance-space.net/api/v1/vision/analyze \
  -H "Authorization: Bearer rs_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/image.jpg",
    "prompt": "이 이미지에 무엇이 있나요?"
  }'

OCR (텍스트 추출)

Attendance API (근태관리)

AI 기반 근태관리 시스템을 구축할 수 있는 API입니다.

POST /api/v1/attendance/clock

출퇴근 및 휴식 시간을 기록합니다.

curl -X POST https://api.resonance-space.net/api/v1/attendance/clock \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "employee_id": "EMP001",
    "action": "clock_in",
    "location": "서울 강남구",
    "note": "정상 출근"
  }'

GET /api/v1/attendance/records

근태 기록을 조회합니다.

curl "https://api.resonance-space.net/api/v1/attendance/records?employee_id=EMP001&start_date=2024-01-01" \
  -H "Authorization: Bearer YOUR_API_KEY"

POST /api/v1/attendance/report

AI 기반 근태 리포트를 생성합니다.

curl -X POST https://api.resonance-space.net/api/v1/attendance/report \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "employee_id": "EMP001",
    "employee_name": "홍길동",
    "period": "weekly",
    "include_analysis": true
  }'

POST /api/v1/attendance/leave

휴가/휴무를 신청합니다.

curl -X POST https://api.resonance-space.net/api/v1/attendance/leave \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "employee_id": "EMP001",
    "leave_type": "annual",
    "start_date": "2024-01-15",
    "end_date": "2024-01-16",
    "reason": "개인 휴가"
  }'

POST /api/v1/attendance/analyze

AI 기반 근태 패턴을 분석합니다.

curl -X POST https://api.resonance-space.net/api/v1/attendance/analyze \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "employee_id": "EMP001",
    "analysis_type": "pattern"
  }'

NLP & Language API

자연어 처리 및 언어 분석을 위한 API입니다.

Language Detection

POST /api/v1/detect-language

텍스트의 언어를 자동으로 감지합니다.

curl -X POST https://resonance-space.net/api/v1/detect-language \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello, how are you today?",
    "detailed": true
  }'

Keyword Extraction

POST /api/v1/keywords

텍스트에서 핵심 키워드를 추출합니다.

curl -X POST https://resonance-space.net/api/v1/keywords \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "인공지능과 머신러닝은 현대 기술의 핵심입니다.",
    "max_keywords": 5,
    "include_scores": true
  }'

Named Entity Recognition (NER)

POST /api/v1/ner

텍스트에서 인물, 장소, 날짜 등 개체명을 추출합니다.

curl -X POST https://resonance-space.net/api/v1/ner \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "삼성전자 이재용 회장이 서울에서 기자회견을 열었습니다.",
    "entity_types": ["PERSON", "ORGANIZATION", "LOCATION", "DATE"]
  }'

Text Rewriting

POST /api/v1/rewrite

텍스트를 다양한 스타일로 재작성합니다.

curl -X POST https://resonance-space.net/api/v1/rewrite \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "오늘 날씨가 좋네요.",
    "style": "formal",
    "preserve_meaning": true
  }'

Content Moderation

POST /api/v1/moderate

콘텐츠를 검열하고 유해성을 감지합니다.

curl -X POST https://resonance-space.net/api/v1/moderate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "검열할 콘텐츠 내용",
    "strictness": "medium"
  }'

Audio & Tools API

음성 합성 및 유틸리티 API입니다.

Text-to-Speech (TTS)

POST /api/v1/tts

텍스트를 음성으로 변환합니다. MP3 파일을 반환합니다.

curl -X POST https://resonance-space.net/api/v1/tts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "안녕하세요, 반갑습니다.",
    "voice": "alloy",
    "speed": 1.0
  }' --output speech.mp3

Question Generation

POST /api/v1/generate-questions

텍스트 내용을 기반으로 질문을 자동 생성합니다.

curl -X POST https://resonance-space.net/api/v1/generate-questions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "광합성은 식물이 빛 에너지를 화학 에너지로 변환하는 과정입니다.",
    "num_questions": 5,
    "difficulty": "medium"
  }'

Tokenization

POST /api/v1/tokenize

텍스트의 토큰 수 및 통계를 분석합니다.

curl -X POST https://resonance-space.net/api/v1/tokenize \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "인공지능 기술이 발전하고 있습니다."
  }'

응답 필드: estimated_tokens, character_count, word_count, sentence_count, paragraph_count, average_word_length

Error Handling

The API uses standard HTTP status codes.

Error Response Example

{
  "error": "Rate limit exceeded",
  "message": "Monthly usage limit exceeded",
  "usage": 1000,
  "limit": 1000
}