API 문서

Vivory API v1.0

기본 URL

https://api.vivory.app

인증

api-keyx-api-key 헤더

cookie로그인 쿠키

# API key auth example
curl -H "x-api-key: ak_your_key" https://api.vivory.app/api/v1/text/analyze

API 엔드포인트

크레딧 소비

API 키로 인증하며, 호출당 1크레딧이 소비됩니다 (별도 표시 없으면).

텍스트 분석

텍스트의 문자/단어/문장 수, 언어 감지, 고유 단어 수 등을 분석합니다.

요청 파라미터

textstringrequired분석할 텍스트 (1~50,000자)

응답

char_countnumber문자 수

word_countnumber단어 수

sentence_countnumber문장 수

paragraph_countnumber단락 수

languagestring감지된 언어 (ko/en/mixed/other)

has_koreanboolean한국어 포함 여부

has_englishboolean영어 포함 여부

unique_wordsnumber고유 단어 수

avg_word_lengthnumber평균 단어 길이

credits_usednumber사용된 크레딧

remaining_creditsnumber잔여 크레딧

예시

Request

curl -X POST https://api.vivory.app/api/v1/text/analyze \
  -H "x-api-key: ak_your_key" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello World 안녕하세요"}'

Response

{
  "char_count": 18,
  "word_count": 4,
  "sentence_count": 1,
  "paragraph_count": 1,
  "language": "mixed",
  "has_korean": true,
  "has_english": true,
  "unique_words": 4,
  "avg_word_length": 3.75,
  "credits_used": 1,
  "remaining_credits": 99
}

관리 엔드포인트

무료

로그인 쿠키로 인증하며, 크레딧 소비 없이 키 관리와 크레딧을 관리합니다.

에러 코드

400잘못된 요청 (파라미터 오류)

401유효하지 않은 API 키 또는 만료된 키

402크레딧 부족

429호출 빈도 제한 초과