미르미 › 개발자

미르미 API — 확인된 답을 내 챗봇에

우리 회사 챗봇의 답 엔진을 미르미로 바꾸세요. 답 속 사실을 한국 공식 출처로 문장마다 확인하고, 답이 기댄 법 · 기한 · 공식 안내가 바뀌면 범이 알림이 바뀌기 전에 웹훅으로 알려 드려요.

내 API 키

불러오는 중…

1. 바로 부르기

OpenAI 방식과 같아요. 쓰던 코드에서 주소와 키만 바꾸면 돼요.

curl https://xn--2w2b19bba.com/v1/chat/completions \
  -H "Authorization: Bearer mrm_…" \
  -H "Content-Type: application/json" \
  -d '{"model":"mirmi","messages":[
        {"role":"system","content":"너는 OO부동산 상담 챗봇이다. 존댓말로 짧게."},
        {"role":"user","content":"전세 계약 갱신 요구는 몇 번까지 돼요?"}],
       "user":"customer-123"}'

from openai import OpenAI
client = OpenAI(base_url="https://xn--2w2b19bba.com/v1", api_key="mrm_…")
r = client.chat.completions.create(model="mirmi", messages=[{"role": "user", "content": "올해 최저임금 얼마야?"}])
print(r.choices[0].message.content)
print(r.mirmi)  # 출처 · 확인 결과 · 범이가 지키는 근거

2. 응답에 더 들어 있는 것 — `mirmi`

항목	뜻
`answer_id`	이 답의 번호(범이 알림이 이 번호로 와요)
`sources`	확인에 쓴 출처(공식 기관이 앞)
`checked`	문장 수 · 확인한 사실 · 고친 문장 · 흐린 문장
`watch`	범이가 지키는 근거(예: 주택임대차보호법 제6조의3, 신청 마감일)
`credits_used`	이 답에 쓴 크레딧

user(또는 metadata.conversation_id)에 고객 · 대화 번호를 넣으면 알림에 그대로 돌려드려요 — 누구에게 다시 알려야 할지 바로 알 수 있어요. 개인정보 대신 내부 번호를 넣어 주세요.

3. 범이 알림 받기

위 키 목록에서 웹훅 주소(https)를 넣으면, 매일 아침 확인해서 바뀐 게 있을 때 이렇게 보내요.

POST https://your-server/webhook
Mirmi-Signature: t=1761200000,v1=<HMAC-SHA256(웹훅 비밀, "t.본문") 16진수>
{"type":"watch.alerts","alerts":[{"id":"law_12","kind":"law","answer_id":"ans_345","conversation_id":"customer-123",
  "title":"주택임대차보호법 제6조의3(계약갱신 요구 등)","effective_date":"2027-01-01",
  "summary":"…","fix":"바뀐 법에 맞게 고친 문장","diff":[…]}]}

웹훅 대신 직접 가져가도 돼요: GET /v1/watch/alerts?unseen=1 · 처리했으면 POST /v1/watch/alerts/{id}/ack

4. 카카오톡 챗봇에 붙이기

카카오 i 오픈빌더 → 스킬 → URL에 https://xn--2w2b19bba.com/v1/kakao/skill, 헤더 Authorization: Bearer mrm_…. 답이 확인까지 5초를 넘을 수 있으니 블록 설정에서 AI 챗봇 콜백을 켜 주세요(대기 문구는 #{webhook.text}로 받을 수 있어요). 대화 흐름은 카카오 사용자마다 30분 동안 이어져요.

5. 모델 · 요금

model	성격
`mirmi`	기본 — 빠르게, 문장마다 확인
`mirmi-standard`	알맞게 — 더 찾아보고 답하기
`mirmi-pro`	깊게 — 어렵고 중요한 질문

쓴 만큼 크레딧에서 빠져요(답 하나에 보통 수십 크레딧). 크레딧은 미르미 설정 → 크레딧에서 사요. 크레딧이 60 아래면 402 insufficient_quota를 돌려드려요. 키 하나에 1분 60번까지.

스트리밍("stream": true)도 돼요. 확인하다 이미 보낸 문장을 고치면 마지막 조각의 mirmi.final_text에 고친 전체 글이 와요 — 그 글로 바꿔 보여 주세요.

지켜 주세요

미르미 답은 법률 · 세무 · 의료 전문가의 판단을 대신하지 않아요. 고객에게 AI가 만든 답이라는 것을 알려 주세요(인공지능 기본법). 문의: reamer@d-reamer.com