Communitygithub.com

pyai-transcription

제공된 오디오 녹음 파일을 PyAI Hear 음성-텍스트(STT)를 사용하여 텍스트로 변환하며, 비동기 전사 워크플로우를 지원합니다.

pyai-transcription란 무엇인가요?

이 기술(skill)은 PyAI Hear의 음성-텍스트 변환(STT) 기능을 활용하여 오디오 녹음 파일을 텍스트로 변환합니다. 클라이언트는 서버 이름으로 도구 ID에 접두사를 붙일 수 있으며, PyAI가 연결되어 있지 않으면 사용자에게 브라우저 로그인을 안내합니다. 짧은 녹음(최대 8MiB 디코드 기준)은 `transcribe_audio` 도구를 통해 base64 오디오로 직접 전사하고, 더 큰 파일이나 승인된 HTTPS URL에 있는 녹음은 `create_transcription_job`으로 비동기 작업을 생성합니다. 반환된 `job_id`를 보존하고 적절한 간격으로 `get_transcription_job`을 폴링하여 작업 완료, 오류 또는 작업 대기 한계까지 상태를 확인합니다. 대기가 종료되면 실제 ID와 상태를 반환하여 작업을 재개할 수 있도록 하며, 녹음을 재제출하지 않습니다. 최종적으로 제공된 화자 및 타임스탬프 데이터와 함께 전사 결과를 반환합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/atomsai/pyai-plugin/tree/main/skills/pyai-transcription

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

전사(Transcription)

연결된 PyAI 도구 스키마를 진실의 원천으로 사용하세요. 클라이언트는 서버 이름으로 도구 ID에 접두사를 붙일 수 있습니다. PyAI가 연결되어 있지 않으면 사용자를 호스트의 브라우저 로그인으로 안내하세요. 자격 증명을 채팅에 남기지 마세요. 선택한 프로젝트와 사용자의 권한이 부여된 작업을 존중하세요.

도구: whoami, transcribe_audio, create_transcription_job, get_transcription_job, list_transcription_jobs

짧은 제공 녹음의 경우, transcribe_audio를 base64 오디오(디코드 시 최대 8MiB)와 함께 사용하세요. 이미 승인된 HTTPS URL에서 사용 가능한 더 큰 녹음의 경우 create_transcription_job을 사용하세요. 현재 스키마에서 화자 분리, 언어 및 기타 옵션을 확인하고, 계약에 없는 옵션을 약속하지 마세요.

반환된 job_id를 보존하세요. 합리적인 간격으로 get_transcription_job을 폴링하여 완료, 오류 또는 작업의 대기 한계까지 상태를 확인하세요. '대기 중'은 실패가 아닙니다. 대기가 종료되면 실제 ID와 상태를 반환하여 작업을 재개할 수 있도록 하고, 녹음을 다시 제출하지 마세요.

실제로 제공된 전사 결과와 모든 화자 및 타임스탬프 데이터를 반환하세요. 마이크 스트리밍의 경우, https://docs.pyai.com 에 설명된 Hear 스트리밍 API 또는 SDK를 사용하세요. MCP 전사 작업은 실시간 오디오 스트림이 아닙니다.

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

관련 스킬