--- title: "실시간 스트리밍 인식 문제" slug: "ai-application-service-clovaspeech-troubleshoot-grpc" updated: 2026-04-23T08:55:40Z published: 2026-04-23T09:02:17Z canonical: "api.ncloud-docs.com/ai-application-service-clovaspeech-troubleshoot-grpc" --- > ## Documentation Index > Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # 실시간 스트리밍 인식 문제 Classic/VPC 환경에서 이용 가능합니다. CLOVA Speech 서비스를 이용하면서 다음과 같은 상황을 겪을 수 있습니다. 질문과 답변을 확인하고 적절하게 조치해 주십시오. ## gRPC 연결 커넥션 관리 방식 안내 gRPC 연결 시 권장되는 커넥션 관리 방법이 있는지 알고 싶습니다. #### 해결 방법 1. 음성 인식 사용이 최종 종료되면, gRPC 연결 커넥션을 종료하는 방식으로 채널 관리를 권장합니다. - 채널 종료는 `channel.shutdown`, `channel.close` 등 일반적인 개발 코드를 활용하면 됩니다. 자세한 참고 예제는 [실시간 스트리밍 인식](/docs/ai-application-service-clovaspeech-example02) 내용을 참조해 주십시오. - 음성 인식 요청이 지속되는 단일 스트림 단위로, 채널 커넥션을 유지하면 됩니다. - <예시> 라이브 방송의 경우, 라이브 방송이 종료되는 시점에 gRPC 커넥션 종료 2. 음성 인식 데이터 송/수신에 따라, timeout 로직을 적용하는 것을 권장합니다. - 송/수신이 없는 상태에서 커넥션을 계속 유지하면 gRPC 채널 획득에 문제가 발생할 수 있습니다. --- ## gRPC 서비스의 Connection Lifetime 제한 여부 gRPC 서비스의 Connection Lifetime(서버와 클라이언트의 연결 지속 시간)에 제한이 있는지 알고 싶습니다. #### 해결 방법 gRPC 서비스는 Connection Lifetime 제한을 100 시간으로 설정하고 있으나 네트워크 문제 등으로 끊김이 발생할 수 있으므로 안정적인 서비스 이용을 위해 retry(재연결) 로직 반영을 권장합니다. --- ## gRPC 서비스 일시 정지 기능 지원 여부 gRPC 서비스에서 일시 정지 기능을 지원하는지 알고 싶습니다. #### 해결 방법 일시 정지 기능은 제공하지 않습니다. 그러나 인식(Recognize) API에서 `extraContents` 필드의 `epFlag` 항목을 `true`로 설정하고 요청을 전송한 뒤, 일정 시간 동안 인식(Recognize) 요청을 하지 않는 방법으로 구현이 가능합니다. `epFlag` 항목에 대한 자세한 설명은 [CLOVA Speech 실시간 스트리밍 API](/docs/ai-application-service-clovaspeech-grpc)를 참조해 주십시오. - `epFlag`를 `true`로 설정하지 않고 인식(Recognize)를 요청하다가 일정 시간 동안 재요청을 하지 않을 경우, 서버 내부에서 설정된 `unvoiceTime`(10초)을 기반으로 버퍼링되어 있는 인식 요청을 처리하여 응답 결과를 표시합니다. --- ## `extraContents` 필드 내 `epFlag`, `seqId` 용도 인식(Recognize) API의 `extraContents` 필드에서 `epFlag`와 `seqId`의 용도를 알고 싶습니다. #### 해결 방법 일시 정지를 목적으로 활용하거나, 보낸 요청에 대한 응답을 다 받았는지 확인하는 용도로 사용할 수 있습니다. --- ## 모든 응답 회신 여부 보낸 요청에 대한 모든 응답을 받았는지 확인하고 싶습니다. #### 해결 방법 인식(Recognize) API를 호출할 때, `extraContents` 필드의 `epFlag`와 `seqId` 항목을 활용할 수 있습니다. `epFlag` 항목을 `true`로 설정하고, `seqId` 항목을 0이 아닌 임의의 값으로 설정한 인식(Recognize) 요청의 처리 결과는 인식(Recognize) 응답의 `epFlag`, `seqId`를 비교함으로써 확인할 수 있습니다. 자세한 설명은 [Recognize 응답](/docs/ai-application-service-clovaspeech-grpc#6-recognize-%EC%9D%91%EB%8B%B5)의 JSON 응답 바디를 참조해 주십시오. --- ## 종료(Close) API 호출 전 `epFlag` 값 `true` 필수 여부 종료(Close) API를 호출하기 전, 인식(Recognize) API의 `extraContents`에 `epFlag` 항목을 반드시 `true`로 설정해야 하는지 알고 싶습니다. #### 해결 방법 반드시 `epFlag` 항목을 `true`로 설정할 필요는 없습니다. 그러나 마지막 인식(Recognize) 요청에 대해 빠른 응답 결과를 받고 싶은 경우 `epFlag` 항목을 `true`로 설정하는 것이 좋습니다. `epFlag` 항목에 대한 자세한 설명은 [CLOVA Speech 실시간 스트리밍 API](/docs/ai-application-service-clovaspeech-grpc)를 참조해 주십시오. --- ## 인식(Recognize) API 음원 데이터 형식 인식(Recognize) API의 음원 데이터 형식에 대해 알고 싶습니다. #### 해결 방법 현재 16 kHz, 1 channel, 16 bits per sample의 PCM (헤더가 없는 raw wave) 형식만 지원합니다.