회의 녹음 파일로 회의록 만드는 방법

회의 녹음 파일로 회의록을 만들려면 녹음을 텍스트로 전사한 뒤, 언어 모델이 전사문을 회의록으로 정리하게 하세요. 회의록은 짧은 요약, 내려진 결정, 담당자와 기한이 붙은 액션 아이템으로 이루어집니다. 보내기 전에는 초안을 검토하세요. 녹음 내용을 바탕으로 모델이 쓴 결과물이기 때문입니다. Sume에서는 STT 1.0이 공개 HTTPS 오디오 URL로 전사문을 만들고, Agent Completions가 직접 정의한 형태의 JSON으로 회의록을 반환합니다.

아래 내용은 Sume API 레퍼런스의 STT 1.0 스키마와 Agent Completions, 구조화 출력 (영문), Usage 문서에서 가져왔으며, 모두 2026-09-28에 확인했습니다. 이미 Sume에 있는 영상이라면 API로 영상 요약하기에서 전사문과 스틸로 같은 작업을 합니다.

회의 녹음은 어떻게 전사하나요?

STT 1.0이 가져갈 수 있는 곳에 파일을 두세요. 요청은 업로드가 아니라 공개 HTTPS audio_url을 받습니다. 요청 하나는 최대 10분을 처리하므로, 더 긴 회의는 긴 오디오 파일 전사하기에 나온 것처럼 여러 부분으로 나누세요. language_code를 생략하면 언어를 자동으로 감지합니다.

• 진행 중인 통화가 아니라 끝난 녹음에서 동작합니다. 전사는 URL에 있는 파일을 읽는 Job이며, 현재 Developer API에는 SSE나 WebSocket 전송 방식이 없습니다.
• 결과의 text가 다음 단계로 넘길 전사문입니다. words에는 타이밍이 담기지만 회의록에는 필요 없습니다.

curl -X POST https://api.sume.com/v1/stt-1.0/transcribe \
  -H "Authorization: Bearer $SUME_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: weekly-sync-part-1" \
  -d '{ "audio_url": "https://example.com/audio/weekly-sync-part-1.m4a", "duration_seconds": 600 }'

전사문을 회의록으로 어떻게 바꾸나요?

POST /v1/agent/completions로 보내세요. 작업 내용은 instruction에, 전사문은 input에 넣고(에이전트는 이 값을 지시로 다루지 않고 데이터로만 다룹니다), 회의록의 형태는 output_schema에 넣습니다. generation_spend_cap_usd는 필수이고 기본값이 없으며 0일 수 없습니다. 녹음 파일 자체는 첨부하지 마세요. 현재 completion 첨부는 이미지만 받습니다.

• 여러 부분으로 나눠 전사한 회의라면 각 부분의 text를 순서대로 이어 전사문 하나로 보내세요.
• Sume의 엄격한 스키마 부분집합에는 선택 속성이 없습니다. 모든 속성이 required에 나열되며, 비어 있을 수 있는 필드는 아래의 owner, due처럼 null을 허용합니다. 나머지 규칙은 output_schema 위반 항목 고치기에서 다룹니다.
• API 키에는 agent_completions:write 스코프가 필요합니다. Agent Completions가 나오기 전에 만든 키에는 이 스코프가 없습니다.

curl -X POST https://api.sume.com/v1/agent/completions \
  -H "Authorization: Bearer $SUME_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: weekly-sync-minutes" \
  -d '{
    "instruction": "Write minutes from this meeting transcript. Use only what was said. Leave owner or due null when nobody said one.",
    "input": { "transcript": "Okay, first item is the launch date..." },
    "output_schema": { "name": "acme/meeting-minutes/v1", "schema": {
      "type": "object", "additionalProperties": false,
      "required": ["summary", "decisions", "action_items"],
      "properties": {
        "summary": { "type": "string" },
        "decisions": { "type": "array", "items": { "type": "string" } },
        "action_items": { "type": "array", "items": {
          "type": "object", "additionalProperties": false,
          "required": ["task", "owner", "due"],
          "properties": {
            "task": { "type": "string" },
            "owner": { "type": ["string", "null"] },
            "due": { "type": ["string", "null"] } } } } } } },
    "generation_spend_cap_usd": 1
  }'

액션 아이템의 담당자는 누구인가요?

이름이 나온 사람만 담당자가 됩니다. STT 1.0은 화자 라벨을 반환하지 않으므로 전사문에는 누가 말하는지 나오지 않고, 담당자는 “Dana will send the budget by Friday.”(Dana가 금요일까지 예산안을 보냅니다)처럼 소리 내어 말한 이름에서만 나올 수 있습니다. owner와 due에 null을 허용하고 지시문에도 그렇게 적으면, 모델이 추측하는 대신 비워 둘 수 있습니다. 빈 곳은 검토할 때 채우세요. 사람마다 트랙을 따로 녹음했다면 인터뷰 녹취록 작성법에서 화자 라벨을 붙이는 방법을 보여 줍니다.

회의록은 어떻게 돌려받나요?

생성 호출은 회의록이 아니라 agent.run 영수증과 함께 202를 반환합니다. next_action이 더 이상 poll_status가 아닐 때까지 영수증의 status_url을 폴링하세요. 완료된 실행은 output을 여러분의 summary, decisions, action_items로 채웁니다. 먼저 output_error를 확인하세요. 스키마를 만족하는 것이 없으면 output은 null이며, API에서는 실행이 failed로 끝납니다. 영수증과 웹훅은 백엔드에서 Sume 에이전트 실행하기에서 다룹니다.

비용은 얼마인가요?

60분짜리 회의를 전사하려면 요청이 6번 필요하고 비용은 $0.60이며, 기본적으로 5.5% 에이전트 수수료가 더해집니다. 지출 상한은 에이전트 자체의 모델 턴이 아니라 생성에만 적용되므로, completion의 실제 비용은 사용량 요약에서 확인하세요.