# 누가 말했는지 나눠 주는 화자 인식 API

> 화자 인식 API에 diarize=true를 더해 보세요. 영상 링크와 파일의 발언을 Speaker 1, Speaker 2로 나눠 JSON, 텍스트, SRT, VTT에 담아요. 추가 요금은 없어요.

Canonical: https://transcript1.com/ko/features/hwaja-insik-api
Language: ko
Last updated: 2026-10-19

화자 인식 API로 인터뷰나 회의 녹음의 발언을 나눠 보세요. diarize: true를 넣으면 각 구간에 Speaker 1, Speaker 2 같은 라벨이 붙어요. 실명을 알아내는 기능이 아니라, 녹음 안에서 목소리를 구분하는 화자 분리 기능이에요.

- 구간마다 Speaker 1, Speaker 2로 구분
- JSON, 텍스트, SRT, VTT에 화자 표시
- 지원 영상 링크와 업로드 파일 모두 가능

## 목소리를 나누고 대화 정리하기

### 옵션 하나로 화자 분리

diarize의 기본값은 false예요. POST /v1/transcriptions에 true로 보내거나 MCP의 transcribe에 diarize를 넣으세요.

### 자막 대신 음성으로 구분

화자 분리에는 AI 텍스트 변환이 필요해요. source=auto라도 diarize: true를 넣으면 자막을 건너뛰고 음성으로 변환해요.

### 원하는 형식에 화자 표시

JSON에는 transcript.speakers와 구간별 speaker가 있어요. 텍스트와 SRT에는 Speaker 1: 같은 접두사가, VTT에는 화자 태그가 붙어요.

### 단어별 화자도 확인

JSON을 읽을 때 include=words를 붙이면 단어별 타임스탬프와 화자를 함께 받아요.

### 맞지 않는 옵션은 오류로 안내

source: captions와 diarize: true는 함께 쓸 수 없어요. 둘 중 하나를 무시하는 대신 422 invalid_request를 돌려줘요.

## 화자별 텍스트 변환이 필요할 때만 켜기

JSON 본문에 diarize: true를 넣으세요. 파일을 올릴 때는 같은 옵션을 폼 필드로 보내면 돼요. 가능한 source 조합은 [diarize 문서](https://transcript1.com/ko/docs/sources-and-options#diarize)에서 확인하세요.

인터뷰, 패널 토론, 진행자와 게스트의 대화처럼 누가 말했는지가 중요할 때 켜세요. 혼자 녹음한 음성 메모에는 없어도 되는 경우가 많아요. 라벨로 실명이나 계정을 알아내거나 목소리를 인증할 수는 없어요.

화자 분리는 변환을 시작할 때 골라야 해요. 완료 후 다운로드 형식을 바꾸는 것과는 달라요. source=auto에서는 자막 대신 음성으로 변환하고, 업로드 파일은 원래부터 AI로 음성을 텍스트로 바꿔요.

### 화자 분리를 켠 파일 업로드

```
curl -X POST "https://api.transcript1.com/v1/transcriptions?wait=60" \
  -H "Authorization: Bearer $TRANSCRIPT1_API_KEY" \
  -F file=@panel.m4a \
  -F diarize=true
```

## 구간별 speaker로 대화 화면 만들기

transcript.speakers에는 화자 라벨 목록이, 각 구간에는 speaker가 들어 있어요. 자막에는 화자 정보가 없어서 transcript_source는 speech_to_text예요. [응답 객체 문서](https://transcript1.com/ko/docs/api-reference#the-transcription-object)를 보고 앱에 연결하세요.

녹음을 들으며 Speaker 1과 Speaker 2가 누구인지 확인한 뒤 앱이나 편집본에 이름을 연결하세요. 다른 녹음의 Speaker 1은 같은 사람이라는 뜻이 아니에요. 녹음마다 새로 확인해야 해요.

구간별 speaker로 발언을 나누고, 더 세밀한 시간이 필요하면 include=words를 쓰세요. 표시 형식을 바꾸더라도 시작·종료 시간은 남겨 두면 원본을 다시 확인하기 좋아요. 아래 JSON은 구조를 설명하는 예시예요.

### 화자가 포함된 JSON 예시(일부)

```
{
  "status": "completed",
  "transcript_source": "speech_to_text",
  "transcript": {
    "speakers": ["Speaker 1", "Speaker 2"],
    "segments": [
      { "start": 0, "end": 3.4, "speaker": "Speaker 1", "language": "en", "text": "Good morning." },
      { "start": 3.4, "end": 7.9, "speaker": "Speaker 2", "language": "en", "text": "Thanks for having me." }
    ]
  }
}
```

## 자막에 화자 이름이 어떻게 보이는지 확인하기

format=srt는 자막 앞에 Speaker 1:을 붙이고, format=vtt는 화자 태그를 넣어요. format=text는 구간마다 화자를 붙인 한 줄을 돌려줘요. 플레이어에 맞는 형식은 [SRT·VTT 안내](https://transcript1.com/ko/features/srt-pail-mandeulgi)를 참고하세요.

사용할 플레이어에서 VTT 화자 태그를 어떻게 표시하는지, 편집기가 SRT 접두사를 어떻게 다루는지 확인하세요. 녹취록에서는 유용한 라벨도 모든 자막에 반복되면 거슬릴 수 있어요. 자막 파일이나 앱에서 표현을 다듬되 원래 라벨과의 연결은 남겨 두세요.

말이 겹치거나 마이크가 멀거나 음악이 크면 단어와 화자 경계가 모두 불확실할 수 있어요. 화자가 갑자기 바뀌는 곳은 다시 들어보세요. 다음 녹음에서는 마이크를 나눠 쓰고 번갈아 말하는 편이 나중에 고치기 쉬워요.

### format=vtt

```
WEBVTT

00:00:00.000 --> 00:00:03.400
<v Speaker 1>Good morning.

00:00:03.400 --> 00:00:07.900
<v Speaker 2>Thanks for having me.
```

## 이름을 붙이기 전에 녹음으로 확인하기

녹음 앞부분의 명확한 대화부터 듣고 라벨과 참여자를 연결해 적어 두세요. 뒤쪽 발언도 골라 들어 같은 구분이 맞는지 확인하세요. 누가 말했는지 들리지 않으면 문맥만 보고 이름을 붙이지 마세요.

[연구 인터뷰](https://transcript1.com/ko/use-cases/inteobyu-nokchwirok-jakseong)는 여러 회차에 같은 검토 기준을 적용하세요. 공개할 인용문이라면 녹음과 확인 가능한 맥락으로 이름을 검증하세요. 참여자 정보와 메모는 실제 발언과 구분해 두세요.

화자 분리 받아쓰기는 생체 인식이나 본인 인증이 아니에요. 같은 사람도 마이크를 바꾸면 다르게 들릴 수 있고, 겹친 발언은 한 구간에 한 명씩 나뉘지 않을 수 있어요. 서로 다른 녹음에 같은 사람이 등장한다고 판단하는 데 쓰지 마세요.

| 검토 중 발견한 상황 | 확인할 내용 |
| --- | --- |
| 한 사람이 말하는 중 라벨이 바뀜 | 경계 앞뒤를 듣고 필요하면 편집본을 고치세요. |
| 여러 사람이 동시에 말함 | 단어와 화자를 함께 확인하고, 불분명한 부분은 그대로 표시하세요. |
| 다른 녹음에도 같은 라벨이 있음 | 그 녹음의 참여자를 새로 확인해 연결하세요. |

## 자주 묻는 질문

### 화자 이름은 어떻게 붙나요?

Speaker 1, Speaker 2처럼 붙어요. 실제 이름은 알 수 없어요. 녹음을 확인한 뒤 앱에서 라벨과 사람을 연결하세요.

### YouTube 자막에서도 화자를 나눌 수 있나요?

자막에는 화자 정보가 없어요. source=auto에서 diarize: true를 켜면 자막 대신 AI 텍스트 변환을 써요. source: captions와 diarize: true를 함께 보내면 오류가 나요.

### 화자를 나누면 요금이 더 드나요?

아니요. diarize를 켜도 오디오 1분당 1크레딧이에요. 녹음 길이를 분 단위로 올림해 계산해요.

## 함께 보면 좋은 페이지

- [인터뷰와 질적 연구](https://transcript1.com/ko/use-cases/inteobyu-nokchwirok-jakseong)
- [타임스탬프와 자막](https://transcript1.com/ko/features/srt-pail-mandeulgi)
- [지원 링크와 변환 옵션 (문서)](https://transcript1.com/ko/docs/sources-and-options)