ChatGPT와 Claude용 공식 Youka 앱은 곧 제공될 예정입니다. 그때까지는 이 페이지의
클라이언트를 Youka API 키와 함께 사용하세요.
준비물
- 크레딧이 있는 Youka 계정. MCP 서버는 웹 앱과 동일한 크레딧을 사용합니다. 크레딧 이해하기를 참고하세요.
- Youka API 키. online.youka.io/account의 API keys에서 생성하세요. Authentication을 참고하세요.
어시스턴트 연결하기
- Claude Code
- Cursor
- Codex
- Other clients
터미널에서 아래를 실행하고, 연결되었는지 확인합니다:
YOUR_API_KEY를 본인 키로 바꾸세요:youka: https://mcp.youka.io/mcp (HTTP) - ✔ Connected가 표시되어야 합니다.기본값으로 서버는 현재 폴더에만 추가됩니다. 모든 폴더에서 Youka를 사용하려면 --scope user를 추가하세요.사용해 보기
자연어로 어시스턴트에게 요청하세요. 예:1
업로드
어시스턴트가 Youka에 업로드 링크를 요청하고 파일을 업로드합니다. 업로드는
무료입니다.
2
비용 확인
프로젝트에 필요한 크레딧을 확인하고, 이를 현재 잔액과 비교합니다.
3
프로젝트 생성
Youka가 보컬을 제거하고 가사를 싱크합니다. 몇 분 정도 걸립니다. 어시스턴트가
프로젝트가 준비될 때까지 상태를 확인합니다.
4
편집 또는 내보내기
Youka 편집기에서 프로젝트를 열 수 있는 링크를 받습니다. 비디오 파일을 요청하면
어시스턴트가 내보내기를 수행하고 다운로드 링크를 제공합니다.
어시스턴트가 할 수 있는 일
크레딧 및 안전
- 웹 앱과 동일한 크레딧. 프로젝트 생성, 가사 재싱크, 내보내기 비용은 online.youka.io에서와 동일합니다.
- 비용을 먼저 확인. 크레딧이 부족하면 Youka가 요청을 거부하고 그 사실을 알려줍니다. 과금은 발생하지 않습니다.
- 중복 과금 없음. 타임아웃 후 어시스턴트가 요청을 재시도하더라도, Youka가 재시도를 인식하고 다시 과금하지 않고 원래 결과를 반환합니다.
- 크레딧은 Youka에서 구매. 어시스턴트는 크레딧을 구매할 수 없습니다. 추가하려면 Buy more credits를 참고하세요.
- 유료 도구는 요청할 때만 실행. 사용자가 요청할 때에만 프로젝트 생성, 가사 싱크, 내보내기를 수행하도록 어시스턴트에 안내되어 있습니다.
문제 해결
Not enough credits
Not enough credits
어시스턴트에게 잔액을 물어보거나
online.youka.io에서 확인하세요. 그런 다음 buy more
credits로 크레딧을 추가하고 다시 요청하세요.
The project failed
The project failed
어시스턴트에게 프로젝트를 보여달라고 요청하세요. 오류가 함께 표시됩니다.
파일이 지원되는 오디오 또는 비디오 형식인지, 그리고 계정에 표시된 업로드 제한을
충족하는지 확인하세요.
The lyrics are wrong
The lyrics are wrong
어시스턴트에게 올바른 가사를 알려주고 다시 싱크해 달라고 요청하거나,
편집기 링크를 열어 직접 edit the lyrics하세요. 그런 다음
다시 내보내세요.
관련 문서
- AI agents — 에이전트에서 Youka CLI와 스킬 사용하기
- Authentication — API 키 생성 및 사용
- Understanding credits
