Gemini 음성을 스트리밍으로 바꿨다면 WAV 저장 방식도 확인하세요

한 장의 그림으로 이해하기

개념 비유입니다. 포장된 소리 꾸러미는 헤더가 있는 WAV 파일, 포장 없이 연속으로 오는 소리 조각은 기본 스트리밍 PCM에 대응합니다. 상자는 파일 형식의 비유이며 실제 음성 파일 구조를 그대로 재현하지 않습니다. WAV 안에도 PCM 데이터가 들어갈 수 있습니다. 그림은 기본값 비교이며 명시적 출력 형식 설정은 별도입니다.
내용의 흐름을 표현한 설명용 그림입니다. 실제 제품 화면이나 실행 결과가 아닙니다.
그림 크게 보기 ↗ (새 탭)

이미지·영상·음성 · 판정 관망

그림을 글로 풀면

받는 방식이 바뀌면 형식 확인

일괄 응답의 저장 코드를 스트리밍에 그대로 쓰면 파일을 잘못 만들 수 있습니다.

대상
Gemini 음성 파일을 저장하는 개발자
무엇이 바뀜
일괄 요청과 스트리밍의 기본 출력 형식이 다릅니다.
왜 중요한가
파일 확장자만 바꿔도 재생 가능한 형식이 되지는 않습니다.
지금 할 일
요청 설정과 응답 형식을 함께 확인하세요.
한계·미확인
개념 비유. 음성 합성·저장·재생 시험 미실행.
공식 출처
aistudio.google.com
확인일
2026-11-18

전송 설정 변경을 저장 코드와 함께 검토하기

가상의 안내 음성 서비스가 첫 소리를 빨리 재생하려고 스트리밍을 켰다고 가정합니다. AINOW는 요청 설정을 바꾸는 변경 목록에 저장 처리도 넣도록 제안합니다. 데이터가 도착했다는 사실과 사용자가 재생할 파일이 완성됐다는 사실을 따로 기록하세요.

공식 문서가 설명하는 기본값

Gemini 3.8 TTS 문서는 일괄 요청이 RIFF 헤더를 포함한 WAV를 기본으로 반환한다고 설명합니다. 반면 스트리밍의 기본값은 헤더 없는 Linear PCM 조각입니다. 두 경우 모두 기본 음성 조건은 24kHz, 모노, 16비트 signed little-endian PCM입니다. WAV는 포장 형식이고 PCM은 소리 표본 표현이므로 서로 완전히 다른 음성 코덱이라고 이해하면 안 됩니다.

명시적 설정과 실제 결과를 대조하기

출력 mime_type과 sample_rate를 지정하면 기본값과 달라질 수 있습니다. AINOW의 점검 제안은 요청의 stream·출력 설정, 응답의 형식, 저장할 컨테이너를 나란히 적는 것입니다. 완성 WAV에 헤더를 다시 붙이거나 원시 PCM 조각에 파일 이름만 붙이는 처리를 피하고, 실제 파일의 재생 결과를 확인하세요. 이 글에서는 API 호출이나 파일 변환·청취 시험을 하지 않았습니다.

참고 원문: Google Gemini 공식 TTS 문서 — Audio output formats · 원문 게시일 상시 문서·게시일 미표기 · 확인일 2026-11-18

AI 작성·자동 검증: 공식 자료와의 대조 및 게시 구조 검사. 사람의 개별 검수와 제품 실행 시험은 수행하지 않았습니다. 그림은 신규 생성한 개념 일러스트입니다.

이 글의 검증 카드

자료 버전
2026-11-18 공식 문서 확인; 확인일은 출시일이 아님. API 및 결과 시험 미실행
확인일
2026-11-18
검증 상태
개발자 주장
한계·주의
개념 비유. 음성 합성·저장·재생 시험 미실행.

함께 더 정확하게

질문·오류 제보

그림에서 이해되지 않는 부분이나 달라진 내용을 알려 주세요. 관리자가 확인하고 승인한 글만 공개됩니다.

공개된 질문·제보

    아직 공개된 질문·제보가 없습니다. 궁금한 부분을 먼저 남겨 주세요.