VoiceStudio은(는) 무엇을 하나요?
사용자가 실행 중인 VoiceStudio 백엔드를 사용합니다. 로컬 처리를 우선시하며, 원격 작업자, 클라우드 번역, 모델 다운로드 및 외부 통합은 사용자의 선택이 필요합니다. 설치된 모델은 오프라인에서 실행될 수 있습니다. 모든 구성된 워크플로우가 오프라인이라고 약속하지 마십시오.
연결 및 검색
기본 백엔드는 http://localhost:3900입니다. 사용자가 설정한 주소를 존중하십시오. Electron의 렌더러와 개발 프록시는 별도의 서비스이며, 공개 백엔드 API가 아닙니다.
GET /health를 확인합니다.GET /openapi.json으로 실행 중인 버전의 계약을 검색하고,GET /v1/audio/voices로 음성/엔진을 검색합니다. 프로필 ID를 임의로 만들거나 카탈로그 목록에서 설치된 모델을 유추하지 마십시오.- 사용할 수 없는 경우 설치된 앱을 실행합니다. 기존 소스 체크아웃의 경우, 해당 Electron README를 따릅니다(
bun install,bun run setup:api, 그런 다음 리포지토리 루트에서bun run dev). 두 번째 백엔드를 설치하거나 기존 체크아웃을 덮어쓰지 마십시오. - 로컬 구성은 인증되지 않은 호출을 허용할 수 있습니다. 보호된 배포는 구성된 자격 증명이 필요합니다. 401/403을 인증 비활성화 권한이 아닌 인증 실패로 처리하십시오. 토큰을 출력하거나 자리 표시자 키를 실제 자격 증명인 것처럼 사용하지 마십시오.
음성 생성
voice를 사용자가 선택한 음성의 검색된 프로필 ID로 바꾸어 이 JSON을 speech-request.json에 저장합니다:
{"model":"tts-1","voice":"alloy","input":"모든 목소리에는 이야기가 있습니다. 여러분의 이야기를 들려주세요.","response_format":"wav"}
curl --fail-with-body --show-error http://localhost:3900/v1/audio/speech \
-H 'Content-Type: application/json' --data-binary @speech-request.json \
--output speech.wav
tts-1과 tts-1-hd는 별칭이며, 품질 보장이 아닙니다. OpenAI 음성 이름은 호환성 별칭이며, 해당 제공자의 실제 음성이 아닙니다. 반복 가능한 내레이션을 위해 검색된 저장 음성을 선호하십시오. 결과를 약속하기 전에 설치된 엔진의 언어 및 음성 디자인 기능을 확인하십시오.
출력을 오디오라고 부르기 전에 HTTP 상태를 확인하고 디코드/프로브하십시오. 오류 응답이 출력 경로에 기록될 수 있습니다. 저장된 경로와 실제 지속 시간/형식을 보고하십시오. 성공적인 생성, 전사 또는 작업 완료를 절대 조작하지 마십시오.
전사
curl --fail-with-body --show-error http://localhost:3900/v1/audio/transcriptions \
-F [email protected] -F model=whisper-1 -F response_format=verbose_json
일반 전사에는 json 또는 text, 타임스탬프에는 verbose_json, 실행 중인 스키마에서 지원하는 경우 자막에는 srt/vtt를 사용하십시오. 긴 녹음 전에 전사 모델 준비 상태를 확인하십시오. 누락된 모델을 설명하고 다운로드 권한을 얻으십시오. 무음으로 설치하지 마십시오.
복제, 디자인, 더빙 및 긴 워크플로우
설치된 OpenAPI 스키마를 사용하여 프로필 생성, 참조 업로드, 생성, 더빙 및 긴 형식 작업 작업을 검색하십시오. 이들의 기본 엔드포인트는 OpenAI 호환 API보다 더 넓으며 독립적으로 진화합니다.
- 사용자가 사용할 권한이 있는 음성만 복제하십시오. 참조 파일과 기존 프로필을 보존하십시오.
- 디자인의 경우 요청된 톤, 전달 방식, 언어 및 샘플 텍스트를 캡처하고 엔진 지원을 확인하십시오.
- 더빙의 경우 원본 미디어, 스피커 할당, 세그먼트 타이밍 및 배경 오디오 의도를 유지하십시오. 번역 완료는 렌더링된 더빙 완료가 아닙니다.
- 비동기 작업의 경우 반환된 작업 ID와 문서화된 진행/상태 엔드포인트를 사용하십시오. 터미널 오류를 검사하십시오. 시간 초과된 생성을 맹목적으로 다시 제출하지 마십시오.
- 누락된 모델 또는 사용할 수 없는 기능을 포함하여 사용 가능한 파일과 정직한 제한 사항을 반환하십시오.
MCP 및 자동화
실행 중인 백엔드는 http://localhost:3900/mcp에 MCP 엔드포인트를 마운트합니다. 클라이언트가 지원하는 HTTP 전송을 사용하고 런타임에 도구를 검색하십시오. 다른 서비스를 시작하는 대신 기존 연결을 재사용하십시오. stdio 전용 클라이언트의 경우, 프로젝트의 MCP 가이드를 참조하여 shim을 확인하십시오.
n8n, 호출 에이전트, 컨테이너 또는 다른 호스트의 경우, 해당 환경에서 백엔드 주소에 도달할 수 있도록 만드십시오. 컨테이너 localhost는 컨테이너 자체를 가리킵니다. 인증 및 명시적 원격 라우팅 선택을 그대로 유지하십시오. 통합 디렉토리 목록이 있다고 해서 해당 통합이 연결된 것은 아닙니다.
오류 발생 시 응답 본문을 읽고, 백엔드 사용 불가, 모델 누락, 지원되지 않는 기능, 인증 및 하드웨어 사용 중을 구분하십시오. 보고된 조건을 수정하십시오. 호스트된 제공자로 전환하거나 승인 없이 모델을 다운로드하지 마십시오.
데스크톱 워크플로우 및 준비 상태
Electron 앱에는 음성 복제 및 디자인, 저장된 프로필 및 갤러리, 스토리/오디오북, 더빙 프로젝트, 전사, 도구 및 통합이 포함됩니다. 중복을 생성하는 대신 기존 프로젝트 및 음성 식별자를 선호하십시오. 데스크톱 자동화의 경우 실제 UI와 현재 Settings 바로 가기를 검사하십시오. 바로 가기 바인딩이나 마이크 권한이 모든 호스트에서 동일하다고 가정하지 마십시오.
받아쓰기 전에 설치된 음성-텍스트 모델과 작동하는 입력 장치를 확인하십시오. 녹음, 일시 중지된 녹음, 전사 처리 및 완료된 텍스트를 구분하십시오. 전사 내용을 복사하여 다른 앱에 삽입하는 것은 다른 작업입니다. 입력하기 전에 의도된 대상을 확인하고 가능한 경우 클립보드 내용을 보존하십시오. 전사가 완료되었다고 해서 텍스트가 전달되었다고 보고하지 마십시오.
더빙의 경우, 내보내기 전에 누락/실패한 세그먼트와 타이밍 오버플로를 검사하십시오. 요청 시 음악 및 비음성 오디오를 보존하십시오. 전체 사운드트랙을 조용히 대체하지 마십시오. 소스를 보존하고 출력을 별도의 아티팩트로 만드십시오. 번역 스타일 프롬프트는 선택한 번역 작업에 속하며, 원격 에이전트 번역에는 사용자가 구성한 제공자 선택이 필요합니다.
통합 디렉토리를 검색 및 설정 안내로 사용하되, 작동하는 커넥터의 증거로 사용하지 마십시오. 연결이 준비되었다고 설명하기 전에 실제 자격 증명, 엔드포인트 도달 가능성 및 지원되는 작업을 확인하십시오. 컨테이너 배포에는 영구 데이터 볼륨과 호출 클라이언트가 도달할 수 있는 백엔드 URL이 필요합니다.