단어장 API

TTS API와 연동 가능한 발음 사전 관리

개요

단어장 API를 사용하여 조직별 커스텀 발음 사전을 관리하세요. TTS 요청 시 자동으로 텍스트를 대체하여 정확한 발음을 보장합니다.

조직별 커스텀 발음 사전

TTS 요청 시 자동 텍스트 대체

대소문자 구분 옵션

요금제별 제한

요금제에 따라 생성 가능한 단어장 개수가 제한됩니다.

Plan	단어장 개수	단어장당 항목
무료	0	-
스타터	3	100
프로	10	500
엔터프라이즈	100	1000

API 엔드포인트

https://agitvxptajouhvoatxio.supabase.co/functions/v1/dictionaries-v1

Required Headers

X-API-Key: {YOUR_API_KEY}
Content-Type: application/json

POSThttps://agitvxptajouhvoatxio.supabase.co/functions/v1/dictionaries-v1

새로운 단어장을 생성합니다

// Request Body
{
  "name": "string",          // 단어장 이름 (최대 50자)
  "description": "string",   // 단어장 설명 (선택사항)
  "caseSensitive": boolean   // 대소문자 구분 (기본값: true = 구분함)
}

GEThttps://agitvxptajouhvoatxio.supabase.co/functions/v1/dictionaries-v1

모든 단어장 목록을 조회합니다

// Response
{
  "dictionaries": [
    {
      "id": "uuid",
      "name": "string",
      "description": "string",
      "caseSensitive": boolean
    }
  ]
}

GEThttps://agitvxptajouhvoatxio.supabase.co/functions/v1/dictionaries-v1/{id}

특정 단어장의 상세 정보를 조회합니다

// Response
{
  "id": "uuid",
  "name": "string",
  "description": "string",
  "entries": {
    "sourceText": "targetText"
  },
  "caseSensitive": boolean,
  "createdAt": "datetime",
  "updatedAt": "datetime"
}

PATCHhttps://agitvxptajouhvoatxio.supabase.co/functions/v1/dictionaries-v1/{id}

단어장 정보 및 항목을 업데이트합니다 (모든 필드 선택적, 최소 1개 필수)

{
  "name": "string",         // Optional
  "description": "string",  // Optional
  "caseSensitive": boolean, // Optional
  "entries": {              // Optional - 단어 항목 (키-값 쌍, 전체 교체)
    "sourceText": "targetText",
    "AI": "에이아이",
    "API": "에이피아이"
  }
}

⚠️ 최소 1개 필드 필수

DELETEhttps://agitvxptajouhvoatxio.supabase.co/functions/v1/dictionaries-v1/{id}

단어장을 삭제합니다

TTS API와 연동

DIVE 또는 FRTTS API 요청 시 dictionaryId 파라미터에 단어장 ID를 포함하세요

TTS API Request Body

{
  "text": "AI와 API를 사용한 TTS 테스트",
  "dictionaryId": "{DICTIONARY_ID}",
  // ... other TTS parameters
}

// The text will be automatically replaced:
// "에이아이와 에이피아이를 사용한 티티에스 테스트"