API·MCP 안내

무엇을 할 수 있나

여러 AI 가 한 자리에 앉아 판정·검토하는 회의를 API 로 실행합니다. OpenAI 호환이라 익숙한 클라이언트에서 base_url 과 키, 모델 이름만 바꾸면 됩니다.

빠른 시작

마지막 user 메시지가 질문이고, 그 앞 메시지들은 배경 자료가 됩니다. system 메시지는 판단 기준·제약으로 들어갑니다. 키는 Authorization 헤더에 Bearer 로 싣습니다.

https://hiai-meeting.com/v1

curl https://hiai-meeting.com/v1/chat/completions \
  -H "Authorization: Bearer $HIAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "mpm-decide-standard",
  "messages": [
    { "role": "system", "content": "Decide within the confirmed budget." },
    { "role": "user", "content": "Which do we verify first: pricing, demand, or channel?" }
  ],
  "extra_body": {
    "mpm": {
      "answer_shape": "choice",
      "choices": ["Pricing", "Demand", "Channel"]
    }
  }
}'

import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'https://hiai-meeting.com/v1',
  apiKey: process.env.HIAI_API_KEY,
});

const answer = await client.chat.completions.create({
  model: 'mpm-decide-standard',
  messages: [
    { role: 'system', content: 'Decide within the confirmed budget.' },
    { role: 'user', content: 'Which do we verify first: pricing, demand, or channel?' },
  ],
  extra_body: { mpm: { answer_shape: 'choice', choices: ['Pricing', 'Demand', 'Channel'] } },
});

console.log(answer.choices[0].message.content);

키 발급

설정의 API 키 칸에서 개인 키를 받습니다. 발급 응답에 키 원문이 한 번만 나오고, 목록에는 접두 mpm_xxxxxxxx 만 남습니다.

• 설정에서 API 키 발급·관리

과금

API·MCP 호출은 목적과 무관하게 크레딧(Cr)을 차감합니다. 무료 체험이나 1회 무료는 없고, 구독 이용량을 먼저 쓴 뒤 구매 크레딧을 씁니다. 실제 소모가 정산 기준이고 부족하면 준비 단계에서 막힙니다.

• 크레딧 충전·구독 안내

도구별 설정

판정형 회의를 에이전트 안의 MCP 도구로 쓰거나(Claude Code·opencode·Codex), OpenAI 호환 API 로 직접 호출합니다(opencode 공급자·Python SDK). 쓰는 도구를 골라 설정을 그대로 복사하고, 키 자리 표시를 발급받은 개인 키로 바꾸세요.

claude mcp add --transport http hiai https://hiai-meeting.com/v1/mcp \
  --header "Authorization: Bearer <HIAI_API_KEY>"

안내: 이 모델은 판정형입니다 — 요청 1회가 회의 1회이고 수 분 걸립니다. 코딩 에이전트의 본 모델로 쓰려면 에이전트형 프리셋(mpm-agent-standard 등)을 고르세요. 판정만 필요하면 MCP deliberate 도구나 하위 에이전트 모델로 연결하세요.

회의 중 도구 호출(자료 수집)

회의가 근거가 더 필요하면 도구 호출(tool_calls)을 요청하고, 클라이언트가 실행해 결과를 되돌려 보내면 회의가 이어져 판정으로 갑니다. 서버는 도구를 실행하지 않습니다. 보낸 자료는 그 회의의 모든 참가자 근거가 되어 외부 공급자에게 전달됩니다.

판정 스킬 패키지

여러 AI 회의 판정 도구를 알맞은 때에 좋은 질문으로 부르도록 돕는 스킬입니다. 회의를 여는 때와 열지 말아야 할 때, 질문·배경·판단 기준을 쓰는 법, 프리셋·모드·비용 상한 고르기, 비동기 조회와 결과 전달을 담았습니다. 아래 묶음을 내려받아 쓰는 도구에 설치하세요.

• Claude Code 플러그인 (zip)
• Codex 스킬 폴더 (zip)
• opencode 명령·에이전트 (zip)
• Claude.ai 스킬 (zip)

MCP 연결에는 환경변수 HIAI_MCP_URL(엔드포인트)과 HIAI_API_KEY(개인 키)를 씁니다. 프리셋·모드 목록은 스킬에 담지 않고 실행할 때 서버에서 읽습니다. 공개 저장소는 배포 시 확정합니다.

extra_body.mpm 선택값

OpenAI 호환 필드가 아닌 MPM 전용 값은 extra_body.mpm 안에 넣습니다. 전부 선택값이라 생략하면 서버 기본값이 적용됩니다.

answer_shape

답의 모양 — choice(선택지) · score(점수) · yes_no(예·아니오) · free(자유 서술). 기본은 free.

choices

선택지 목록. answer_shape 가 choice 면 판단 대상이 됩니다.

cost_cap_usd

이번 호출의 비용 상한(USD). 넘으면 그 전까지만 진행합니다. 생략하면 서버 기본값.

visibility

private(기본) 또는 public. 기본값은 비공개입니다.

round_cap

진행 라운드 수 상한. 생략하면 모델 프리셋이 정합니다.

max_utterance_length

발언 하나당 글자 수 상한. 생략하면 모델 프리셋이 정합니다.

purpose

discuss · decide · inspect · explore · commentary · explain. 넣으면 프리셋의 목적만 바꾸고 깊이는 model 의 것을 씁니다. 생략하면 model 의 목적, model 도 없으면 answer_shape 에서 서버가 정합니다.

web_search

웹 검색 모드. true 면 검색을 켭니다. 켜면 그만큼 크레딧이 드는 코인 회의가 됩니다. 생략하면 프리셋이 정합니다.

reasoning

추론 모드. true 면 추론을 켭니다. 켜면 크레딧이 드는 코인 회의가 됩니다. 생략하면 프리셋이 정합니다.

evidence

근거 제시 모드. 이용 권한이 있을 때만 켜지고, 없으면 꺼진 채 진행하며 응답의 mpm.preset 에 적습니다. 생략하면 프리셋이 정합니다.

presets

웹 새 회의 창과 같은 전체·모델·페르소나·진행 프리셋을 항목별로 고릅니다. 하나만 고르면 나머지는 그 목적의 표준을 따릅니다.

자세히

프리셋 선택 — whole · model · persona · progress 네 칸. 웹 새 회의 창과 같은 전체/모델/페르소나/진행 프리셋을 항목별로 고릅니다(모델·페르소나 자리별 직접 지정은 없습니다). whole 은 전체 프리셋 id(mpm-…), model 은 모델 배치, persona 는 페르소나 배치, progress 는 진행 프리셋(fast · balanced · deep · independent)입니다. 각 항목에는 그 키 주인이 웹에서 저장한 유저 프리셋 id(my-<scope>-…@v<n>, GET /v1/models 에 함께 나옵니다)도 넣을 수 있고, 남의 프리셋은 거부됩니다. 하나만 고르면 나머지는 그 목적의 표준을 따르고, 값을 하나라도 바꾸면 커스텀으로 표시됩니다.

idempotency_key

같은 요청을 다시 보내도 회의를 새로 만들지 않게 하는 키. 같은 키는 같은 작업을 돌려줍니다.

모델 목록

GET /v1/models 는 목적 × 깊이의 추천 프리셋을 돌려줍니다. 웹 새 회의 창의 「가볍게·표준·심층」과 같고, 이름이 곧 모델 id 라 그대로 model 에 넣으면 됩니다. 고른 프리셋이 참가자 등급·인원·페르소나 배치·라운드·산출물을 정하며, model 을 생략하면 그 목적의 표준 프리셋을 씁니다.

판정형

• mpm-decide-fast
• mpm-decide-standard
• mpm-decide-deep
• mpm-inspect-fast
• mpm-inspect-standard
• mpm-inspect-deep
• mpm-discuss-fast
• mpm-discuss-standard
• mpm-discuss-deep
• mpm-explore-fast
• mpm-explore-standard
• mpm-explore-deep
• mpm-commentary-fast
• mpm-commentary-standard
• mpm-commentary-deep
• mpm-explain-fast
• mpm-explain-standard
• mpm-explain-deep

판정형: 요청 1회 = 회의 1회, 수 분(최대 10분) 걸리고 회의 1회분 크레딧(인원·라운드·모델 등급에 비례)이 듭니다. 코딩 에이전트의 본 모델이 아니라 판정 도구(MCP deliberate)나 하위 에이전트 모델로 쓰세요.

에이전트형

• mpm-agent-fast
• mpm-agent-standard
• mpm-agent-deep

에이전트형: 코딩 에이전트의 본 모델 · 평소 수 초, 필요할 때 회의. 걸음마다 사회자 모델 1회분, 회의를 소집한 걸음은 회의 1회분이 더해집니다.

• mpm-agent-fast — 소집 규칙: 대화당 최대 1회 · 항상 소집: 계획 수립 · 소집 1회 상한 $0.10
• mpm-agent-standard — 소집 규칙: 대화당 최대 2회 · 항상 소집: 계획 수립 · 최종 검토 · 소집 1회 상한 $0.30
• mpm-agent-deep — 소집 규칙: 대화당 최대 4회 · 항상 소집: 계획 수립 · 최종 검토 · 소집 1회 상한 $0.60

상태

진행 상태는 응답의 mpm.status 로 보고, 같은 회의실·같은 저장소라 웹에서 이어 볼 수 있습니다. 스트리밍(stream: true)은 토큰 단위 출력이 아니라 연결을 살려 두려고 하트비트와 진행 상황을 보내는 방식입니다. 회의가 길면 stream: true 를 권장합니다.

created

작업이 접수됐습니다.

running

토론이 진행 중입니다.

awaiting_tools

회의가 클라이언트 도구 결과를 기다립니다 — 응답의 tool_calls 를 실행해 같은 tool_call_id 의 tool 메시지로 되돌려 주세요.

completed

결론까지 도달했습니다.

partial

결론까지 못 가고 부분 완료됐습니다.

blocked

안전 규칙에 막혔습니다 — 응답의 finish_reason 이 content_filter 입니다.

failed

실행이 실패했습니다.

제한·안전

비공개가 기본입니다. 대부·사행성 요청은 거절하고, 법률·투자·의료는 확인 후 진행하되 산출물은 일반 정보로 제한합니다. 개인정보·영업비밀·인증정보가 든 입력은 경고하거나 차단합니다.

이용 정책

• 이용약관
• 개인정보처리방침
• 환불정책