Communitygithub.com

pyai-narration

PyAI Cast를 사용하여 대본에서 표현력 있게, 지시에 따라 또는 여러 줄로 구성된 내레이션을 생성합니다. 지원되는 음성, 일시 중지 및 감정을 포함합니다.

pyai-narration란 무엇인가요?

이 스킬은 PyAI Cast 도구 모음을 활용하여 사용자가 제공한 대본을 자연스럽고 표현력 있는 내레이션 오디오로 변환합니다. 개발자는 `get_cast_capabilities`를 통해 사용 가능한 음성과 지원되는 연출 방향(일시 중지, 감정 등)을 확인할 수 있으며, `direct_cast_script`를 사용하여 대본을 구조화하고 화자 배정을 유지할 수 있습니다. 요청 시 `preview_cast_line`으로 샘플을 미리 듣거나 `render_cast`로 전체 내레이션을 렌더링할 수 있으며, 비동기 렌더링 작업은 `get_cast_render`로 상태를 폴링하고 완료 시 `get_cast_audio`로 최종 오디오를 반환합니다. 이 스킬은 Claude Code, Cursor, Codex와 같은 AI 에이전트 플랫폼에서 사용하도록 설계되었으며, 불필요한 변형 생성이나 지원되지 않는 옵션 사용을 방지하여 리소스를 효율적으로 사용합니다.

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

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

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

문서

내레이션

연결된 PyAI 도구 스키마를 진실 공급원(source of truth)으로 사용하십시오. 클라이언트는 도구 ID 앞에 서버 이름을 접두사로 추가할 수 있습니다. PyAI가 연결 해제된 경우, 사용자를 호스트의 브라우저 로그인 페이지로 안내하십시오. 자격 증명을 채팅에 남기지 마십시오. 선택한 프로젝트와 사용자의 권한 부여된 작업을 존중하십시오.

도구: whoami, get_cast_capabilities, direct_cast_script, preview_cast_line, render_cast, get_cast_render, get_cast_audio

get_cast_capabilities를 읽어 사용 가능한 음성과 지원되는 연출 방향을 확인하십시오. 필요할 때 direct_cast_script를 사용하여 제공된 대본을 구조화하되, 사용자의 의도된 문구와 화자 배정을 유지하십시오.

요청된 샘플에는 preview_cast_line을 사용하고, 요청된 전체 내레이션에는 render_cast를 사용하십시오. 미디어 생성과 미리보기 모두 사용량을 소비할 수 있습니다. 통합을 시연하기 위해 추가 변형을 생성하지 마십시오.

비동기 렌더링의 경우 원본 작업 ID를 보존하고 get_cast_render를 폴링(polling)하십시오. 보류 중인 작업을 다시 제출하지 마십시오. 완료된 미디어는 get_cast_audio를 통해 검색하고 실제 오디오/링크를 반환하십시오. 작업의 대기 제한에 도달하면 완료되지 않은 렌더링의 ID와 상태를 보고하십시오. 지원되지 않는 감정, 음성 또는 렌더링 옵션을 임의로 생성하지 마십시오.

Individual skills in this repo

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

관련 스킬