가이드

Power Automate에서 음성 합성: HTTP 작업과 MP3

Power Automate 흐름은 이미 이메일, Forms 응답, SharePoint 항목, Teams 메시지 같은 텍스트를 다룹니다. 그중 일부를 음성으로 바꾸려면 음성 합성 API 호출 하나와 오디오를 저장하는 단계만 있으면 됩니다.

이 가이드는 HTTP 작업과 SuperClonica 음성 합성 API로 이를 하는 방법을 보여 줍니다.

시작하기 전에

Power Automate의 HTTP 작업은 프리미엄 커넥터이므로 프리미엄 커넥터가 포함된 요금제가 필요합니다. SuperClonica API 키도 필요합니다. Google이나 GitHub로 로그인해 작업 공간의 음성 합성 API 섹션에서 만드세요. 무료 요금제는 하루 1분의 오디오를 줍니다.

HTTP 작업 추가

트리거 뒤에 HTTP 작업을 추가하고 다음처럼 채우세요:

  • 메서드 POST, URI https://superclonica.com/api/v1/speech.
  • 헤더: Authorization = Bearer와 키, Content-Type = application/json. 키는 환경 변수나 Azure Key Vault에 두는 편이 더 좋습니다.
  • 본문: {"text": "[텍스트 동적 콘텐츠]", "voice": "M1", "language": "ko", "format": "mp3"}.

오디오 저장

응답 본문이 MP3 자체입니다. OneDrive나 SharePoint의 "파일 만들기"를 추가하고 .mp3 확장자로 이름을 지정한 뒤 HTTP 작업의 Body를 파일 내용으로 쓰세요. 그다음 흐름에서 이메일에 첨부하거나 Teams에 올리거나 목록 항목에 링크를 넣을 수 있습니다. 항목 ID 같은 값을 Idempotency-Key 헤더에 넣으면 다시 실행해도 같은 텍스트를 두 번 읽지 않습니다.

오류, 제한, 개인정보

HTTP 작업의 재시도 정책이나 실패 시 "다음 이후 실행"을 설정한 범위를 준비하세요. 429는 요금제의 10분 창을 다 썼다는 뜻이고 503은 대기열이 가득 찼다는 뜻이며, 두 응답 모두 Retry-After가 있습니다. 요청 하나는 최대 2만 자입니다. 텍스트는 SuperClonica 서버에서 처리되므로 기밀 문서는 내 컴퓨터의 SuperClonica 엔진으로 읽으세요.