SEALO API 문서

사용자가 직접 쓴 한국어 글에서 말투(관찰·말투 항목 후보·안 쓰는 표현)를 추출합니다. 모든 관찰·항목에는 입력 원문에서 그대로 복사한 근거 인용이 붙고, 근거가 원문에 실재하지 않으면 서버가 해당 항목을 드롭합니다(생성 금지 게이트) — 응답의 dropped가 그 개수입니다.

내부적으로 복수의 추출 엔진을 정해진 순서로 시도하고, 앞선 엔진이 실패(미설정·오류·응답 파싱 실패)하면 다음으로 넘어갑니다. 생성 금지 게이트는 어느 엔진이 응답했든 동일하게 적용되므로 응답 형식과 생성 금지 게이트는 엔진에 무관하게 동일합니다 — 어느 엔진이 실제로 응답했는지는 클라이언트에 노출하지 않습니다.

요청 본문

요청 예시

curl -sS -X POST https://sealo-site.vercel.app/api/style-extract \
  -H "Content-Type: application/json" \
  -d '{"text":"여기에 80자 이상의 직접 쓴 글을 넣습니다..."}'

응답 (200)

응답 예시

{
  "observations": [
    { "title": "한 문장에 한 가지 사실만 담아 짧게 끊어 씀",
      "evidence": "그래서 매번 처음부터 다시 씁니다." }
  ],
  "rules": [
    { "rule": "문장은 짧게 끊는다",
      "why": "글 전체가 단문 위주로 구성되어 있고, 본인이 그 습관을 명시적으로 드러낸다",
      "evidence": "문장도 짧게 끊어 쓰는 편인데 AI는 자꾸 길게 늘여 씁니다." }
  ],
  "avoids": [],
  "dropped": 0
}

에러

AI 초안을 사용자의 말투 항목으로 문장 단위로 다시 씁니다. 의미·주장·수치는 바꾸지 않고 말투만 바꿉니다. 바뀐 문장에 원문에 없던 숫자가 생기면 서버가 그 문장을 원문으로 되돌립니다(생성 금지 게이트, reverted_count). 조직 모드(mode:"org")에서는 회사 문서가 아직 0건이므로 수치·비교·전망 문장을 blank:true로 표시합니다 — 근거 없으면 비웁니다. 초안·결과는 저장되지 않습니다.

요청 본문

요청 예시

curl -sS -X POST https://sealo-site.vercel.app/api/rewrite \
  -H "Content-Type: application/json" \
  -d '{"draft":"저희 팀은 남다른 방식으로 문제를 풉니다. 시장은 앞으로도 계속 성장할 전망입니다.",
       "rules":[{"id":1,"rule":"결론을 첫 문장에 둔다"},{"id":2,"rule":"숫자엔 단위를 붙인다"}],
       "mode":"personal"}'

응답 (200)

에러

이미 /api/rewrite로 다시 쓴 문장 목록을 5단 리포트 구조(한 줄 결론·핵심 3·본문 소제목·숫자·다음 할 일)로 재배열합니다. 새 내용을 만들지 않습니다 — 입력 문장을 고르고 순서만 바꿉니다. 각 항목은 입력 문장 중 하나를 그대로 인용한 evidence가 있어야 채택되고, 없으면 서버가 드롭합니다(생성 금지 게이트).

요청 본문

응답 (200)

에러

사용자가 확정한 말투 항목을 프로필로 저장합니다. 원문은 저장하지 않습니다 — materials에는 재료 출처와 글자 수만 남습니다(확정 9). 소유권 인증이 없는 익명 세션 모델이라 외부 통합용이 아니라 SEALO 웹앱 전용으로 설계됐습니다. 현재 미리보기 화면(/voice)은 이 API를 호출하지 않습니다 — 저장은 대기목록 이후 실서비스에서만.

요청 본문

응답 (200)

{ "profile_id": "uuid", "rules": 4 }

에러

화이트리스트에 있는 이벤트만 기록합니다(확정 7 — 계측은 서버 기록이 정본). 전송 실패가 사용자 경험을 막지 않도록 설계돼 있어, 저장소 미연결 시에도 202로 무해 응답합니다. 화면에서는 data-ev 속성 한 개와 위임 리스너 한 개로 발화합니다. published_as_is는 edit_ratio 0(원래대로·직접 쓰기 0건) 상태에서 복사·내보내기 행동이 있을 때만 셉니다 — 되돌리거나 직접 채운 문장이 있으면 복사해도 세지 않습니다.

허용 이벤트

profile_created · taste_rule_edited · draft_submitted · transform_done · published_as_is · revision_loop

미리보기 화면의 profile_created는 stored:false 속성으로 옵니다 — 내 말투가 만들어진 시점이지 저장이 아닙니다. 서버 저장은 실서비스에서만.

요청 본문

응답