프로젝트 소개

Suno AI API는 Suno.ai 음악 생성 서비스를 위한 API 래퍼를 제공하는 비공식 오픈소스 프로젝트(LGPL-3.0 라이선스)입니다. 이를 통해 사용자는 GPTs, Coze, LangChain과 같은 AI 에이전트에 음악 생성 기능을 통합할 수 있습니다. 주요 기능: - Suno.ai의 전체 생성 API 구현: 프롬프트 기반 생성, 사용자 정의 모드(가사, 스타일, 제목 제어), 가사 생성, 오디오 확장, 스템 트랙 생성, 노래 연결 기능 포함. - 유료 2Captcha(또는 ruCaptcha) 서비스와 rebrowser-patches가 적용된 Playwright를 사용하여 hCaptcha 챌린지를 자동으로 해결합니다. - 백그라운드에서 Suno 계정을 활성 상태로 유지합니다. - OpenAI 호환 `/v1/chat/completions` API 형식을 제공합니다. - Vercel에 원클릭 배포, Node.js를 통한 로컬 실행, 또는 Docker(Docker에서는 GPU 가속 비활성화)를 지원합니다. 구성: 서비스를 실행하려면 사용자는 Suno 쿠키(`SUNO_COOKIE`), 2Captcha API 키(`TWOCAPTCHA_KEY`), 그리고 브라우저 설정(예: `BROWSER=chromium`, `BROWSER_LOCALE=en`, `BROWSER_HEADLESS=true`)을 제공해야 합니다. macOS 시스템은 CAPTCHA 발생 횟수를 최소화하기 위해 권장됩니다. API 기능: 이 프로젝트는 여러 REST 엔드포인트를 노출합니다: `/api/generate`, `/api/custom_generate`, `/api/get`(ID로 음악 정보 검색), `/api/get_limit`(할당량 확인), `/api/extend_audio`, `/api/generate_stems`, `/api/clip`, `/api/concat`. 또한 요청 헤더를 통해 쿠키를 재정의하여 여러 계정을 동시에 사용할 수 있습니다. README에는 사용법을 보여주는 Python 및 JavaScript 코드 예제가 제공됩니다.